Skip to main content
POST
crypto.perp.snapshot

Authorizations

Authorization
string
header
required

API key: sk_live_…

Headers

Idempotency-Key
string

Optional. A retry with the same key returns the stored result.

Maximum string length: 255
Pramaan-Max-Price-Micro
string

Optional. The most this request may be priced at, in micro-USD (a whole number above 0). It replaces the capability's own price ceiling for this request, lower or higher. Sources that could cost more are left out; when none is left the answer is 400 with the lowest limit that would work.

Pattern: ^[1-9]\d{0,14}$

Body

application/json
pair
string
required

Trading pair (e.g. BTC/USDT). The swap settle suffix is added automatically from the quote currency, e.g. BTC/USDT:USDT or BTC/USDC:USDC. Example: BTC/USDT.

Required string length: 1 - 512
exchange
enum<string>

Exchange identifier. Hyperliquid uses USDC-settled perps (e.g. BTC/USDC:USDC). Example: binance. Defaults to "binance".

Available options:
binance,
okx,
bybit,
bitget,
htx,
bitfinex,
bitmex,
hyperliquid
fields
string

Comma-separated fields to include: 'funding' (current funding rate), 'oi' (open interest). Defaults to all fields. Example: funding,oi. Defaults to "funding,oi".

Required string length: 1 - 512

Response

The result

fundingFundingIntervalHours
number
required

Funding funding interval hours.

fundingFundingRate
number

Funding funding rate.

fundingFundingRate1h
number

Funding funding rate1h.

fundingFundingRate8h
number

Funding funding rate8h.

fundingFundingRateAnnualized
number

Funding funding rate annualized.

fundingFundingRateRaw
number

Funding funding rate raw.

fundingIndexPrice
number

Funding index price.

fundingMarkPrice
number

Funding mark price.

openInterestOpenInterestAmount
number

Open interest open interest amount.

openInterestOpenInterestUsd
number

Open interest open interest usd.

openInterestTimestamp
number

Open interest timestamp.

exchange
string

Exchange.

fundingExchange
string

Funding exchange.

fundingInterval
string

Funding interval.

fundingNextFunding
string

Funding next funding.

fundingPair
string

Funding pair.