Referência da API

Recargas com cripto

Atualizado em outubro de 2026

Adicione saldo com cripto: obtenha o endereço de depósito e o valor exato, envie exatamente esse valor, informe que o pagamento foi enviado (o ID da transação é opcional) e acompanhe a recarga até o saldo ser creditado. O saldo pode ser usado para pagar qualquer um dos nossos planos.

7 min de leitura

Endpoints nesta página

GET /v1/catalog/coins: Criptomoedas e redes aceitas (com o respectivo endereço fixo de depósito)
POST /v1/topups: Iniciar uma recarga com cripto do saldo (endereço fixo, valor exato)
POST /v1/topups/{topUpId}/txid: Informar que o pagamento foi enviado (TXID opcional)
GET /v1/topups/{topUpId}: Consultar uma recarga (verificar o status em tempo real)
GET /v1/topups: Listar recargas com cripto

URL base https://localserpproxy.com/api/v1. Para ver autenticação, erros e limites, consulte a visão geral da API.

Criptomoedas e redes aceitas (com endereço fixo para depósito)

GET/v1/catalog/coins

Público: não é necessária uma chave da API.

Resposta `200 OK`

{
  "data": [
    {
      "code": "BTC",
      "name": "Bitcoin",
      "networks": [
        {
          "id": "bitcoin",
          "name": "Bitcoin",
          "confirmationsRequired": 2,
          "estimatedMinutes": null,
          "memoRequired": false,
          "address": "DEPOSIT_ADDRESS"
        }
      ]
    }
  ]
}

Exemplos de código

curl

curl -s "https://localserpproxy.com/api/v1/catalog/coins"

Python

import os
import requests

API = "https://localserpproxy.com/api/v1"

r = requests.get(f"{API}/catalog/coins", timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://localserpproxy.com/api/v1';

const res = await fetch(`${API}/catalog/coins`);
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Iniciar uma recarga de saldo em cripto (endereço fixo, valor exato)

POST/v1/topups

amountUsd ≥ 25.00 USD e ≤ o máximo (10,000.00 por padrão): 422 em amountUsd; caso contrário.
coin + network deve ser um de GET /v1/catalog/coins (409 coin_unavailable caso contrário).
Retorna o address fixo da rede e o amountCrypto exato = amountUsd / rate arredondado para cima até a precisão da moeda (BTC/LTC/ETH/SOL: 8 casas decimais; USDT/USDC: 6), além de um pequeno valor único nos últimos dígitos para que duas recargas abertas na mesma rede nunca solicitem o mesmo valor. rate fica bloqueado até expiresAt (30 minutos); txidDeadline = expiresAt + 72 h.
purchase opcional (mesmo corpo de POST /v1/orders): validado e precificado agora (422 com nomes de campos prefixados por purchase., 409 plan_unavailable…). amountUsd deve cobrir o total de purchase − o saldo atual (422 too_small em amountUsd). Quando a recarga for creditada, o pedido será feito com o saldo na mesma transação; purchase.status passa a ser completed (com orderId) ou failed (failureReason; os fundos permanecem no saldo).

Autenticação: chave da API no cabeçalho Authorization: Bearer API_KEY.

Parâmetros

Nome	Em	Tipo	Obrigatório	Descrição
`Idempotency-Key`	header	string	Não	Chave única (por exemplo, um UUID) para repetir uma solicitação POST com segurança. Mantida por 24 h. — máx. 128 caracteres

Corpo da solicitação

Campo	Tipo	Obrigatório	Descrição
`amountUsd`	string (USD, 2 decimals)	Sim	Valor em USD a adicionar: ≥ 25.00, ≤ 10,000.00 por padrão.
`coin`	string	Sim	—
`network`	string	Sim	—
`purchase`	object	Não	Plano para comprar com o saldo assim que a recarga for creditada (mesmo corpo de `POST /v1/orders`).

Exemplo: Saldo

{
  "amountUsd": "50.00",
  "coin": "USDT",
  "network": "tron"
}

Exemplo: Finalização da compra

{
  "amountUsd": "25.00",
  "coin": "BTC",
  "network": "bitcoin",
  "purchase": {
    "planId": "res-10",
    "quantity": 1
  }
}

Resposta `201 Created`

{
  "id": "top_7d2kq9x1",
  "status": "verifying",
  "final": false,
  "amountUsd": "25.00",
  "coin": "USDT",
  "network": "tron",
  "address": "DEPOSIT_ADDRESS",
  "amountCrypto": "25.000137",
  "rate": "1.00",
  "paymentUri": "PAYMENT_URI",
  "expiresAt": "2026-10-05T14:33:11Z",
  "txidDeadline": "2026-10-08T14:33:11Z",
  "confirmationsRequired": 20,
  "confirmations": 7,
  "txid": "9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
  "txidSubmittedAt": "2026-10-05T14:09:42Z",
  "amountReceivedCrypto": "25.000137",
  "explorerUrl": "https://tronscan.org/#/transaction/9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
  "creditedUsd": null,
  "creditedAt": null,
  "rejection": null,
  "purchase": {
    "planId": "res-10",
    "planName": "Local team",
    "quantity": 1,
    "options": {},
    "promoCode": null,
    "total": "7.50",
    "status": "pending",
    "orderId": null,
    "failureReason": null
  },
  "createdAt": "2026-10-05T14:03:11Z"
}

Exemplos de código

curl

curl -s -X POST "https://localserpproxy.com/api/v1/topups" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"amountUsd":"50.00","coin":"USDT","network":"tron"}'

