Funding - 0xArchive

Funding is the periodic payment between longs and shorts. The route returns the rate and its premium component. Hyperliquid core, HIP-3, and Lighter serve funding; Spot and HIP-4 do not.

Get funding

Hyperliquid
HIP-3
Lighter

curl "https://api.0xarchive.io/v1/hyperliquid/funding/BTC/current" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"

/current is the latest value; /v1/hyperliquid/funding/{symbol} paginates history.

curl "https://api.0xarchive.io/v1/hyperliquid/hip3/funding/km:US500/current" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"

/v1/hyperliquid/hip3/funding/{symbol} and /current. Namespaced builder symbols, case-sensitive (for example km:US500).

curl "https://api.0xarchive.io/v1/lighter/funding/{symbol}/current" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"

/v1/lighter/funding/{symbol} and /current. Find symbols on /v1/lighter/instruments.

Request parameters

Parameter	In	Type	Required	Description
`symbol`	path	string	Yes	Trading pair symbol, e.g. `BTC`
`start`	query	integer (ms)	No	Start time, Unix ms. Defaults to 24h ago
`end`	query	integer (ms)	No	End time, Unix ms. Defaults to now
`interval`	query	string	No	Aggregation interval; omit for raw ~1 min resolution
`limit`	query	integer	No	Max results. Default 100, max 1000
`cursor`	query	integer	No	Pagination cursor

{
  "success": true,
  "data": { "coin": "BTC", "symbol": "BTC", "timestamp": "2026-06-05T16:44:24.247Z", "funding_rate": "0.0000012223", "premium": "-0.0006575703" },
  "meta": { "request_id": "req_3a1f8c0b9e2d4a76" }
}

Response fields

Field	Type	Description
`symbol`	string	Trading pair symbol (`coin` is a deprecated alias)
`timestamp`	string	Funding time (UTC)
`funding_rate`	string	Funding rate as a decimal (e.g. `0.0001` is 0.01%)
`premium`	string	Premium component of the funding rate

funding_rate and premium are decimal strings, so keep them as strings to the application edge.

Reading the funding rate

funding_rate is the rate for one funding interval, not an annualized figure. To compare venues or annualize, multiply by the number of intervals per day and then by 365; Hyperliquid funds hourly, so a small hourly rate compounds quickly. A positive rate means longs pay shorts; a negative rate means shorts pay longs. premium is the mark-to-index component that drives the rate. Keep both as decimal strings until the application edge so small rates do not lose precision in floating point.

Stream it live

Funding streams on Hyperliquid core (funding), HIP-3 (hip3_funding), and Lighter (lighter_funding). Spot and HIP-4 do not serve funding.

ws.send(JSON.stringify({ op: "subscribe", channel: "funding", symbol: "BTC" }));

Connection and reconnect handling live in the WebSocket tab; see WebSocket Channels for the family matrix.

Export in bulk

For a funding-rate history as files, use the funding export schema ($1/GB, $5 minimum), delivered as Parquet with ZSTD compression. Build a selection in the Data Catalog; columns and coverage keys are on Export Schemas.

Use Open interest for positioning, Candles for price series, or Data Quality before a funding series feeds alerts.

​Get funding

​Request parameters

​Response fields

​Reading the funding rate

​Stream it live

​Export in bulk

​Next