Skip to content

Get Volume Scanner

GET/v1/cryptodata/volume/scanner

Every Hyperliquid perp with its 24h volume, 30-day average, and multiplier. ``multiplier`` = live rolling-24h notional ÷ mean daily notional over the last 30 **settled** days (today's partial day is excluded from the baseline). A reading of 3.0 means the coin is trading at three times its normal daily volume. ``multiplier_median`` is the same ratio against the 30-day median, which is far less distorted by a single prior blow-off day — compare the two when a coin's recent history is lumpy. Perps listed less than 7 days ago have no honest baseline and report ``multiplier: null`` with ``band: "unknown"`` rather than a spurious number. Example screens: `?min_multiplier=3` (today's unusual activity), `?band=dormant` (coins that have gone quiet), `?sort=volume_24h` (plain volume leaderboard). **Tiers:** Free returns the top 20 perps by 24h volume; Pro / Pro Plus return the full universe.

Price

$0.01/ call

Edge cache

Off

Uptime 24h

100.00%

p95

722ms

Parameters

NameInTypeDescription
band query string (dormant | quiet | normal | elevated | surging | extreme) Filter by activity band
min_multiplier query number Only perps trading at or above this multiple of their 30d average
sort query string (multiplier | volume_24h | symbol | change_24h) = multiplier
limit query integer = 250

Code

curl
# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/cryptodata/volume/scanner"

# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/cryptodata/volume/scanner" -H "PAYMENT-SIGNATURE: $X402_PAYMENT"
TypeScript · @x402/fetch
// npm i @x402/fetch @x402/core @x402/evm viem
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = x402Client.fromConfig({ schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(PRIVATE_KEY)) }] });
const pay = wrapFetchWithPayment(fetch, client);
const data = await (await pay("https://api.realtimeapi.ai/v1/cryptodata/volume/scanner")).json();
console.log(data);
Python · x402
# pip install x402 eth-account requests
from eth_account import Account
from x402.clients.requests import x402_requests

session = x402_requests(Account.from_key(PRIVATE_KEY))
print(session.get("https://api.realtimeapi.ai/v1/cryptodata/volume/scanner").json())
With an API key
curl "https://api.realtimeapi.ai/v1/cryptodata/volume/scanner" -H "X-API-Key: $RTAPI_KEY"

Frequently asked questions

How do I get get volume scanner from CryptoDataAPI?

Send GET https://api.realtimeapi.ai/v1/cryptodata/volume/scanner. Pay $0.01 per request with x402, or send an X-API-Key header.

What does GET /volume/scanner cost?

$0.01 per successful request in USDC on Base. Failed requests are never charged.

Can I call this endpoint from an MCP client?

Yes. Connect any MCP client to the RealtimeAPI server and use call_feed with this endpoint's URL, or get_quote to check the price first.

Get a free key

1,000 calls a month across every feed. Who is setting it up?

No key needed at all: agents can pay per call in USDC with x402.