---
title: "Get funding rate history"
method: GET
path: "/v1/funding/{symbol}/rates"
tags: ["Exchange"]
---

# Get funding rate history

`GET /v1/funding/{symbol}/rates`

## Request

- Base URL: `https://perp-api.phoenix.trade`
- URL: `https://perp-api.phoenix.trade/v1/funding/{symbol}/rates`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/phoenix/apis/phoenix-eternal-api/docs/v1/funding/:symbol/rates/get.ts> (a function with typed inputs; its response is checked against the schema)

Handles `GET /v1/funding/{symbol}/rates` via `get.v1.funding.by_symbol.rates`.

## Path parameters

- `symbol` string, required

## Query parameters

- `startTime` integer
- `endTime` integer
- `limit` integer

## Response `200`

Funding rate history

- FundingRateHistoryResponse: Response containing historical funding rates
  - `marketId` integer, required
  - `rates` FundingRatePoint[], required
    - `fundingRatePercentage` string, required: Funding rate applied for the interval (percentage, USD notional terms)
    - `timestamp` string, date-time, required: Formatted datetime string (ISO 8601).
  - `symbol` string, required

## Other responses

- `400`: Standard JSON error payload.
- `404`: Standard JSON error payload.
- `500`: Standard JSON error payload.

---

[API](https://skmtc.dev/phoenix/apis/phoenix-eternal-api.md) - [All operations](https://skmtc.dev/phoenix/apis/phoenix-eternal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phoenix/apis/phoenix-eternal-api/revisions/542796fe0648?raw)