Inicio / Desarrolladores / Orders API

Orders API

Añade smm.guide a tu panel como proveedor. Cada ruta que creas en tu cuenta es un servicio con su propio ID: tu panel envía un pedido a ese ID y la ruta lo pasa al primero de tus proveedores que pueda aceptarlo.

Tres pasos

El formato es el que los paneles SMM ya usan entre sí, así que no hay nada que programar.

1Crea una rutaCuenta, Orders desk, Rutas. Elige qué entrega y añade hasta cinco servicios de ese tipo de los paneles que hayas conectado.
2Crea la claveOrders desk, Orders API. La clave se muestra una sola vez. Puedes limitarla a la dirección del servidor de tu panel.
3Añade un proveedor en tu panelURL de la API https://smm.guide/api/v2 y la clave. Importa los servicios: tus rutas llegan con sus ID, precios y límites.

Formato de la solicitud

Método HTTPPOST
URL de la APIhttps://smm.guide/api/v2
Cuerpoapplication/x-www-form-urlencoded, o JSON con Content-Type: application/json. A multipart/form-data también se acepta como cuerpo; es lo que envía PHP cuando cURL recibe un array
RespuestaJSON, siempre con HTTP 200, también ante un cuerpo que no podemos leer o una solicitud demasiado grande. Un error es {"error": "…"}
DineroDólares estadounidenses. Los precios son por 1.000

Lista de servicios

Tus rutas que pueden aceptar un pedido ahora mismo. Una ruta desactivada, o con todos sus pasos fuera, no aparece.

ParámetroDescripción
keyTu clave de API
actionservices

Respuesta

[
  {
    "service": 85725095,
    "name": "TG views, main",
    "type": "Default",
    "category": "Telegram views",
    "rate": "0.0018",
    "min": "10",
    "max": "1000000",
    "refill": false,
    "cancel": true,
    "dripfeed": false
  }
]

rate es el más caro de los pasos de la ruta que pueden aceptar un pedido, incluidos los omitidos por el momento (un panel caído hoy vuelve mañana), así que un pedido nunca cuesta más que el precio que importó tu panel. min y max son los más amplios que admiten en conjunto los pasos operativos; una cantidad que solo encaja en algunos va a uno de ellos. refill y cancel son true cuando todos esos pasos los ofrecen.

Una ruta desactivada, o sin ningún paso que pueda funcionar, queda fuera de esta lista hasta que vuelva. Un panel que sincroniza sus servicios automáticamente desactivará ese servicio por su parte durante el mismo tiempo, que es lo que quieres: sus pedidos serían rechazados.

Añadir pedido

ParámetroDescripción
keyTu clave de API
actionadd
serviceEl ID de la ruta, ocho dígitos
linkEnlace a la página, publicación o perfil
quantityCantidad necesaria

Respuesta

{
  "order": 23501
}

Ningún proveedor lo aceptó

{
  "error": "No step of this route accepted the order. …"
}

El número de pedido es el mismo durante toda la vida del pedido, sea cual sea el proveedor que acabe entregándolo. Una ruta acepta un enlace y una cantidad; se rechazan la entrega gradual, los comentarios y otros campos adicionales.

Estado del pedido

ParámetroDescripción
keyTu clave de API
actionstatus
orderID del pedido

Respuesta

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParámetroDescripción
keyTu clave de API
actionstatus
ordersID de pedidos separados por comas, hasta 100

Respuesta

{
  "23501": {
    "charge": "0.0045",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "99": { "error": "Incorrect order ID" }
}
EstadoSignificado
PendingAceptado por un proveedor y aún sin empezar. También un pedido sobre el que un proveedor no dio una respuesta clara: la ruta se detiene ahí hasta que lo hayas comprobado en tu cuenta.
In progress, ProcessingUn proveedor lo está entregando, o el pedido va camino del siguiente paso.
CompletedEntregado por completo.
PartialEntregado en parte; remains es lo que no se entregó. Cuenta lo que entregó cada paso: cuando un paso entregó una parte y el resto se canceló en el siguiente, el pedido queda como Parcial, no como Cancelado. El proveedor decide si devuelve el resto del cargo.
CanceledNo se entregó nada y ningún otro paso aceptó el pedido. charge muestra lo que quedó cobrado, si es que quedó algo.

charge es lo que los proveedores cobraron por este pedido, en dólares al tipo de cambio del día en que se hizo. start_count viene del proveedor que lo inició.

Saldo

smm.guide no guarda dinero tuyo. La cifra es la suma de tus saldos en los paneles detrás de tus rutas, en dólares.

ParámetroDescripción
keyTu clave de API
actionbalance

Respuesta

{
  "balance": "126.1375",
  "currency": "USD"
}

Cancelar

Se transmite al proveedor que tiene el pedido en ese momento, si su servicio permite cancelar. Un pedido que cancelas nunca se envía al siguiente paso.

ParámetroDescripción
keyTu clave de API
actioncancel
ordersID de pedidos separados por comas, hasta 100

Respuesta

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "The order is already finished" } }
]

Reposición

