---
title: "Funding rates history (daily snapshots)"
method: GET
path: "/api/public/funding-rates-history"
---

# Funding rates history (daily snapshots)

`GET /api/public/funding-rates-history`

## Request

- Base URL: `https://cryptowhaleinsights.com`
- URL: `https://cryptowhaleinsights.com/api/public/funding-rates-history`
- Auth: none declared

Returns the daily historical perpetual futures funding rate for a single token over the last N days (default 30, max 180). Rates are sourced from Gate.io, MEXC, and Kraken, recorded once per day from the live 5-min funding-rate cycle. Top 10 tokens by volume are snapshotted: BTC, ETH, SOL, BNB, XRP, DOGE, ADA, AVAX, LINK, DOT. Each day includes per-exchange rates (gateio/mexc/kraken) plus a derived avg and sentiment label. Sentiment: avg > 0.05% = bearish (leveraged longs paying shorts → market top signal); avg < -0.01% = bullish (shorts paying longs → market bottom signal); otherwise neutral. Use ?symbol=BTC&days=30 (symbol defaults to BTC; days is 1–180). Cold-start days with no data are omitted. Cached 5min.

## Query parameters

- `symbol` string
- `days` integer

## Response `200`

Daily funding rate history for the requested symbol.

- object
  - `symbol` string
  - `days` number
  - `history` object[]
    - `date` string, date: Snapshot date (YYYY-MM-DD, UTC).
    - `gateio` number, nullable: Gate.io funding rate in % (e.g. 0.01 = 0.01% per 8h). Null when unavailable.
    - `mexc` number, nullable: MEXC funding rate in %. Null when unavailable.
    - `kraken` number, nullable: Kraken funding rate in %. Null when unavailable.
    - `avg` number: Average across available exchanges.
    - `sentiment` 'bullish' | 'bearish' | 'neutral': Market sentiment derived from avg: >0.05% bearish (top signal), <-0.01% bullish (bottom signal).
  - `total` number
  - `updatedAt` string, date-time
  - `attribution` Attribution: Source attribution returned on every response. Cite CryptoWhaleInsights when using this data.
    - `source` string
    - `url` string, uri
    - `poweredBy` string
    - `usagePolicy` string, uri

## Other responses

- `429`: Rate limit exceeded (120 req/min per endpoint per IP). Includes a Retry-After header. See https://cryptowhaleinsights.com/api-usage
- `500`: Upstream/provider error — returns a safe empty payload or an error message.

---

[API](https://skmtc.dev/cryptowhaleinsights/apis/cryptowhaleinsights-public-api.md) · [All operations](https://skmtc.dev/cryptowhaleinsights/apis/cryptowhaleinsights-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptowhaleinsights/apis/cryptowhaleinsights-public-api/revisions/50f9a64c334e?raw)