---
title: "Funding rate history for a perpetual"
method: GET
path: "/v1/funding/{symbol}/history"
tags: ["Analytics"]
---

# Funding rate history for a perpetual

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

## Request

- Base URL: `https://api.metalcharts.org`
- URL: `https://api.metalcharts.org/v1/funding/{symbol}/history`
- Auth: none declared

Funding rate history for one perpetual, oldest first. Symbols are the venue's own tickers such as BTC, ETH, GOLD, SILVER, NVDA; call /v1/funding for the full list. Set the window with range (1D, 1W, 1M, 3M, 6M, 1Y, ALL) or explicit start and end dates. Requires the Pro plan or higher.

## Path parameters

- `symbol` string, required

## Query parameters

- `exchange` string
- `range` string: One of 1D, 1W, 1M, 3M, 6M, 1Y or ALL. Defaults to 1M. ALL returns the whole series, and MAX is accepted as a synonym for it.
- `start` string
- `end` string

## Response `200`

Success.

- object
  - `success` boolean, required
  - `symbol` string
  - `range` string
  - `count` number
  - `data` object[], required
    - `exchange` string
    - `fundingRate` number
    - `premium` number
    - `symbol` string
    - `time` string, date-time

## Other responses

- `400`: Invalid parameter.

---

[API](https://skmtc.dev/metalcharts/apis/metalcharts-api.md) · [All operations](https://skmtc.dev/metalcharts/apis/metalcharts-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metalcharts/apis/metalcharts-api/revisions/53d6a0af0479?raw)