Free Fire Passes & Presentes
API de alta velocidade para envio automatizado de Passe Booyah, Look Ninja e gerenciamento de contas no Free Fire.
Autenticação via Key
Todas as operações de envio e checagem de saldo exigem uma key ativa. Você pode enviar a chave no corpo da requisição JSON ({"key": "SUA_KEY"}) ou via parâmetro na URL (?key=SUA_KEY).
Exemplo de requisição com cURL:
-H "Content-Type: application/json" \
-d '{"uid": "123456789", "key": "SUA_KEY"}'
Tipos de Acesso
| Tipo | Endpoints Permitidos | Descrição |
|---|---|---|
| Key | /api/enviar/passe, /api/enviar/ninja, /api/enviar/presente, /api/contas/verificar, /api/balance/passes, /api/adicionar_conta, /api/remover_conta |
Chave exclusiva para realizar envio de passes, ninjas e presentes com dedução no saldo de diamantes. |
| Público / Info | /api/loja/itens, /api/player-info, /api/internal/freefire/nick, /api/verificar_guest, /api/status |
Consultas em tempo real do perfil do jogador (nickname, nível, likes, região) e status da API. |
Endpoints da API
Custo: Verificado dinamicamente na loja oficial Garena (Commodity 2040: 250 Diamantes)
Entrega: Instantânea no Cofre Free Fire
| Parâmetro | Tipo | Descrição |
|---|---|---|
| uid obrigatório | string | UID da conta Free Fire destinatária |
| key obrigatório | string | Sua Key ativa |
{
"status": "success",
"message": "Passe enviado com sucesso!",
"uid": "123456789",
"nickname": "ProPlayer⚡",
"order_id": "ORD-20261106-9812",
"item_name": "Passe Booyah (OB55)",
"item_id": 2040,
"diamonds_spent": 250,
"remaining_passes": 24,
"timestamp": "2026-11-06T20:30:00Z"
}Permite verificar a quantidade total de passes prontos para envio.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| key obrigatório | string | Sua Key (via Query String ou JSON) |
{
"status": "success",
"key": "sua_key",
"total_contas": 25,
"contas_com_saldo": 24,
"total_diamantes": 6000,
"passes_disponiveis": 24
}| Parâmetro | Tipo | Descrição |
|---|---|---|
| key obrigatório | string | Sua Key |
{
"status": "success",
"key": "sua_key",
"passes_disponiveis": 24,
"diamantes_totais": 6000,
"contas_ativas": 25
}Custo: Verificado dinamicamente na loja oficial Garena (Commodities 2151/2152: 799 Diamantes)
| Parâmetro | Tipo | Descrição |
|---|---|---|
| uid obrigatório | string | UID da conta destinatária |
| key obrigatório | string | Sua Key |
| look_id opcional | integer | 2151 (Ninja Branco) ou 2152 (Ninja Preto). padrão: 2151 |
{
"status": "success",
"message": "Look Ninja enviado com sucesso!",
"uid": "123456789",
"item_name": "Look Ninja Branco",
"item_id": 2151,
"diamonds_spent": 799,
"remaining_ninjas": 4,
"order_id": "ORD-NINJA-9912"
}Retorna os valores oficiais em diamantes e commodity_id do Passe Booyah e dos Looks Ninja Branco/Preto extraídos em tempo real do catálogo da Garena.
{
"status": "success",
"precos": {
"passe": {
"commodity_id": 2040,
"nome": "Passe Booyah (OB55)",
"price": 250,
"currency": "diamond"
},
"ninja_branco": {
"commodity_id": 2151,
"nome": "Look Ninja Branco",
"price": 799,
"currency": "diamond"
},
"ninja_preto": {
"commodity_id": 2152,
"nome": "Look Ninja Preto",
"price": 799,
"currency": "diamond"
}
}
}Obtém em tempo real a lista de presentes da loja oficial Free Fire com seus preços em diamantes (gems_price), commodity_id, categorias e link para miniatura do item.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| category opcional | string | Filtra por categoria (ex: Emote, Bundle, Backpack, Shoes, Top, Bottom, Hair, Mask). padrão: Todos |
| q opcional | string | Termo de busca (pesquisa por item_id, commodity_id ou categoria) |
| limit opcional | integer | Limite de itens retornados. padrão: 200 |
| region opcional | string | Região da loja (BR, US, SAC). padrão: BR |
{
"status": "success",
"total": 191,
"total_catalogo": 191,
"categories": ["Todos", "Backpack", "Bottom", "Bundle", "Emote", "Hair", "Mask", "Shoes", "Top"],
"items": [
{
"commodity_id": 2387,
"item_id": 909046017,
"gems_price": 349,
"coins_price": 0,
"category": "Emote",
"image_url": "/api/image/909046017"
}
]
}Permite enviar qualquer item do catálogo da Garena usando o commodity_id correspondente e debitando o valor exato em diamantes ou em ouro (moedas) do pool da Key.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| uid obrigatório | string | UID da conta destinatária Free Fire |
| key obrigatório | string | Sua Key |
| commodity_id obrigatório | integer | ID da mercadoria na loja oficial Garena (obtido via /api/loja/itens) |
| currency opcional | string | Moeda de pagamento: "diamond" (padrão) ou "gold" (para itens com custo em ouro). padrão: diamond |
| price opcional | integer | Custo em diamantes do item |
| item_name opcional | string | Nome do item para registro na ordem padrão: Presente Free Fire |
| mensagem opcional | string | Mensagem da caixa de correio do jogo padrão: Presente NewFire! 🎁 |
{
"status": "success",
"message": "Presente enviado com sucesso!",
"uid": "8123124352",
"nickname": "BR_lizinᴹᴷᴮ",
"order_id": "ORD-GIFT-20261106-4412",
"item_name": "Emote #909046017",
"commodity_id": 2387,
"diamonds_spent": 349,
"remaining_diamonds": 5651
}| Parâmetro | Tipo | Descrição |
|---|---|---|
| key obrigatório | string | Sua Key |
{
"status": "success",
"total_contas": 25,
"ninjas_disponiveis": 4,
"total_diamantes": 6000
}Gera uma nova key e associa automaticamente contas com diamantes do estoque da plataforma.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| admin_key obrigatório | string | Chave mestra de administrador (padrão: ADMIN_TEST_KEY) |
| name obrigatório | string | Nome do revendedor ou cliente |
| key opcional | string | Código personalizado da chave (se omitido, gera nf_xxxx automaticamente) |
| contas opcional | integer | Quantidade de contas guest com diamantes a vincular padrão: 10 |
| dias opcional | integer | Dias de validade da chave padrão: 365 |
{
"status": "success",
"key": "revendedor_vip",
"name": "Revendedor João",
"tipo": "passe, ninja",
"status_key": "active",
"expires_at": "2027-11-06 21:00:00",
"contas_vinculadas": 10,
"diamantes_totais": 15000,
"passes_disponiveis": 60,
"ninjas_disponiveis": 12
}A conta é validada nos servidores da Garena e seu saldo de diamantes é registrado automaticamente.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| key obrigatório | string | Sua Key |
| uid obrigatório | string | UID da conta guest de envio |
| password obrigatório | string | Senha da conta guest (hash gerado pelo app) |
{
"status": "success",
"message": "Conta guest adicionada e verificada com sucesso",
"uid": "5437930135",
"diamonds": 250
}| Parâmetro | Tipo | Descrição |
|---|---|---|
| key obrigatório | string | Sua Key |
| uid obrigatório | string | UID da conta a ser desvinculada |
{
"status": "success",
"message": "Conta 5437930135 removida com sucesso"
}| Parâmetro | Tipo | Descrição |
|---|---|---|
| uid obrigatório | string | UID da conta guest |
| password obrigatório | string | Senha da conta guest |
{
"status": "success",
"valid": true,
"uid": "5437930135",
"diamonds": 250,
"can_send_pass": true
}Decodificação oficial OB55 com suporte a rotação em 220 contas e fallback entre servidores.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| uid obrigatório | string | UID do jogador para consulta |
| server_name / region opcional | string | Região da conta (BR, US, SAC, IND, BD). padrão: BR |
{
"status": "success",
"account_id": "123456789",
"nickname": "Luizinho⚡",
"level": 74,
"likes": 15420,
"region": "BR",
"badge_cnt": 320,
"exp": 845200,
"rank": 28
}| Parâmetro | Tipo | Descrição |
|---|---|---|
| uid obrigatório | string | UID do jogador |
{
"status": "success",
"nickname": "Luizinho⚡",
"uid": "123456789"
}{
"status": "online",
"release_version": "OB55",
"uptime_seconds": 3600,
"last_latency_ms": 142,
"today_success_rate": 99.8,
"today_requests": 18,
"stats": {
"reseller_keys": 4,
"total_accounts": 220,
"total_diamonds_pool": 55000,
"total_passes_available": 220,
"total_ninjas_available": 44,
"total_gifts_sent": 18
}
}Códigos de Erro
| Código HTTP | Error Code | Motivo | Resolução |
|---|---|---|---|
| 400 Bad Request | INVALID_UID |
UID não fornecido ou inválido | Envie um UID numérico válido do Free Fire |
| 400 Bad Request | SELF_PASSE |
UID do destinatário é igual à conta de envio | Não envie presentes para a própria conta guest de envio |
| 401 Unauthorized | INVALID_KEY |
Key incorreta ou revogada | Verifique sua chave com o administrador |
| 403 Forbidden | LIMIT_EXCEEDED |
Saldo ou limite de passes da key esgotado | Adicione mais contas com diamantes ou recarregue sua key |
| 404 Not Found | PLAYER_NOT_FOUND |
Jogador não encontrado no servidor especificado | Confirme se o UID existe e teste outra região (BR, US, SAC) |
| 503 Service Unavailable | ACCOUNT_NOT_AVAILABLE |
Nenhuma conta com diamantes suficientes no momento | Aguarde o pool rotacionar ou vincule novas contas guest |
Suporte & Contato
Para suporte comercial, recargas de diamantes, aquisição de chaves de revenda ou dúvidas sobre a integração via webhook/API, entre em contato através dos nossos canais oficiais:
Site Oficial: https://newfire.top
Comunidade Discord: discord.gg/newfire