Hunt Townh402
Catalog
CryptoPOSTlive

Token flows

Get token inflow/outflow time series across DEX and CEX venues over a date range, optionally filtered by label.

$0.01
per call
Success
100%
p50 latency
2.19s
p95 latency
2.26s
Calls (30d)
2

Provider contract

Call path
/routes/nansen/crypto/token-flows
Method
POST
Selected provider
nansendefault
Provider price
$0.01
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl -X POST '/routes/nansen/crypto/token-flows' \
  -H 'content-type: application/json' \
  -d '{"chain":"ethereum","token_address":"0x6982508145454ce325ddbe47a25d4ec3d2311933","date":{"from":"2026-05-15T00:00:00Z","to":"2026-05-21T23:59:59Z"}}'
CLI
h402 call 'crypto/token-flows' --provider 'nansen' --method POST --json '{"chain":"ethereum","token_address":"0x6982508145454ce325ddbe47a25d4ec3d2311933","date":{"from":"2026-05-15T00:00:00Z","to":"2026-05-21T23:59:59Z"}}'

Parameters & live test

pays real USDC

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

chainstringrequired

Nansen chain slug for the token.

One of
token_addressstringrequired

Token contract address (chain-native for non-EVM chains).

e.g.
dateobjectrequired

ISO 8601 date-time range for the flows, with from and to fields.

date.fromstringrequired

Inclusive range start.

e.g.
date.tostringrequired

Inclusive range end.

e.g.
labelstringoptional

Optional cohort label to filter the flows by.

One of
paginationobjectoptional

Optional pagination, e.g. { "page": 1, "perPage": 10 }.

pagination.pageintegeroptional≥ 1

1-based page number.

pagination.per_pageintegeroptional1–1000

Results per page (max 1000).

POST/routes/nansen/crypto/token-flows
Request body
{
  "chain": "ethereum",
  "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
  "date": {
    "from": "2026-05-15T00:00:00Z",
    "to": "2026-05-21T23:59:59Z"
  }
}

ResponseExample response
{
  "data": {
    "data": [
      {
        "date": "2026-05-21T23:00:00",
        "price_usd": 0.0000037978520221720886,
        "token_amount": 26577527117.630787,
        "value_usd": 100937.51510802764,
        "holders_count": 5,
        "total_inflows_count": 0,
        "total_outflows_count": 0,
        "total_inflows_dex": null,
        "total_outflows_dex": null,
        "total_inflows_cex": null,
        "total_outflows_cex": null
      },
      {
        "date": "2026-05-21T22:00:00",
        "price_usd": 0.000003802492261251863,
        "token_amount": 26577527117.630787,
        "value_usd": 101060.84118800264,
        "holders_count": 5,
        "total_inflows_count": 0,
        "total_outflows_count": 0,
        "total_inflows_dex": null,
        "total_outflows_dex": null,
        "total_inflows_cex": null,
        "total_outflows_cex": null
      },
      {
        "date": "2026-05-21T21:00:00",
        "price_usd": 0.000003820473974689952,
        "token_amount": 26577527117.630787,
        "value_usd": 101538.75066452492,
        "holders_count": 5,
        "total_inflows_count": 0,
        "total_outflows_count": 0,
        "total_inflows_dex": null,
        "total_outflows_dex": null,
        "total_inflows_cex": null,
        "total_outflows_cex": null
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 10,
      "is_last_page": false
    },
    "warnings": [
      "total_inflows_dex, total_outflows_dex, total_inflows_cex and total_outflows_cex are only populated when label=exchange and are null for all other labels. For net flow per holder segment (e.g. smart money), use POST /api/v1/tgm/flow-intelligence."
    ]
  },
  "h402": {
    "routeId": "crypto/token-flows",
    "provider": "nansen",
    "selectedCandidateId": "crypto/token-flows/nansen",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

nansen
x402
100
Success
100%
p50
2.19s
Calls
2
100%
$0.01$0.010/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider