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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.