---
title: "Get Funding Rate History"
method: GET
path: "/v1/perps/funding_rate_history"
tags: ["Funding Rate"]
---

# Get Funding Rate History

`GET /v1/perps/funding_rate_history`

## Request

- Base URL: `https://api.ondoperps.xyz`
- URL: `https://api.ondoperps.xyz/v1/perps/funding_rate_history`
- Auth: none required

Get the historical funding rates for a market. For how funding is calculated and applied, see [Funding rates](/funding-rates).

## Query parameters

- `market` string, required
- `limit` integer
- `cursor` string
- `startTime` integer
- `endTime` integer

## Response `200`

Paginated list of historical funding rates, most recent first

- object
  - `success` boolean, required: Whether the request was successful
  - `error` string: Error message, present only on failure
  - `error_code` string: Semantic error code. See each endpoint's error responses for the specific codes it can return.
  - `deprecated` string: Deprecation notice, if applicable
  - `result` FundingRateValue[]
    - `market` string, required: Perps trading market
    - `time` string, date-time, required: The time funding was paid
    - `fundingRate` string, required: The funding rate as a fraction
  - `pageInfo` PageInfo
    - `prevCursor` string: Cursor value to get the previous page of results
    - `nextCursor` string: Cursor value to get the next page of results

## Other responses

- `400`: Bad request. The request was malformed or failed validation.
- `429`: Rate limit exceeded. Slow down request frequency.
- `500`: Internal server error.

---

[API](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api.md) - [All operations](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/revisions/1601c3adedda?raw)
