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.
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 HTTP | POST |
| URL de la API | https://smm.guide/api/v2 |
| Cuerpo | application/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 |
| Respuesta | JSON, siempre con HTTP 200, también ante un cuerpo que no podemos leer o una solicitud demasiado grande. Un error es {"error": "…"} |
| Dinero | Dó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ámetro | Descripción |
|---|---|
key | Tu clave de API |
action | services |
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ámetro | Descripción |
|---|---|
key | Tu clave de API |
action | add |
service | El ID de la ruta, ocho dígitos |
link | Enlace a la página, publicación o perfil |
quantity | Cantidad 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ámetro | Descripción |
|---|---|
key | Tu clave de API |
action | status |
order | ID del pedido |
Respuesta
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parámetro | Descripción |
|---|---|
key | Tu clave de API |
action | status |
orders | ID 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" }
}| Estado | Significado |
|---|---|
Pending | Aceptado 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, Processing | Un proveedor lo está entregando, o el pedido va camino del siguiente paso. |
Completed | Entregado por completo. |
Partial | Entregado 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. |
Canceled | No 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ámetro | Descripción |
|---|---|
key | Tu clave de API |
action | balance |
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ámetro | Descripción |
|---|---|
key | Tu clave de API |
action | cancel |
orders | ID 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ámetro | Descripción |
|---|---|
key | Tu clave de API |
action | refill |
order | ID del pedido. O orders: varios, separados por comas |
Respuesta, un pedido
{ "refill": "23501" }
Respuesta, varios
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parámetro | Descripción |
|---|---|
key | Tu clave de API |
action | refill_status |
refill | ID 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
| Error | Qué significa |
|---|---|
Invalid API key | La 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 request | Desconocido action. |
Incorrect service ID | Ninguna de tus rutas tiene este ID. Una ruta que eliminaste conserva su número, y nunca se asigna a otra. |
Incorrect order ID | Ninguno de tus pedidos tiene este número. |
Link is required, Quantity is required | Un campo de add falta o no es un número. |
A route takes a link and a quantity only | La solicitud incluía entrega gradual, comentarios u otro campo adicional. |
This route is switched off | Actí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
statusllamada. - 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.