Documentação da API

API Reference

Integre nossos serviços de envio de diamantes, tokens e passes Free Fire em suas aplicações.

Autenticação

Todas as requisições da API requerem autenticação via userId e key:

{
  "userId": "SEU_DISCORD_ID",
  "key": "SUA_API_KEY"
}

Você pode gerar sua API key em Dashboard → API Keys

Rate Limiting

A API possui limites de requisições para garantir a estabilidade:

Endpoint	Limite	Janela
Produtos (diamonds, tokens, pass)	30 requisições	1 minuto
Informações (info, balance, stock)	60 requisições	1 minuto
Pagamentos (balance/add, balance/status)	5 requisições	1 minuto

Endpoints

POST/api/v1/diamonds/stock

Verificar Estoque de Diamantes

Retorna a quantidade disponível de cada pacote de diamantes

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`userId`	string	Sim	Seu Discord ID
`key`	string	Sim	Sua API key

Exemplo de Resposta

{
  "status": "OK",
  "data": {
    "stock": {
      "200": 15,
      "620": 10,
      "1040": 8,
      "2120": 5,
      "4360": 3,
      "5300": 2,
      "11200": 1,
      "22400": 0
    },
    "available": true,
    "updatedAt": "2024-07-30T20:30:00.000Z"
  }
}

POST/api/v1/diamonds/verify

Verificar Token do Jogador

Verifica se o jogador pode receber a quantidade de diamantes selecionada

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`userId`	string	Sim	Seu Discord ID
`key`	string	Sim	Sua API key
`accessToken`	string	Sim	Token de acesso do jogador
`diamondAmount`	string	Não	200, 620, 1040, 2120, 4360, 5300, 11200, 22400

Exemplo de Resposta

{
  "status": "OK",
  "data": {
    "canReceive": true,
    "player": {
      "id": "123456789",
      "name": "NOME_DO_JOGADOR",
      "level": 50,
      "region": "BR"
    },
    "message": "Jogador pode receber diamantes"
  }
}

POST/api/v1/diamonds/send

Enviar Diamantes

Envia diamantes para um jogador Free Fire

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`userId`	string	Sim	Seu Discord ID
`key`	string	Sim	Sua API key
`accessToken`	string	Sim	Token de acesso do jogador
`diamondAmount`	string	Sim	200, 620, 1040, 2120, 4360, 5300, 11200, 22400

Exemplo de Resposta

{
  "status": "OK",
  "transacao": {
    "id": "diamond_1722369884848_4v4f5j5j",
    "tipo": "Diamantes",
    "quantidade": 620,
    "custo": 25.5,
    "moeda": "BRL",
    "simbolo": "R$",
    "saldo_anterior": 100,
    "saldo_novo": 74.5,
    "data": "2024-07-30T20:04:44.848Z"
  },
  "mensagem": "620 diamantes enviados com sucesso!"
}

POST/api/v1/tokens/send

Enviar Tokens

Envia caixas universais (tokens) para um jogador

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`userId`	string	Sim	Seu Discord ID
`key`	string	Sim	Sua API key
`playerID`	string	Sim	UID do jogador Free Fire
`quantity`	number	Não	Quantidade (1-200, padrão: 1)
`mensagem`	string	Não	Mensagem do presente

Exemplo de Resposta

{
  "status": "OK",
  "transacao": {
    "id": "token_1722370010183_f9v5k5k5",
    "tipo": "Caixa Universal (Token)",
    "jogador": { "id": "1234567890" },
    "quantidade": 1,
    "custo_total": 2.5,
    "saldo_anterior": 74.5,
    "saldo_novo": 72.0,
    "data": "2024-07-30T20:06:50.183Z"
  },
  "mensagem": "Tokens enviados com sucesso!"
}

POST/api/v1/pass/send

Enviar Passe Booyah

Ativa o Passe Booyah para um jogador

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`userId`	string	Sim	Seu Discord ID
`key`	string	Sim	Sua API key
`uid`	string	Sim	UID do jogador Free Fire

Exemplo de Resposta

{
  "status": "OK",
  "transacao": {
    "id": "pass_1722370133948_s5f5g5g5",
    "tipo": "Booyah Pass",
    "jogador": {
      "uid": "1234567890",
      "nickname": "NOME_DO_JOGADOR"
    },
    "custo": 4.0,
    "saldo_anterior": 72.0,
    "saldo_novo": 68.0,
    "data": "2024-07-30T20:08:53.948Z"
  },
  "mensagem": "Passe Booyah enviado com sucesso!"
}

POST/api/v1/balance/add

Adicionar Saldo (PIX)

Cria uma cobrança PIX para adicionar saldo à conta (apenas BR)

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`userId`	string	Sim	Seu Discord ID
`key`	string	Sim	Sua API key
`amount`	number	Sim	Valor em reais (5-10000)
`cpf`	string	Sim	CPF do pagador (11-14 caracteres)
`name`	string	Sim	Nome completo do pagador

Exemplo de Resposta

{
  "status": "OK",
  "data": {
    "txid": "txid_gerado_pela_efibank",
    "valor": "50.00",
    "qrcodeImage": "data:image/png;base64,...",
    "qrcodeText": "00020126...",
    "expiresIn": 3600,
    "message": "Cobrança PIX criada com sucesso."
  }
}

POST/api/v1/balance/status

Verificar Status do Pagamento

Verifica o status de uma cobrança PIX criada anteriormente

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`userId`	string	Sim	Seu Discord ID
`key`	string	Sim	Sua API key
`txid`	string	Sim	ID da transação PIX

