> ## Documentation Index
> Fetch the complete documentation index at: https://docs.0xarchive.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Funding

> Funding rate and premium payloads by venue family, current and historical, with decimal-safe field notes for backtests and dashboards.

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

<Tabs>
  <Tab title="Hyperliquid">
    ```bash theme={"theme":"github-dark"}
    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.
  </Tab>

  <Tab title="HIP-3">
    ```bash theme={"theme":"github-dark"}
    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`).
  </Tab>

  <Tab title="Lighter">
    ```bash theme={"theme":"github-dark"}
    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`.
  </Tab>
</Tabs>

## 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                                     |

```json theme={"theme":"github-dark"}
{
  "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.

```javascript theme={"theme":"github-dark"}
ws.send(JSON.stringify({ op: "subscribe", channel: "funding", symbol: "BTC" }));
```

Connection and reconnect handling live in the [WebSocket](/websocket) tab; see [WebSocket channels](/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](/data-catalog); columns and coverage keys are on [Export schemas](/export-schemas).

## Next

Use [Open interest](/rest-api/open-interest) for positioning, [Candles](/rest-api/candles) for price series, or [Data quality](/data-quality) before a funding series feeds alerts.