Funding

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. Recorded row cadence is family- and symbol-specific; check coverage metadata for the selected window. These rows are not the venue’s funding payment or annualization interval.

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.For Lighter, funding_rate is a fractional, non-annualized decimal string. For example, 0.0001 represents 0.01%.

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: `5m`, `15m`, `30m`, `1h`, `4h`, or `1d`. When omitted, the route returns raw source updates at the family-specific cadence.
`limit`	query	integer	No	Max results. Default 100, maximum 1000.
`cursor`	query	integer	No	Pagination cursor from `meta.next_cursor`; pass the returned value unchanged.

{
  "success": true,
  "data": { "coin": "BTC", "symbol": "BTC", "timestamp": "2026-06-05T16:44:24.247Z", "funding_rate": "0.0000012223", "premium": "-0.0006575703" },
  "meta": { "request_id": "cccccccc-cccc-4ccc-8ccc-cccccccccccc" }
}

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

For Lighter, funding_rate is a fractional, non-annualized decimal string. For example, 0.0001 represents 0.01%, not 0.0001 percentage points. Keep Lighter values separate from other venue families; do not annualize or compare them across venues. 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.

Recorded row cadence

Cadence is family- and symbol-specific. Use coverage and freshness routes for the selected symbol and window; a row cadence is not a funding payment or annualization interval.

Stream or replay it

Funding streams live on Hyperliquid core (funding) and HIP-3 (hip3_funding). Lighter current funding uses REST, and lighter_funding supports historical WebSocket replay but not live subscriptions through the 0xArchive WebSocket. Historical data is also available through REST and exports. 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 ($0.50/GB, $2.50 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.

Start

API

Exports

Data types

Venues

Data rights

Get funding

Request parameters

Response fields

Reading the funding rate

Recorded row cadence

Stream or replay it

Export in bulk

Next

​Get funding

​Request parameters

​Response fields

​Reading the funding rate

​Recorded row cadence

​Stream or replay it

​Export in bulk

​Next

Get funding

Request parameters

Response fields

Reading the funding rate

Recorded row cadence

Stream or replay it

Export in bulk

Next