curl --request GET \
--url https://www.sharpe.ai/api/v1/funding/rates \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.sharpe.ai/api/v1/funding/rates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://www.sharpe.ai/api/v1/funding/rates"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"exchange": "<string>",
"symbol": "<string>",
"base_coin": "<string>",
"rate": 123,
"interval_hours": 123,
"next_funding_time": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"margin_type": "linear",
"asset_class": "crypto",
"mark_price": 123,
"mark_price_updated_at": "2023-11-07T05:31:56Z",
"open_interest": 123,
"market_cap_rank": 123,
"age_seconds": 123,
"data_source": "<string>",
"freshness_sla_seconds": 123,
"is_stale": true,
"predicted_rate": 123,
"asset_id": "<string>",
"asset_symbol": "<string>",
"lot_multiplier": 123,
"instrument_status": "trading",
"is_live": true,
"rate_8h": 123,
"apr": 123,
"rate_kind": "estimate"
}
],
"meta": {
"request_id": "req_a1b2c3d4e5f6g7h8i9j0",
"timestamp": "2023-11-07T05:31:56Z",
"elapsed_ms": 1,
"dataset_id": "funding_rates_current",
"as_of": "2023-11-07T05:31:56Z",
"stale_after": "2023-11-07T05:31:56Z",
"freshness_sla_seconds": 123,
"freshness_status": "fresh",
"runtime_status": "ok",
"served_from": "snapshot",
"generated_at": "2023-11-07T05:31:56Z",
"source": [
"<string>"
],
"coverage": {
"expected": 123,
"used": 123,
"dropped": {},
"missing": [
"<string>"
]
},
"warnings": [
"<string>"
],
"truncated": true
}
}Funding rates
Returns perpetual funding rates across all supported exchanges. Supports current snapshots, accumulated rates over multiple windows, and per-coin historical rates.
curl --request GET \
--url https://www.sharpe.ai/api/v1/funding/rates \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.sharpe.ai/api/v1/funding/rates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://www.sharpe.ai/api/v1/funding/rates"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"exchange": "<string>",
"symbol": "<string>",
"base_coin": "<string>",
"rate": 123,
"interval_hours": 123,
"next_funding_time": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"margin_type": "linear",
"asset_class": "crypto",
"mark_price": 123,
"mark_price_updated_at": "2023-11-07T05:31:56Z",
"open_interest": 123,
"market_cap_rank": 123,
"age_seconds": 123,
"data_source": "<string>",
"freshness_sla_seconds": 123,
"is_stale": true,
"predicted_rate": 123,
"asset_id": "<string>",
"asset_symbol": "<string>",
"lot_multiplier": 123,
"instrument_status": "trading",
"is_live": true,
"rate_8h": 123,
"apr": 123,
"rate_kind": "estimate"
}
],
"meta": {
"request_id": "req_a1b2c3d4e5f6g7h8i9j0",
"timestamp": "2023-11-07T05:31:56Z",
"elapsed_ms": 1,
"dataset_id": "funding_rates_current",
"as_of": "2023-11-07T05:31:56Z",
"stale_after": "2023-11-07T05:31:56Z",
"freshness_sla_seconds": 123,
"freshness_status": "fresh",
"runtime_status": "ok",
"served_from": "snapshot",
"generated_at": "2023-11-07T05:31:56Z",
"source": [
"<string>"
],
"coverage": {
"expected": 123,
"used": 123,
"dropped": {},
"missing": [
"<string>"
]
},
"warnings": [
"<string>"
],
"truncated": true
}
}Authorizations
Query Parameters
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.
64Filter 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.
32Narrow 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.
crypto, equity, commodity, fx, index 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.
linear, inverse 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).
open_interest, -open_interest 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.
1 <= x <= 100type=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.
1 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.
1 
