Como obter o histórico completo de trades de uma carteira via API: Solana, EVM e Tron

1. Obtenha sua API key gratuita

Cadastre-se em /dashboard. 100.000 trades grátis, sem cartão.

2. Chame o endpoint

Uma requisição, autenticada com uma bearer key. O -N impede que o curl faça buffer, então você vê cada lote conforme ele chega:

curl -N https://veltrabot.com/v1/wallets/{address}/history \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Leia a resposta

O endpoint padrão transmite NDJSON: uma linha por lote de trades conforme são obtidos, de modo que uma carteira grande chega gradualmente em uma única chamada, sem requisições adicionais. A linha final traz complete: true e cursor: null, o que significa que todos os trades que a carteira já fez voltaram:

# NDJSON em streaming: uma linha por lote conforme os trades são obtidos
{ "trades": [
    {
      "signature": "43C68awy5pN3ze...aY1Ve2X",
      "side": "sell",
      "token": "Benny",
      "tokenMint": "9xY2...pump",
      "amountSol": 0.044850796,
      "amount": 152340.12,
      "dex": "Pump.fun",
      "blockTime": "2026-07-19T07:37:17+00:00"
    }
  ],
  "cursor": "8kQ2mZ...f0X" }

# ...mais linhas de lote...

# linha final: sem cursor significa que o histórico completo voltou
{ "complete": true, "tradeCount": 354, "wallet": "BtDy...AAu9", "firstTrade": "2026-07-12T07:39:02+00:00" }

4. Retome ou pagine carteiras grandes

Cada linha do stream inclui um cursor. Se um stream parar antes do fim (uma carteira muito grande termina com complete: false), reconecte com ?cursor= para continuar de onde parou. Prefere páginas discretas em vez de um stream? Acrescente ?limit= para receber páginas em JSON único com o mesmo cursor:

curl "https://veltrabot.com/v1/wallets/{address}/history?limit=100" \
  -H "Authorization: Bearer YOUR_API_KEY"

# um cursor opaco é incluído enquanto ainda houver o que buscar
{ "tradeCount": 354, "trades": [ /* 100 trades */ ], "cursor": "8kQ2mZ...f0X" }

# busque a próxima página; a última traz "complete":true e nenhum cursor
curl "https://veltrabot.com/v1/wallets/{address}/history?limit=100&cursor=8kQ2mZ...f0X" \
  -H "Authorization: Bearer YOUR_API_KEY"

A referência completa (autenticação, erros, limites de taxa e preços) está na documentação. Teste com a sua própria carteira pelo dashboard.