API para quem opera em escala

A API da Matriz SMM permite que seu painel envie pedidos, consulte status e verifique saldo automaticamente, sem ninguém repassando pedido na mão. É o mesmo padrão de requisição usado pelos principais scripts de painel do mercado — se o seu painel já fala com outro fornecedor, ele fala com a gente.

Autenticação por chave

Uma API key por conta, revogável a qualquer momento.

Padrão de mercado

Compatível com os principais scripts de painel SMM.

JSON ou form urlencoded

Aceitamos os dois formatos de corpo na mesma URL.

Requisição — JSON
POST https://matrizsmm.com/api/public/v2
Content-Type: application/json

{
  "key": "msmm_sua_chave_aqui",
  "action": "add",
  "service": "1",
  "link": "https://instagram.com/seu_cliente",
  "quantity": 1000
}
Requisição — form urlencoded
POST https://matrizsmm.com/api/public/v2
Content-Type: application/x-www-form-urlencoded

key=msmm_sua_chave_aqui&action=add&service=1&link=https://instagram.com/seu_cliente&quantity=1000

Os dois formatos funcionam no mesmo endpoint. Use application/x-www-form-urlencoded se o seu painel já vem configurado assim de fábrica.

Resposta — add (200 OK)
{
  "order": "9b1d7c40-...-uuid-do-pedido",
  "charge": "12.00"
}
Requisição — services
key=msmm_sua_chave_aqui&action=services
Resposta — services
[
  {
    "service": "1",
    "name": "Instagram Seguidores Brasileiros",
    "type": "Default",
    "category": "Instagram",
    "rate": "12.00",
    "min": "100",
    "max": "100000",
    "refill": true,
    "cancel": false
  }
]
Requisição — balance
key=msmm_sua_chave_aqui&action=balance
Resposta — balance
{
  "balance": "123.45",
  "currency": "BRL"
}
Requisição — chave inválida
key=chave_errada&action=balance
Resposta — erro
{
  "error": "Invalid api key"
}

// Principais erros retornados:
// Chave de API inválida ou inativa
// Saldo insuficiente para este pedido
// Serviço indisponível
// Quantidade fora do intervalo permitido (min a max)
// Link inválido

Parâmetros

keySua chave de API, gerada em Painel → Conta → Chaves da API v2.
actionAção executada: add, status, services, balance, refill ou cancel.
serviceID do serviço retornado pela ação services. Tratado como texto: aceita número (1, 2, 3), UUID ou qualquer identificador — não há validação de formato.
linkURL do perfil, post ou vídeo que receberá o pedido.
quantityQuantidade solicitada, dentro do mínimo e máximo do serviço.
orderEm status e refill: um único ID de pedido.
ordersEm status e cancel: um ID ou vários separados por vírgula (até 100).
Ver documentação completaVer tabela de preços