---
title: "Get Aggregated Funding Rates"
method: GET
path: "/v1/funding-rates/aggregated"
tags: ["Market Data"]
---

# Get Aggregated Funding Rates

`GET /v1/funding-rates/aggregated`

## Request

- Base URL: `https://api.candlefeed.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.candlefeed.ai/v1/funding-rates/aggregated`
- Auth: API key in header `X-API-Key`

OI-weighted aggregated funding rate across exchanges.

For each ``(timestamp bucket, symbol)`` we compute::

    weighted_funding = Σ(funding_i × oi_value_i) / Σ(oi_value_i)

over exchanges where both the per-exchange funding rate and the per-exchange
open-interest USD value are non-null and OI > 0. Buckets where total OI is
zero or where no exchange has both data points are dropped.

Requires Builder or above (Free gets the dataset wall). Builder is Binance-only: without an
`exchanges` filter it gets Binance alone, and naming any other venue is a 403 offering Advanced.
`meta.exchanges` lists the venues the query was limited to (null: all).

## Query parameters

- `symbol` string, required: Trading pair symbol
- `interval` string: Bucket interval (1h, 4h, 1d)
- `start` string, nullable: Start time (ISO 8601)
- `end` string, nullable: End time (ISO 8601)
- `exchanges` string, nullable: Comma-separated exchange filter. Default: all available venues on Advanced and above, Binance only on Builder. Builder can't request other venues.
- `limit` integer, nullable: Max rows to return
- `cursor` string, nullable: Pagination cursor

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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