Exemplo de Resposta

// Pagamento confirmado:
{
  "status": "OK",
  "data": {
    "paymentStatus": "PAID",
    "txid": "txid_da_cobranca",
    "amount": 50.00,
    "paidAt": "2024-07-30T20:15:00.000Z",
    "currentBalance": 124.50,
    "message": "Pagamento confirmado e saldo adicionado"
  }
}

// Aguardando pagamento:
{
  "status": "OK",
  "data": {
    "paymentStatus": "PENDING",
    "txid": "txid_da_cobranca",
    "amount": 50.00,
    "remainingSeconds": 3000,
    "currentBalance": 74.50,
    "message": "Aguardando pagamento"
  }
}

// Não encontrado/expirado:
{
  "status": "OK",
  "data": {
    "paymentStatus": "NOT_FOUND",
    "txid": "txid_inexistente",
    "currentBalance": 74.50,
    "message": "Cobrança não encontrada ou expirada"
  }
}

POST/api/v1/reseller/info

Informações do Revendedor

Retorna informações completas, saldo, estoque e histórico

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`userId`	string	Sim	Seu Discord ID
`key`	string	Sim	Sua API key

Exemplo de Resposta

{
  "status": "OK",
  "data": {
    "id": "123456789",
    "apelido": "MeuNome",
    "saldo": 124.50,
    "gasto": 500.00,
    "region": "br",
    "historico": [...]
  }
}

POST/api/v1/reseller/balance

Consultar Saldo

Retorna apenas o saldo do revendedor (endpoint mais leve)

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`userId`	string	Sim	Seu Discord ID
`key`	string	Sim	Sua API key

Exemplo de Resposta

{
  "status": "OK",
  "data": {
    "saldo": 124.50,
    "moeda": "BRL",
    "simbolo": "R$"
  }
}

POST/api/v1/accounts/buy

Comprar Contas Lvl 21

Compra contas Lvl 21 com troca de nick disponível

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`userId`	string	Sim	Seu Discord ID
`key`	string	Sim	Sua API key
`quantity`	number	Sim	Quantidade de contas (1-100)

Exemplo de Resposta

{
  "status": "OK",
  "transacao": {
    "id": "account_1722370220454_k5h5j5j5",
    "tipo": "Conta Lvl 21",
    "quantidade": 2,
    "custo_total": 1.0,
    "saldo_anterior": 68.0,
    "saldo_novo": 67.0,
    "data": "2024-07-30T20:10:20.454Z"
  },
  "contas": [
    { "uid": "uid_exemplo_1", "password": "senha_1" },
    { "uid": "uid_exemplo_2", "password": "senha_2" }
  ],
  "mensagem": "2 conta(s) Lvl 21 entregue(s)!"
}

POST/api/v1/likes/buy

Comprar Key de Likes

Compra uma key para enviar likes no Free Fire

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`userId`	string	Sim	Seu Discord ID
`key`	string	Sim	Sua API key
`idsQuantity`	number	Sim	Quantidade de IDs (múltiplo de 100, mín: 100)
`days`	number	Não	Duração em dias (padrão: 30)
`name`	string	Não	Nome personalizado da key

Exemplo de Resposta

{
  "status": "OK",
  "transacao": {
    "id": "likes_1722370335898_d5f5g5g5",
    "tipo": "Key de Likes",
    "ids_quantidade": 100,
    "dias": 30,
    "custo_total": 20.0,
    "saldo_anterior": 67.0,
    "saldo_novo": 47.0,
    "data": "2024-07-30T20:12:15.898Z"
  },
  "key": {
    "keyString": "LIKES-ABC-123-XYZ",
    "dailyLimit": 100,
    "expiresAt": "2024-08-29T20:12:15.898Z"
  },
  "mensagem": "Key de 100 IDs criada com sucesso!"
}

Códigos de Erro

Código	Erro	Descrição
400	`VALIDATION_ERROR`	Dados inválidos na requisição
400	`INSUFFICIENT_BALANCE`	Saldo insuficiente
400	`REGION_NOT_SUPPORTED`	Região não suportada para esta operação
401	`UNAUTHORIZED`	Não autenticado
401	`INVALID_API_KEY`	API key inválida
404	`RESELLER_NOT_FOUND`	Revendedor não encontrado
429	`RATE_LIMIT_EXCEEDED`	Limite de requisições excedido
500	`INTERNAL_ERROR`	Erro interno do servidor

Preços (Brasil)

200 DiamantesR$ 7,00

620 DiamantesR$ 18,00

1.040 DiamantesR$ 28,00

2.120 DiamantesR$ 55,00

4.360 DiamantesR$ 105,00

5.300 DiamantesR$ 125,00

11.200 DiamantesR$ 260,00

22.400 DiamantesR$ 500,00

Token (Caixa Universal)R$ 2,50

Passe BooyahR$ 4,00

Conta Lvl 21 (troca nick)R$ 0,50

Key de Likes (100 IDs)R$ 20,00

Exemplo de Uso

JavaScript / Node.js

const response = await fetch('https://seu-dominio.com/api/v1/diamonds/send', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    userId: 'SEU_DISCORD_ID',
    key: 'SUA_API_KEY',
    accessToken: 'TOKEN_DO_JOGADOR',
    diamondAmount: '620'
  })
});

const data = await response.json();
console.log(data);

Pronto para começar?

Gere sua API key e comece a integrar agora mesmo

Gerar API Key