Início / Desenvolvedores / Orders API
Orders API
Adicione o smm.guide ao seu painel como provedor. Cada rota que você cria na sua conta é um serviço com ID próprio: seu painel envia um pedido para esse ID, e a rota o repassa ao primeiro dos seus provedores que puder recebê-lo.
Três passos
O formato é o mesmo que os painéis SMM já usam entre si, então não há nada para programar.
https://smm.guide/api/v2 e a chave. Importe os serviços: suas rotas chegam com IDs, preços e limites.Formato da requisição
| Método HTTP | POST |
| URL da API | https://smm.guide/api/v2 |
| Corpo | application/x-www-form-urlencoded, ou JSON com Content-Type: application/json. A multipart/form-data no corpo também é lido, e é o que o PHP envia quando o cURL recebe um array |
| Resposta | JSON, sempre com HTTP 200, inclusive para um corpo que não conseguimos ler ou uma requisição grande demais. Um erro é {"error": "…"} |
| Dinheiro | Dólares americanos. Os preços são por 1.000 |
Lista de serviços
Suas rotas que podem receber um pedido agora. Uma rota desativada, ou com todas as etapas fora, não aparece na lista.
| Parâmetro | Descrição |
|---|---|
key | Sua chave de API |
action | services |
Resposta
[
{
"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 é o preço da etapa mais cara da rota que pode receber um pedido, incluindo as que estão puladas no momento (um painel fora do ar hoje volta amanhã), para que um pedido nunca custe mais que o preço que seu painel importou. min e max são os mais amplos que as etapas em funcionamento cobrem juntas; uma quantidade que cabe só em algumas delas vai para uma dessas. refill e cancel são true quando todas essas etapas os oferecem.
Uma rota desativada, ou sem nenhuma etapa que possa funcionar, fica fora desta lista até voltar. Um painel que sincroniza os serviços automaticamente desativará esse serviço do lado dele pelo mesmo período, que é o que você quer: os pedidos dele seriam recusados.
Adicionar pedido
| Parâmetro | Descrição |
|---|---|
key | Sua chave de API |
action | add |
service | O ID da rota, oito dígitos |
link | Link para a página, o post ou o perfil |
quantity | Quantidade desejada |
Resposta
{
"order": 23501
}
Ninguém aceitou
{
"error": "No step of this route accepted the order. …"
}O número do pedido continua o mesmo durante toda a vida do pedido, seja qual for o provedor que acabar entregando. Uma rota aceita um link e uma quantidade; envio gradual, comentários e outros campos extras são recusados.
Status do pedido
| Parâmetro | Descrição |
|---|---|
key | Sua chave de API |
action | status |
order | ID do pedido |
Resposta
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| Parâmetro | Descrição |
|---|---|
key | Sua chave de API |
action | status |
orders | IDs de pedidos separados por vírgula, até 100 |
Resposta
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| Status | Significado |
|---|---|
Pending | Aceito por um provedor e ainda não iniciado. Também um pedido sobre o qual um provedor não deu resposta clara: a rota para ali até você conferir na sua conta. |
In progress, Processing | Um provedor está entregando, ou o pedido está a caminho da próxima etapa. |
Completed | Entregue por completo. |
Partial | Entregue em parte; remains é o que não foi entregue. Conta o que todas as etapas entregaram: quando uma etapa entregou uma parte e o restante foi cancelado na seguinte, o pedido fica Partial, não Canceled. O provedor decide sobre a devolução do restante da cobrança. |
Canceled | Nada foi entregue, e nenhuma outra etapa aceitou o pedido. charge mostra o que ficou cobrado, se houver algo. |
charge é o que os provedores cobraram por este pedido, em dólares, pelo câmbio do dia em que ele foi feito. start_count vem do provedor que o iniciou.
Saldo
O smm.guide não guarda dinheiro seu. O valor é a soma dos seus saldos nos painéis por trás das suas rotas, em dólares.
| Parâmetro | Descrição |
|---|---|
key | Sua chave de API |
action | balance |
Resposta
{
"balance": "126.1375",
"currency": "USD"
}Cancelar
Repassado ao provedor que está com o pedido agora, se o serviço dele oferecer cancelamento. Um pedido que você cancela nunca é enviado para a próxima etapa.
| Parâmetro | Descrição |
|---|---|
key | Sua chave de API |
action | cancel |
orders | IDs de pedidos separados por vírgula, até 100 |
Resposta
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]Reposição
Repassada ao provedor que entregou o pedido. A reposição leva o número do próprio pedido.
| Parâmetro | Descrição |
|---|---|
key | Sua chave de API |
action | refill |
order | ID do pedido. Ou orders: vários, separados por vírgula |
Resposta, um pedido
{ "refill": "23501" }
Resposta, vários
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| Parâmetro | Descrição |
|---|---|
key | Sua chave de API |
action | refill_status |
refill | ID da reposição. Ou refills: vários, separados por vírgula |
Resposta
{ "status": "Completed" }O que uma rota faz com um pedido
- As etapas são tentadas na sua ordem ou começando pela mais barata em funcionamento. Você escolhe qual na rota.
- Uma etapa é pulada quando o painel dela não responde, o saldo ou o limite diário dela não cobre o pedido, a quantidade está fora do que ela aceita, o preço dela está acima do limite que você definiu ou, com esse preço, o pedido ultrapassaria o limite diário da própria rota. Ela volta sozinha.
- Uma etapa sai quando o serviço dela sai da lista de preços ou o painel começa a vender outra coisa com o mesmo ID. As outras etapas continuam funcionando, e você é avisado.
- Uma recusa passa o pedido adiante. Quando um painel responde e recusa, nada foi cobrado, então a próxima etapa é tentada.
- Sem resposta clara, a rota para. Um tempo esgotado ou uma resposta corrompida não dizem se o pedido existe. Repassá-lo poderia entregar e cobrar duas vezes, então a rota para e você confere esse pedido na sua conta.
- Um pedido ativo por link. Enquanto um pedido para um link está em andamento em uma rota, um segundo pedido para o mesmo link é recusado, como os próprios provedores fazem.
- Um cancelamento antes da entrega também pode seguir adiante, se você ativou essa opção. O que um pedido parcial deixou sem entregar só segue adiante se você pediu isso.
Erros
| Erro | O que significa |
|---|---|
Invalid API key | A chave está errada, foi substituída ou revogada. |
This key is limited to certain addresses… | A requisição veio de um endereço que não está na lista da chave. |
Incorrect request | Desconhecido action. |
Incorrect service ID | Nenhuma rota sua tem este ID. Uma rota que você excluiu mantém o número, e ele nunca é dado a outra. |
Incorrect order ID | Nenhum pedido seu tem este número. |
Link is required, Quantity is required | Um campo de add está faltando ou não é um número. |
A route takes a link and a quantity only | A requisição trazia envio gradual, comentários ou outro campo extra. |
This route is switched off | Ative-a na sua conta. |
This route already has an order for this link… | Espere o pedido em andamento terminar. |
No step of this route can take this order right now. … | Todas as etapas foram puladas antes de qualquer envio. O texto cita cada painel e o motivo. |
No step of this route accepted the order. … | Todas as etapas consultadas recusaram. Nada foi cobrado. |
Too many requests… | Acima do limite indicado abaixo. Aguarde um minuto. |
Exemplos
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]);
Uma chamada add é respondida em até 30 segundos, sempre. Uma rota pode consultar vários provedores, um depois do outro; cada um recebe o que resta desse tempo, e um provedor que não pode ser aguardado nem chega a ser consultado. Se o último consultado não tiver respondido quando o tempo acabar, você recebe um número de pedido com o status Pending, e a rota para ali até a resposta ser conhecida. A maioria dos pedidos é respondida em um ou dois segundos.
Limites e segurança
- 300 requisições por minuto por chave, 120 delas de pedidos. Até 100 IDs de pedidos em uma
statuschamada. - A chave é exibida uma única vez e guardada como impressão digital. Nem você nem nós podemos lê-la de novo. Ao substituí-la, a antiga é desativada na hora.
- Endereços permitidos. Informe o endereço do servidor do seu painel na sua conta, e a chave não funcionará de nenhum outro lugar.
- O ID de uma rota não é segredo, nem precisa ser. Ele só funciona junto com a chave da conta dona da rota.
- Seus limites continuam valendo. O limite diário de cada painel, o limite diário da própria rota e o maior pedido dela valem para os pedidos que chegam pela API exatamente como para os que você faz à mão.
- O dinheiro nunca passa pelo smm.guide. Cada pedido é pago com o seu saldo no painel que o recebe. Reembolsos e disputas ficam entre você e esse painel.
Quer ler o catálogo?
Painéis, Trust Scores e preços ao vivo têm uma API própria e um servidor MCP para assistentes.