---
title: "Get Volume Scanner"
method: GET
path: "/api/v1/volume/scanner"
tags: ["Volume Scanner"]
---

# Get Volume Scanner

`GET /api/v1/volume/scanner`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/volume/scanner`
- Auth: API key in header `X-API-Key`

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.

## Query parameters

- `band` 'dormant' | 'quiet' | 'normal' | 'elevated' | 'surging' | 'extreme' | 'unknown', nullable: Filter by activity band
- `min_multiplier` number, nullable: Only perps trading at or above this multiple of their 30d average
- `sort` 'multiplier' | 'volume_24h' | 'symbol' | 'change_24h'
- `limit` integer

## Response `200`

Successful Response

- VolumeScannerResponse
  - `as_of` string, required
  - `items` VolumeScannerItem[], required
    - `symbol` string, required
    - `price` number, required
    - `change_24h` number, nullable
    - `volume_change_24h` number, nullable
    - `spark_7d` number[]
    - `volume_24h` number, required
    - `avg_volume_30d` number, nullable
    - `median_volume_30d` number, nullable
    - `multiplier` number, nullable
    - `multiplier_median` number, nullable
    - `open_interest_usd` number
    - `funding_rate` number
    - `days_of_history` integer
    - `band` 'dormant' | 'quiet' | 'normal' | 'elevated' | 'surging' | 'extreme' | 'unknown'
  - `count` integer, required
  - `universe_size` integer, required
  - `rated_size` integer, required
  - `total_volume_24h` number, required
  - `market_multiplier` number, nullable
  - `surging_count` integer
  - `window_days` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cryptodataapi/apis/crypto-data-api.md) · [All operations](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/revisions/8628b754ca81?raw)