Python

import os, uuid
import requests

API = "https://localserpproxy.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}", "Idempotency-Key": str(uuid.uuid4())}

r = requests.post(f"{API}/topups", headers=HEADERS, json={"amountUsd": "50.00", "coin": "USDT", "network": "tron"}, timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
import { randomUUID } from 'node:crypto';

const API = 'https://localserpproxy.com/api/v1';

const res = await fetch(`${API}/topups`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, 'Idempotency-Key': randomUUID(), 'Content-Type': 'application/json' },
  body: JSON.stringify({ amountUsd: '50.00', coin: 'USDT', network: 'tron' }),
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Informar que o pagamento foi enviado (TXID opcional)

POST/v1/topups/{topUpId}/txid

Informe que o pagamento foi enviado depois que ele sair da sua carteira ou exchange: esta é a versão da API do botão “Já enviei o pagamento”. O ID da transação (TXID) é opcional: envie um corpo vazio ({}) ou adicione txid, se tiver. O pagamento é associado a esta recarga pelo valor exato (amountCrypto) na rede e no endereço da recarga; por isso, envie exatamente esse valor.

Aceito enquanto a recarga estiver awaiting_payment, expired ou rejected, e antes de txidDeadline (expiresAt + 72 h): um aviso tardio nunca faz com que um pagamento seja perdido. Quando informado, um txid é verificado conforme o formato da rede (422 em txid) e não pode estar associado a outra recarga (409 txid_already_used). Uma recarga encerrada retorna 409 topup_closed. Em seguida, a recarga fica verifying enquanto o pagamento é verificado na blockchain e termina como credited quando a rede confirmar a transação, ou como rejected (com rejection).

Autenticação: chave da API no cabeçalho Authorization: Bearer API_KEY.

Parâmetros

Nome	Em	Tipo	Obrigatório	Descrição
`topUpId`	path	string	Sim	—

Corpo da solicitação

Campo	Tipo	Obrigatório	Descrição
`txid`	string	Não	Opcional. Hash da transação: 64 caracteres hexadecimais (bitcoin, litecoin, tron), 0x + 64 caracteres hexadecimais (ethereum), assinatura base58 (solana). Vazio ou ausente: o pagamento é associado pelo valor exato. — máx. 128 caracteres

Exemplo: Pagamento enviado

{}

Exemplo: Com o TXID (opcional)

{
  "txid": "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"
}

Resposta `200 OK`

{
  "id": "top_7d2kq9x1",
  "status": "verifying",
  "final": false,
  "amountUsd": "25.00",
  "coin": "USDT",
  "network": "tron",
  "address": "DEPOSIT_ADDRESS",
  "amountCrypto": "25.000137",
  "rate": "1.00",
  "paymentUri": "PAYMENT_URI",
  "expiresAt": "2026-10-05T14:33:11Z",
  "txidDeadline": "2026-10-08T14:33:11Z",
  "confirmationsRequired": 20,
  "confirmations": 7,
  "txid": "9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
  "txidSubmittedAt": "2026-10-05T14:09:42Z",
  "amountReceivedCrypto": "25.000137",
  "explorerUrl": "https://tronscan.org/#/transaction/9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
  "creditedUsd": null,
  "creditedAt": null,
  "rejection": null,
  "purchase": {
    "planId": "res-10",
    "planName": "Local team",
    "quantity": 1,
    "options": {},
    "promoCode": null,
    "total": "7.50",
    "status": "pending",
    "orderId": null,
    "failureReason": null
  },
  "createdAt": "2026-10-05T14:03:11Z"
}

Exemplos de código

curl

curl -s -X POST "https://localserpproxy.com/api/v1/topups/top_7d2kq9x1/txid" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Python

import os
import requests

API = "https://localserpproxy.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.post(f"{API}/topups/top_7d2kq9x1/txid", headers=HEADERS, json={}, timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://localserpproxy.com/api/v1';

const res = await fetch(`${API}/topups/top_7d2kq9x1/txid`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({}),
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Fazer uma recarga (consultar o status em tempo real)

GET/v1/topups/{topUpId}

Consulte esta rota para acompanhar uma recarga: a cada 10 s enquanto status = verifying, a cada 30 s enquanto aguarda o pagamento e pare quando final = true. Uma recarga passa para expired quando o pagamento não é informado como enviado antes de expiresAt; ainda é possível informar o envio até txidDeadline.

Autenticação: chave da API no cabeçalho Authorization: Bearer API_KEY.

Parâmetros

Nome	Em	Tipo	Obrigatório	Descrição
`topUpId`	path	string	Sim	—

Resposta `200 OK`

{
  "id": "top_7d2kq9x1",
  "status": "verifying",
  "final": false,
  "amountUsd": "25.00",
  "coin": "USDT",
  "network": "tron",
  "address": "DEPOSIT_ADDRESS",
  "amountCrypto": "25.000137",
  "rate": "1.00",
  "paymentUri": "PAYMENT_URI",
  "expiresAt": "2026-10-05T14:33:11Z",
  "txidDeadline": "2026-10-08T14:33:11Z",
  "confirmationsRequired": 20,
  "confirmations": 7,
  "txid": "9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
  "txidSubmittedAt": "2026-10-05T14:09:42Z",
  "amountReceivedCrypto": "25.000137",
  "explorerUrl": "https://tronscan.org/#/transaction/9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
  "creditedUsd": null,
  "creditedAt": null,
  "rejection": null,
  "purchase": {
    "planId": "res-10",
    "planName": "Local team",
    "quantity": 1,
    "options": {},
    "promoCode": null,
    "total": "7.50",
    "status": "pending",
    "orderId": null,
    "failureReason": null
  },
  "createdAt": "2026-10-05T14:03:11Z"
}

Exemplos de código

curl

curl -s "https://localserpproxy.com/api/v1/topups/top_7d2kq9x1" \
  -H "Authorization: Bearer $API_KEY"

Python

import os
import requests

API = "https://localserpproxy.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.get(f"{API}/topups/top_7d2kq9x1", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://localserpproxy.com/api/v1';

const res = await fetch(`${API}/topups/top_7d2kq9x1`, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Listar recargas com cripto

GET/v1/topups

Autenticação: chave da API no cabeçalho Authorization: Bearer API_KEY.

Parâmetros

Nome	Em	Tipo	Obrigatório	Descrição
`page`	query	integer	Não	≥ 1, padrão `1`
`perPage`	query	integer	Não	1–100, padrão `20`
`status`	query	`awaiting_payment` · `verifying` · `credited` · `rejected` · `expired`	Não	`final` = creditada ou expirada / rejeitada após `txidDeadline`.

Resposta `200 OK`

{
  "data": [
    {
      "id": "top_7d2kq9x1",
      "status": "verifying",
      "final": false,
      "amountUsd": "25.00",
      "coin": "USDT",
      "network": "tron",
      "address": "DEPOSIT_ADDRESS",
      "amountCrypto": "25.000137",
      "rate": "1.00",
      "paymentUri": "PAYMENT_URI",
      "expiresAt": "2026-10-05T14:33:11Z",
      "txidDeadline": "2026-10-08T14:33:11Z",
      "confirmationsRequired": 20,
      "confirmations": 7,
      "txid": "9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
      "txidSubmittedAt": "2026-10-05T14:09:42Z",
      "amountReceivedCrypto": "25.000137",
      "explorerUrl": "https://tronscan.org/#/transaction/9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
      "creditedUsd": null,
      "creditedAt": null,
      "rejection": null,
      "purchase": {
        "planId": "res-10",
        "planName": "Local team",
        "quantity": 1,
        "options": {},
        "promoCode": null,
        "total": "7.50",
        "status": "pending",
        "orderId": null,
        "failureReason": null
      },
      "createdAt": "2026-10-05T14:03:11Z"
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 20,
    "total": 1,
    "totalPages": 1
  }
}

Exemplos de código

curl

curl -s "https://localserpproxy.com/api/v1/topups" \
  -H "Authorization: Bearer $API_KEY"

Python

import os
import requests

API = "https://localserpproxy.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.get(f"{API}/topups", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())

Node.js

// Node.js 18+ (built-in fetch), ES module
const API = 'https://localserpproxy.com/api/v1';

const res = await fetch(`${API}/topups`, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Criptomoedas e redes aceitas (com endereço fixo para depósito)

Resposta 200 OK

Exemplos de código

Iniciar uma recarga de saldo em cripto (endereço fixo, valor exato)

Parâmetros

Corpo da solicitação

Resposta 201 Created

Exemplos de código

Informar que o pagamento foi enviado (TXID opcional)

Parâmetros

Corpo da solicitação

Resposta 200 OK

Exemplos de código

Fazer uma recarga (consultar o status em tempo real)

Parâmetros

Resposta 200 OK

Exemplos de código

Listar recargas com cripto

Parâmetros

Resposta 200 OK

Exemplos de código

Páginas relacionadas

Resposta `200 OK`

Resposta `201 Created`

Resposta `200 OK`

Resposta `200 OK`

Resposta `200 OK`