Skip to main content
GET
https://api.0xarchive.io
/
v1
/
hyperliquid
/
hip3
/
liquidations
/
{symbol}
/
volume
Get HIP-3 aggregated liquidation volume
curl --request GET \
  --url https://api.0xarchive.io/v1/hyperliquid/hip3/liquidations/{symbol}/volume \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "coin": "BTC",
      "timestamp": "2025-05-21T10:00:00.000Z",
      "total_usd": 1250000.5,
      "long_usd": 750000.25,
      "short_usd": 500000.25,
      "count": 42,
      "long_count": 25,
      "short_count": 17
    }
  ],
  "meta": {
    "count": 123,
    "next_cursor": "<string>"
  }
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Get yours at https://0xarchive.io/dashboard

Path Parameters

​
symbol
string
required

HIP-3 trading pair symbol (e.g., hyna:BTC, km:US500). Case-sensitive.

Example:

"hyna:BTC"

Query Parameters

​
start
integer<int64>
required

Start timestamp (Unix milliseconds)

Example:

1769922000000

​
end
integer<int64>

End timestamp (Unix milliseconds). Defaults to now.

​
cursor
string

Pagination cursor (timestamp in milliseconds)

​
limit
integer
default:1000

Maximum buckets to return (1-1000)

Required range: x <= 1000
​
interval
enum<string>
default:1h

Aggregation interval

Available options:
5m,
15m,
30m,
1h,
4h,
1d

Response

Aggregated liquidation volume data

API response containing an array of aggregated liquidation volumes

​
success
boolean
Example:

true

​
data
object[]
​
meta
object
Last modified on June 27, 2026