Funding Rates

Funding rates are the periodic payments exchanged between long and short traders on perpetual futures contracts. The Sharpe API aggregates funding rates from 13 exchanges (Binance, Bybit, OKX, Gate.io, Bitget, Hyperliquid, Deribit, BitMEX, HTX, BingX, CoinEx, KuCoin, MEXC) into a unified format through a single endpoint with a type parameter.

Get funding rates

A single endpoint that returns current snapshots, accumulated sums, or historical time series depending on the type parameter.

Query parameters

Name
type
Type
string
Description
The kind of funding rate data to return. One of current, accumulated, history. Defaults to current.
Name
coin
Type
string
Description
Asset ticker (e.g., BTC, ETH, SOL). Optional for current and accumulated. Required for history.
Name
days
Type
integer
Description
Lookback window in days for type=history. Integer from 1 to 1095. Defaults to 30. Ignored for other types.
Name
limit
Type
integer
Description
Maximum number of results per page. 1 to 5000. When provided, the response includes a pagination object with cursor-based paging.
Name
cursor
Type
string
Description
Opaque cursor for fetching the next page. Returned in the pagination.cursor field of paginated responses.

Request

GET

/v1/funding/rates

curl -G https://www.sharpe.ai/api/v1/funding/rates \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d type=current

type=current

Returns the latest funding rate snapshot for every exchange-symbol pair. Stale entries older than 6 hours are automatically excluded.

Response fields

Name
exchange
Type
string
Description
Exchange identifier (e.g., binance, bybit, okx, deribit, hyperliquid).
Name
symbol
Type
string
Description
The trading pair symbol on the exchange (e.g., BTCUSDT, ETHUSDT).
Name
base_coin
Type
string
Description
The base asset ticker (e.g., BTC, ETH).
Name
rate
Type
number
Description
The current funding rate as a decimal (e.g., 0.0001 = 0.01%).
Name
interval_hours
Type
number
Description
Hours between funding settlements (typically 8, some exchanges use 1 or 4).
Name
next_funding_time
Type
string
Description
ISO 8601 timestamp of the next scheduled funding settlement.
Name
updated_at
Type
string
Description
ISO 8601 timestamp when this rate was last refreshed.

{
  "data": [
    {
      "exchange": "binance",
      "symbol": "BTCUSDT",
      "base_coin": "BTC",
      "rate": 0.0001,
      "interval_hours": 8,
      "next_funding_time": "2026-03-27T08:00:00Z",
      "updated_at": "2026-03-27T07:45:00Z"
    },
    {
      "exchange": "bybit",
      "symbol": "BTCUSDT",
      "base_coin": "BTC",
      "rate": 0.00012,
      "interval_hours": 8,
      "next_funding_time": "2026-03-27T08:00:00Z",
      "updated_at": "2026-03-27T07:44:30Z"
    }
  ],
  "meta": {
    "request_id": "req_abc123def456ghij",
    "timestamp": "2026-03-27T07:45:00Z"
  }
}

type=accumulated

Returns pre-computed cumulative funding rate sums and settlement counts across multiple time windows. Useful for calculating net funding cost or income without aggregating history yourself.

Response fields

Name
base_coin
Type
string
Description
The base asset ticker.
Name
exchange
Type
string
Description
Exchange identifier.
Name
symbol
Type
string
Description
The trading pair symbol.
Name
acc_1d
Type
number
Description
Accumulated funding rate over the last 1 day.
Name
acc_7d
Type
number
Description
Accumulated funding rate over the last 7 days.
Name
acc_30d
Type
number
Description
Accumulated funding rate over the last 30 days.
Name
acc_90d
Type
number
Description
Accumulated funding rate over the last 90 days.
Name
acc_1y
Type
number
Description
Accumulated funding rate over the last 1 year.
Name
settlements_1d
Type
integer
Description
Number of funding settlements in the last 1 day.
Name
settlements_7d
Type
integer
Description
Number of funding settlements in the last 7 days.
Name
settlements_30d
Type
integer
Description
Number of funding settlements in the last 30 days.
Name
settlements_90d
Type
integer
Description
Number of funding settlements in the last 90 days.
Name
settlements_1y
Type
integer
Description
Number of funding settlements in the last 1 year.

Request

GET

/v1/funding/rates?type=accumulated

curl -G https://www.sharpe.ai/api/v1/funding/rates \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d type=accumulated

{
  "data": [
    {
      "base_coin": "BTC",
      "exchange": "binance",
      "symbol": "BTCUSDT",
      "acc_1d": 0.000312,
      "acc_7d": 0.002184,
      "acc_30d": 0.009360,
      "acc_90d": 0.028080,
      "acc_1y": 0.112320,
      "settlements_1d": 3,
      "settlements_7d": 21,
      "settlements_30d": 90,
      "settlements_90d": 270,
      "settlements_1y": 1095
    }
  ],
  "meta": {
    "request_id": "req_def456ghi789jklm",
    "timestamp": "2026-03-27T07:45:00Z"
  }
}

type=history

Returns a time series of individual funding rate payments for a specific coin. Use this for charting, backtesting, or building your own accumulation logic. Results are ordered by settled_at ascending.

The coin parameter is required when type=history. Omitting it returns a missing_parameter error.

Response fields

Name
exchange
Type
string
Description
Exchange identifier.
Name
rate
Type
number
Description
The funding rate at settlement time.
Name
interval_hours
Type
number
Description
Hours between funding settlements for this exchange.
Name
settled_at
Type
string
Description
ISO 8601 timestamp when the funding payment was settled.

Request

GET

/v1/funding/rates?type=history&coin=BTC

curl -G https://www.sharpe.ai/api/v1/funding/rates \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d type=history \
  -d coin=BTC \
  -d days=7

{
  "data": [
    {
      "exchange": "binance",
      "rate": 0.000095,
      "interval_hours": 8,
      "settled_at": "2026-03-20T00:00:00Z"
    },
    {
      "exchange": "binance",
      "rate": 0.000110,
      "interval_hours": 8,
      "settled_at": "2026-03-20T08:00:00Z"
    },
    {
      "exchange": "bybit",
      "rate": 0.000085,
      "interval_hours": 8,
      "settled_at": "2026-03-20T00:00:00Z"
    },
    {
      "exchange": "bybit",
      "rate": 0.000120,
      "interval_hours": 8,
      "settled_at": "2026-03-20T08:00:00Z"
    }
  ],
  "meta": {
    "request_id": "req_ghi789jkl012mnop",
    "timestamp": "2026-03-27T07:45:00Z"
  }
}

Read the error reference