Hunt Townh402
Catalog
CryptoPOSTlive

Perp screener

Screen perpetual futures markets by volume, buy/sell pressure, open interest and funding over a date range.

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

Provider contract

Call path
/routes/nansen/crypto/perp-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/perp-screener' \
  -H 'content-type: application/json' \
  -d '{"date":{"from":"2026-05-20T00:00:00Z","to":"2026-05-21T00:00:00Z"}}'
CLI
h402 call 'crypto/perp-screener' --provider 'nansen' --method POST --json '{"date":{"from":"2026-05-20T00:00:00Z","to":"2026-05-21T00:00:00Z"}}'

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.

dateobjectrequired

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

date.fromstringrequired

Inclusive range start.

e.g.
date.tostringrequired

Inclusive range end.

e.g.
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/perp-screener
Request body
{
  "date": {
    "from": "2026-05-20T00:00:00Z",
    "to": "2026-05-21T00:00:00Z"
  }
}

ResponseExample response
{
  "data": {
    "data": [
      {
        "volume": 1903181763.82685,
        "buy_volume": 1017042517.11001,
        "sell_volume": 886139246.71684,
        "buy_sell_pressure": 130903270.39317,
        "trader_count": 13394,
        "token_symbol": "BTC",
        "mark_price": 65851,
        "funding": 0.0000125,
        "open_interest": 2420379084.1624336,
        "previous_price_usd": 76807
      },
      {
        "volume": 916901393.3221,
        "buy_volume": 513878083.01345,
        "sell_volume": 403023310.30865,
        "buy_sell_pressure": 110854772.7048,
        "trader_count": 13320,
        "token_symbol": "HYPE",
        "mark_price": 58.479,
        "funding": 0.0000125,
        "open_interest": 1318986909.390599,
        "previous_price_usd": 47.998
      },
      {
        "volume": 341146508.3757,
        "buy_volume": 182226344.0618,
        "sell_volume": 158920164.3139,
        "buy_sell_pressure": 23306179.7479,
        "trader_count": 5548,
        "token_symbol": "ZEC",
        "mark_price": 512.32,
        "funding": 0.0000125,
        "open_interest": 291126700.6975998,
        "previous_price_usd": 573.82
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 10,
      "is_last_page": false
    }
  },
  "h402": {
    "routeId": "crypto/perp-screener",
    "provider": "nansen",
    "selectedCandidateId": "crypto/perp-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
2.09s
Calls
2
100%
$0.01$0.010/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider