Skip to main content
GET
Funding rates

Authorizations

Authorization
string
header
required

Pass your API key as a Bearer token in the Authorization header: Authorization: Bearer sk_live_...

Query Parameters

type
enum<string>
default:current

Type of funding rate data to retrieve.

Available options:
current,
accumulated,
history
coin
string

The coin to return: a ticker (e.g. BTC), a lot or venue spelling (e.g. 1000PEPE, kPEPE), or the full name (e.g. bitcoin, resolved to BTC). Case-insensitive, one coin per request. coin names an asset, not a base_coin string: every contract of that asset is returned whatever its base_coin spelling, so PEPE also returns the 1000PEPE and KPEPE lot contracts (read lot_multiplier), and a ticker two assets share (BB is BounceBit and BlackBerry) returns both, narrowed by asset_class. Optional filter for type=current and type=accumulated; required when type=history. A value that no perpetual in the funding book has ever settled returns 400 rather than an empty result set; GET /api/funding/coins lists every ticker carried.

Maximum string length: 64
days
integer
default:30

Number of days of history to retrieve (type=history only).

Required range: 1 <= x <= 1095
exchange
string

Filter to a single venue. Accepts the slug (e.g. gate-io), the display name as returned in the exchange field (e.g. Gate.io), or the ccxt id. The venue registry is not frozen, so read the sharpe://exchanges MCP resource or /api/funding/rates for the current list. An unrecognized value returns 400.

Maximum string length: 32
asset_class
enum<string>

Narrow the response to one underlying category. The funding book is not crypto-only. Tokenized equity, commodity, index and FX perps trade on the same venues, so this is unfiltered by default. Applies to type=current and type=accumulated; ignored for type=history. An unrecognized value returns 400.

Available options:
crypto,
equity,
commodity,
fx,
index
margin
enum<string>

Narrow the response to one collateral convention: linear for quote-margined contracts, inverse for coin-margined ones. Unfiltered by default. Applies to type=current and type=accumulated; ignored for type=history. An unrecognized value returns 400.

Available options:
linear,
inverse
limit
integer

Maximum number of records to return per page.

Required range: 1 <= x <= 5000
cursor
string

Opaque pagination cursor from a previous response.

sort
enum<string>

type=current only: order the rows by open_interest, ascending, or descending with the leading -. Rows with unknown open interest come last either way. Applied before limit/cursor. Default: the book's order (base_coin, exchange, symbol).

Available options:
open_interest,
-open_interest
extremes
integer

type=current only: answer with the N highest and N lowest rows by rate_8h (extremes.highest, extremes.lowest) among fresh rows with a usable interval, and how many rows each check left out (extremes.omitted). The other filters narrow the rows first. Returns an object instead of rows; cannot be combined with limit, cursor or sort.

Required range: 1 <= x <= 100
min_oi_usd
number

type=current, with extremes only: leave out rows whose open interest in USD is below this floor. A row with unknown open interest fails a floor above 0.

Required range: x >= 0
stats
enum<string>

type=current only: 1 answers with the whole book's funding (market: mean and open-interest-weighted APR, the count of positive and negative rates, and how many of the tracked venues have a fresh contract). Returns an object instead of rows; cannot be combined with coin, exchange, margin, asset_class, limit, cursor or sort.

Available options:
1
summary
enum<string>

type=current or type=accumulated, with coin only: 1 answers with the coin's funding across venues (summary) instead of the rows. For type=current: the average and median 8-hour rate, how they were reduced, the venues behind them, the open interest of every contract and the next settlement. For type=accumulated, per window: the median realised funding and the median APR over the venues whose history covers the window, and the carry spread APR (best short venue minus best long venue). Returns an object instead of rows; cannot be combined with limit, cursor or sort.

Available options:
1
format
enum<string>
default:json

Response format. When set to "csv", the response Content-Type is text/csv instead of JSON.

Available options:
json,
csv

Response

Funding rates returned successfully.

data
object[]
required

Endpoint-specific response payload. See the operation response schema.

meta
object
required