Loading capabilities…
Loading capability…
Screen perpetual futures markets by volume, buy/sell pressure, open interest and funding over a date range.
Both commands call the selected provider directly.
curl -X POST '/routes/nansen/crypto/perp-screener' \
-H 'content-type: application/json' \
-d '{"pagination":{"page":1,"per_page":10},"filters":{"only_smart_money":false}}'h402 call 'crypto/perp-screener' --provider 'nansen' --method POST --json '{"pagination":{"page":1,"per_page":10},"filters":{"only_smart_money":false}}'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.
dateobjectrequiredScreener window; either or both ISO 8601 date/date-time bounds may be supplied.
date.fromstringoptional10–35 charsOptional inclusive start in ISO 8601 date or date-time format.
date.tostringoptional10–35 charsOptional inclusive end in ISO 8601 date or date-time format.
paginationobjectoptionalOptional Nansen pagination using page and per_page.
pagination.pageintegeroptional≥ 1default 11-based page number.
pagination.per_pageintegeroptional1–1000default 10Results per page (max 1000).
filtersobjectoptionalOptional Nansen perpetual-market filters.
filters.trader_typestringoptionalTrader cohort used by Nansen for trader-dependent metrics; overrides only_smart_money.
filters.only_smart_moneybooleanoptionaldefault falseDeprecated Nansen alias for trader_type=sm.
filters.sectors_filterarrayoptionalSectors in category:subcategory format.
filters.sm_label_filterarrayoptionalSmart Money labels; applies to all and sm trader types.
filters.trader_label_filterarrayoptionalHyperliquid trader labels; applies to all and sm trader types.
filters.token_symbolstringoptionalToken symbol to match.
filters.volumeobjectoptionalTotal volume range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.buy_volumeobjectoptionalBuy volume range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.sell_volumeobjectoptionalSell volume range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.buy_sell_pressureobjectoptionalBuy/sell pressure range.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.trader_countobjectoptionalTrader count range.
Nested fields
minintegerMinimum value (inclusive).
maxintegerMaximum value (inclusive).
filters.mark_priceobjectoptionalMark price range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.fundingobjectoptionalFunding-rate range.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.previous_price_usdobjectoptionalPrevious price range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.open_interestobjectoptionalOpen-interest range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.smart_money_volumeobjectoptionalSmart Money volume range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.smart_money_buy_volumeobjectoptionalSmart Money buy volume range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.smart_money_sell_volumeobjectoptionalSmart Money sell volume range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.net_position_changeobjectoptionalNet position change range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.current_smart_money_position_longs_usdobjectoptionalCurrent Smart Money long-position range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.current_smart_money_position_shorts_usdobjectoptionalCurrent Smart Money short-position range in USD.
Nested fields
minnumberMinimum value (inclusive).
maxnumberMaximum value (inclusive).
filters.smart_money_longs_countobjectoptionalSmart Money long-position count range.
Nested fields
minintegerMinimum value (inclusive).
maxintegerMaximum value (inclusive).
filters.smart_money_shorts_countobjectoptionalSmart Money short-position count range.
Nested fields
minintegerMinimum value (inclusive).
maxintegerMaximum value (inclusive).
order_byarrayoptionalOptional sort clauses. Nansen accepts different subsets for all, Smart Money, and other trader modes; this enum is their deduplicated union.
Nested fields
fieldstringrequiredOne of token_symbol, volume, buy_volume, sell_volume, buy_sell_pressure, trader_count, mark_price, funding, previous_price_usd, open_interest, smart_money_volume, smart_money_buy_volume, smart_money_sell_volume, net_position_change, current_smart_money_position_longs_usd, current_smart_money_position_shorts_usd, smart_money_longs_count, smart_money_shorts_count, current_position_longs_usd, current_position_shorts_usd, longs_count, shorts_countField to sort by.
directionstringrequiredOne of ASC, DESCSort direction.
{
"pagination": {
"page": 1,
"per_page": 10
},
"filters": {
"only_smart_money": false
}
}{ "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" } }
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.