Catalog
CryptoPOSTlive

Token screener

Screen tokens across supported chains using Nansen market and smart-money filters.

$0.01
per call
Success
100%
p50 latency
1.82s
p95 latency
1.84s
Calls (30d)
3

Provider contract

Call path
/routes/nansen/crypto/token-screener
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-screener' \
  -H 'content-type: application/json' \
  -d '{"chains":["base"],"timeframe":"24h"}'
CLI
h402 call 'crypto/token-screener' --provider 'nansen' --method POST --json '{"chains":["base"],"timeframe":"24h"}'

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.

chainsarrayrequired

Nansen chain slugs to include (provider-dependent set, e.g. ethereum, base, arbitrum). See Nansen docs for the full supported-chains list.

e.g.
timeframestringrequired

Screener time window.

One of
filtersobjectoptional

Optional Nansen filter object, passed through as-is.

paginationobjectoptional

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

pagination.pageintegeroptional≥ 1

1-based page number.

pagination.per_pageintegeroptional1–1000

Results per page.

order_byarrayoptional

Optional Nansen sort order array, passed through as-is.

POST/routes/nansen/crypto/token-screener
Request body
{
  "chains": [
    "base"
  ],
  "timeframe": "24h"
}

ResponseExample response
{
  "data": {
    "data": [
      {
        "chain": "base",
        "token_address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "token_symbol": "USDC",
        "token_age_days": 1069,
        "token_age_hours": 25653,
        "token_deployment_date": "2023-08-18T18:36:29",
        "market_cap_usd": 73153594335,
        "liquidity": 225956111.98000208,
        "price_usd": 0.9998616271869476,
        "price_change": 0.00000926054812390737,
        "fdv": 73153752813,
        "fdv_mc_ratio": 1.000002166373388,
        "buy_volume": 237817397.0217431,
        "inflow_fdv_ratio": 0.0032509254532664396,
        "outflow_fdv_ratio": 0.003215775247135461,
        "sell_volume": 235246027.5311115,
        "volume": 473063424.5528546,
        "netflow": 2571369.4906315804
      },
      {
        "chain": "base",
        "token_address": "0x4200000000000000000000000000000000000006",
        "token_symbol": "WETH",
        "token_age_days": 1133,
        "token_age_hours": 27207,
        "token_deployment_date": "2023-06-15T00:00:00",
        "market_cap_usd": 507268991,
        "liquidity": 273732309.0051814,
        "price_usd": 1928.3739084009192,
        "price_change": 0.0019009509753338384,
        "fdv": 503185013,
        "fdv_mc_ratio": 0.9919490880135426,
        "buy_volume": 157543950.53306523,
        "inflow_fdv_ratio": 0.3130934874108924,
        "outflow_fdv_ratio": 0.2993440676519367,
        "sell_volume": 150625448.57291266,
        "volume": 308169399.1059779,
        "netflow": 6918501.960152566
      },
      {
        "chain": "base",
        "token_address": "0x60a3e35cc302bfa44cb288bc5a4f316fdb1adb42",
        "token_symbol": "EURC",
        "token_age_days": 784,
        "token_age_hours": 18814,
        "token_deployment_date": "2024-05-29T17:51:05",
        "market_cap_usd": 433735320,
        "liquidity": 460817028.7419413,
        "price_usd": 1.140876682607764,
        "price_change": 0.00026056463270274314,
        "fdv": 436527650,
        "fdv_mc_ratio": 1.0064378663005815,
        "buy_volume": 5274583.187001239,
        "inflow_fdv_ratio": 0.012083044881581358,
        "outflow_fdv_ratio": 0.011710896958393105,
        "sell_volume": 5112130.328639489,
        "volume": 10386713.515640728,
        "netflow": 162452.8583617499
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 10,
      "is_last_page": false
    }
  },
  "h402": {
    "routeId": "crypto/token-screener",
    "provider": "nansen",
    "selectedCandidateId": "crypto/token-screener/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
1.82s
Calls
3
100%
$0.01$0.010/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider