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.

1Crie uma rotaConta, Orders desk, Rotas. Escolha o que ela entrega e adicione até cinco serviços desse tipo dos painéis que você conectou.
2Crie a chaveOrders desk, Orders API. A chave é exibida uma única vez. Você pode restringi-la ao endereço do servidor do seu painel.
3Adicione um provedor no seu painelURL da API 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 HTTPPOST
URL da APIhttps://smm.guide/api/v2
Corpoapplication/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
RespostaJSON, sempre com HTTP 200, inclusive para um corpo que não conseguimos ler ou uma requisição grande demais. Um erro é {"error": "…"}
DinheiroDó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âmetroDescrição
keySua chave de API
actionservices

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âmetroDescrição
keySua chave de API
actionadd
serviceO ID da rota, oito dígitos
linkLink para a página, o post ou o perfil
quantityQuantidade 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âmetroDescrição
keySua chave de API
actionstatus
orderID do pedido

Resposta

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
ParâmetroDescrição
keySua chave de API
actionstatus
ordersIDs 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" }
}
StatusSignificado
PendingAceito 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, ProcessingUm provedor está entregando, ou o pedido está a caminho da próxima etapa.
CompletedEntregue por completo.
PartialEntregue 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.
CanceledNada 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âmetroDescrição
keySua chave de API
actionbalance

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âmetroDescrição
keySua chave de API
actioncancel
ordersIDs 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âmetroDescrição
keySua chave de API
actionrefill
orderID 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âmetroDescrição
keySua chave de API
actionrefill_status
refillID 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

ErroO que significa
Invalid API keyA 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 requestDesconhecido action.
Incorrect service IDNenhuma rota sua tem este ID. Uma rota que você excluiu mantém o número, e ele nunca é dado a outra.
Incorrect order IDNenhum pedido seu tem este número.
Link is required, Quantity is requiredUm campo de add está faltando ou não é um número.
A route takes a link and a quantity onlyA requisição trazia envio gradual, comentários ou outro campo extra.
This route is switched offAtive-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 status chamada.
  • 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.