Se transmite al proveedor que entregó el pedido. La reposición lleva el número del propio pedido.

ParámetroDescripción
keyTu clave de API
actionrefill
orderID del pedido. O orders: varios, separados por comas

Respuesta, un pedido

{ "refill": "23501" }

Respuesta, varios

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
ParámetroDescripción
keyTu clave de API
actionrefill_status
refillID de reposición. O refills: varios, separados por comas

Respuesta

{ "status": "Completed" }

Qué hace una ruta con un pedido

  • Los pasos se prueban en tu orden, o primero el más barato que funcione. Lo eliges en la ruta.
  • Un paso se omite cuando su panel no responde, su saldo o su límite diario no cubre el pedido, la cantidad está fuera de lo que acepta, su precio supera el límite que fijaste o, a su precio, el pedido superaría el límite diario de la propia ruta. Vuelve solo.
  • Un paso queda fuera cuando su servicio desaparece de la lista de precios o el panel empieza a vender otra cosa con el mismo ID. Los demás pasos siguen funcionando y te avisamos.
  • Un rechazo pasa el pedido al siguiente paso. Cuando un panel responde y rechaza, no se ha cobrado nada, así que se prueba el siguiente paso.
  • Una respuesta poco clara lo detiene. Un tiempo de espera agotado o una respuesta defectuosa no indican si el pedido existe. Reenviarlo podría entregarlo y cobrarlo dos veces, así que la ruta se detiene y compruebas ese pedido en tu cuenta.
  • Un pedido en curso por enlace. Mientras haya un pedido en curso para un enlace en una ruta, se rechaza un segundo para el mismo enlace, como hacen los propios proveedores.
  • Una cancelación antes de la entrega también puede pasar al siguiente paso, si lo activaste. Lo que un pedido parcial dejó sin entregar solo pasa al siguiente si lo pediste.

Errores

ErrorQué significa
Invalid API keyLa clave es incorrecta, se sustituyó o se revocó.
This key is limited to certain addresses…La solicitud llegó desde una dirección que no está en la lista de la clave.
Incorrect requestDesconocido action.
Incorrect service IDNinguna de tus rutas tiene este ID. Una ruta que eliminaste conserva su número, y nunca se asigna a otra.
Incorrect order IDNinguno de tus pedidos tiene este número.
Link is required, Quantity is requiredUn campo de add falta o no es un número.
A route takes a link and a quantity onlyLa solicitud incluía entrega gradual, comentarios u otro campo adicional.
This route is switched offActívalo en tu cuenta.
This route already has an order for this link…Espera a que termine el que está en curso.
No step of this route can take this order right now. …Se omitieron todos los pasos antes de enviar nada. El texto indica cada panel y su motivo.
No step of this route accepted the order. …Todos los pasos consultados lo rechazaron. No se cobró nada.
Too many requests…Por encima del límite de abajo. Espera un minuto.

Ejemplos

cURL

curl https://smm.guide/api/v2 \
  -d key=sgo_… \
  -d action=add \
  -d service=85725095 \
  -d link=https://t.me/channel/123 \
  -d quantity=1000

PHP

function smmguide(array $post) {
  $ch = curl_init('https://smm.guide/api/v2');
  curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query(
      ['key' => 'sgo_…'] + $post),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
  ]);
  $out = json_decode(curl_exec($ch), true);
  curl_close($ch);
  return $out;
}
$order = smmguide(['action' => 'add',
  'service' => 85725095,
  'link' => 'https://t.me/channel/123',
  'quantity' => 1000]);

Una solicitud add se responde siempre en menos de 30 segundos. Una ruta puede consultar a varios proveedores uno tras otro; cada uno dispone de lo que queda de ese tiempo, y a un proveedor al que no daría tiempo a esperar no se le consulta. Si el último consultado no ha respondido cuando se agota el tiempo, recibes un número de pedido con el estado Pending, y la ruta se detiene ahí hasta conocer la respuesta. La mayoría de los pedidos se responden en uno o dos segundos.

Límites y seguridad

  • 300 solicitudes por minuto por clave, 120 de ellas de pedidos. Hasta 100 ID de pedido en una status llamada.
  • La clave se muestra una sola vez y se guarda como huella. Ni tú ni nosotros podemos volver a leerla. Al sustituirla, la anterior se desactiva al instante.
  • Direcciones permitidas. Indica en tu cuenta la dirección del servidor de tu panel y la clave no funcionará desde ningún otro sitio.
  • El ID de una ruta no es secreto ni necesita serlo. Solo funciona junto con la clave de la cuenta propietaria de la ruta.
  • Tus límites siguen vigentes. El límite diario de cada panel, el límite diario de la propia ruta y su pedido máximo se aplican a los pedidos que llegan por la API exactamente igual que a los que haces a mano.
  • El dinero nunca pasa por smm.guide. Cada pedido se paga con tu saldo en el panel que lo acepta. Los reembolsos y las disputas quedan entre tú y ese panel.

¿Quieres leer el catálogo?

Los paneles, los Trust Score y los precios en vivo tienen su propia API, y un servidor MCP para asistentes.