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"

전체 레퍼런스(인증, 오류, 요청 제한, 가격)는 문서에 있습니다. 대시보드에서 직접 본인 지갑으로 시험해 볼 수도 있습니다.