如何通过 API 获取钱包的完整交易历史：Solana、EVM 与 Tron

1. 获取你的免费 API 密钥

在 /dashboard 注册。10 万笔交易免费，无需绑卡。

2. 调用 接口

一次请求，使用 bearer key 进行身份验证。-N 可以阻止 curl 做缓冲，让你在每个批次流入时立刻看到：

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

3. 读懂响应

默认 接口 会流式返回 NDJSON：交易每获取到一批就输出一行，因此大额钱包会在单次调用中逐步返回，无需后续请求。最后一行带有 complete: true 与 cursor: null，表示该钱包做过的每一笔交易都已返回：

# 流式 NDJSON：每获取到一批交易输出一行
{ "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" }

# ...更多批次行...

# 结束行：没有 cursor 表示完整历史已全部返回
{ "complete": true, "tradeCount": 354, "wallet": "BtDy...AAu9", "firstTrade": "2026-07-12T07:39:02+00:00" }

4. 恢复或分页处理大额钱包

每个流式行都包含一个 cursor。如果流提前中断（超大钱包会以 complete: false 结束），用 ?cursor= 重新连接即可从中断处继续。更想要离散的分页而不是流？加上 ?limit= 就能获得使用同一 cursor 的单个 JSON 页面：

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

# 只要还有内容待获取，就会包含一个不透明的 cursor
{ "tradeCount": 354, "trades": [ /* 100 trades */ ], "cursor": "8kQ2mZ...f0X" }

# 获取下一页；最后一页带有 "complete":true 且没有 cursor
curl "https://veltrabot.com/v1/wallets/{address}/history?limit=100&cursor=8kQ2mZ...f0X" \
  -H "Authorization: Bearer YOUR_API_KEY"

完整参考（身份验证、错误、速率限制与定价）都在文档中。你也可以在 控制台 里用自己的钱包直接试一试。