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

# Funding rate history

> Historical 8-hour funding rate and mark-price snapshots for a symbol.

Historical funding rates for a symbol. Rows are written at 8-hour epoch boundaries (00:00 / 08:00 / 16:00 UTC).

**Weight:** `2`

## Request

```json theme={null}
{
  "type": "fundingRateHistory",
  "symbol": "PERP_BTC_USDC",
  "start_time": 1716100000000,
  "limit": 500
}
```

| Field        | Type   | Required | Default | Notes         |
| ------------ | ------ | -------- | ------- | ------------- |
| `symbol`     | string | Yes      | —       | Trading pair  |
| `start_time` | int64  | No       | —       | ms epoch      |
| `end_time`   | int64  | No       | —       | ms epoch      |
| `limit`      | int    | No       | 500     | 1..5000       |
| `cursor`     | string | No       | —       | Opaque cursor |

## Response

| Field                    | Type   | Notes                                   |
| ------------------------ | ------ | --------------------------------------- |
| `funding_rate`           | string | Per-8h cycle decimal                    |
| `mark_price`             | string | Mark price snapped to the funding epoch |
| `funding_rate_timestamp` | int64  | Funding epoch (ms epoch UTC)            |

## Notes

* 30s cache

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "rows": [
        {
          "funding_rate": "0.0001",
          "mark_price": "45678.90",
          "funding_rate_timestamp": 1716192000000
        }
      ],
      "next_cursor": null
    },
    "ts": 1779269143700
  }
  ```
</ResponseExample>