Token Transfer History

GET /gateway/v1/token/transfers

Token Transfer History

cURL

curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/token/transfers

200

{
  "data": [
    {
      "amount": "<string>",
      "block_number": 123,
      "from_address": "<string>",
      "timestamp": 123,
      "to_address": "<string>",
      "tx_hash": "<string>",
      "amount_usd": 123,
      "symbol": "<string>"
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "https://example.com/schemas/DataResponseTokenTransferItem.json"
}

Query Parameters

address · string · required

Token contract address (0x-prefixed hex or Solana base58)

Example:

"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"

chain · enum<string> · required

Chain. Can be ethereum, base, solana, or tron.

Available options: ethereum, base, solana, tron

Example:

"ethereum"

from · string

Start of date range. Accepts Unix seconds or YYYY-MM-DD. Defaults to 30 days ago.

Example:

"2025-01-01"

to · string

End of date range. Accepts Unix seconds or YYYY-MM-DD. Defaults to today.

Example:

"2025-03-01"

limit · integer<int64> · default: 20

Results per page

Required range: 1 <= x <= 100

Example:

20

offset · integer<int64> · default: 0

Pagination offset

Required range: x >= 0

Example:

0

Response

200

application/json

OK

data · object[] | null · required

Show child attributes

meta · object · required

Show child attributes

$schema · string<uri> · read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponseTokenTransferItem.json"