Cómo obtener el historial completo de trades de una wallet por API: Solana, EVM y Tron

1. Consigue tu API key gratuita

Regístrate en /dashboard. 100.000 trades gratis, sin tarjeta.

2. Llama al endpoint

Una sola petición, autenticada con una bearer key. La opción -N evita que curl haga buffering, así ves cada lote a medida que llega:

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

3. Interpreta la respuesta

El endpoint por defecto transmite NDJSON: una línea por lote de trades a medida que se obtienen, de modo que una wallet grande llega de forma progresiva en una sola llamada, sin peticiones adicionales. La línea final incluye complete: true y cursor: null, lo que significa que ha vuelto cada trade que la wallet ha hecho:

# NDJSON en streaming: una línea por lote a medida que se obtienen los trades
{ "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" }

# ...más líneas de lote...

# línea final: si no hay cursor, ha vuelto el historial completo
{ "complete": true, "tradeCount": 354, "wallet": "BtDy...AAu9", "firstTrade": "2026-07-12T07:39:02+00:00" }

4. Reanuda o pagina wallets grandes

Cada línea del stream incluye un cursor. Si un stream se detiene antes de tiempo (una wallet muy grande termina con complete: false), reconéctate con ?cursor= para retomarlo donde lo dejaste. ¿Prefieres páginas discretas en lugar de un stream? Añade ?limit= para obtener páginas de JSON único con el mismo cursor:

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

# se incluye un cursor opaco mientras quede historial por obtener
{ "tradeCount": 354, "trades": [ /* 100 trades */ ], "cursor": "8kQ2mZ...f0X" }

# pide la página siguiente; la última página lleva "complete":true y ningún cursor
curl "https://veltrabot.com/v1/wallets/{address}/history?limit=100&cursor=8kQ2mZ...f0X" \
  -H "Authorization: Bearer YOUR_API_KEY"

La referencia completa (autenticación, errores, límites de tasa y precios) está en la documentación. Pruébalo con tu propia wallet desde el dashboard.