curl --request GET \
--url https://www.sharpe.ai/api/v1/funding/settlement \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.sharpe.ai/api/v1/funding/settlement', 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/settlement"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"rows": [
{
"base_coin": "<string>",
"asset_class": "crypto",
"open_interest_usd": 123,
"windows": {
"current": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"1d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"3d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"7d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
}
},
"venues": [
{
"exchange": "<string>",
"open_interest_usd": 123,
"windows": {
"current": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"1d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"3d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"7d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
}
},
"excluded_from_totals": "<string>"
}
]
}
],
"totals": {
"current": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"1d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"3d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"7d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
}
},
"settlementMeta": {
"class": "all",
"coins": 123,
"updated_at": "2023-11-07T05:31:56Z",
"total": 123,
"limit": 123,
"offset": 123,
"oi_excluded_venues": [
{
"exchange": "<string>",
"reason": "<string>"
}
]
},
"pagination": {
"cursor": "<string>",
"has_more": true,
"total": 1
}
},
"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 fee settlement
Returns how many dollars actually changed hands at funding settlement, and which side paid it. fee_usd = open_interest_usd x rate, priced at the one-sided open interest (each contract counted once, the side that pays) recorded at or before each settlement. current is the next 24 hours at current rates (each contract’s forward rate x 24 / its own interval hours), computed live; 1d/3d/7d are realised windows from a materialized view. Every window reports both long_paid and short_paid alongside net, and the totals block reconciles: the five classes (crypto, equity, commodity, fx, index), and crypto + rwa, each sum to all. Venues in settlementMeta.oi_excluded_venues are priced per venue (venues[].excluded_from_totals) but left out of every coin row and the totals.
curl --request GET \
--url https://www.sharpe.ai/api/v1/funding/settlement \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.sharpe.ai/api/v1/funding/settlement', 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/settlement"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"rows": [
{
"base_coin": "<string>",
"asset_class": "crypto",
"open_interest_usd": 123,
"windows": {
"current": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"1d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"3d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"7d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
}
},
"venues": [
{
"exchange": "<string>",
"open_interest_usd": 123,
"windows": {
"current": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"1d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"3d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"7d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
}
},
"excluded_from_totals": "<string>"
}
]
}
],
"totals": {
"current": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"1d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"3d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
},
"7d": {
"net": 123,
"long_paid": 1,
"short_paid": 1,
"estimated": true,
"rate_source": "predicted",
"coverage_ratio": 0.5,
"partial": true,
"complete": true,
"listed_within_window": true,
"halted_within_window": true
}
},
"settlementMeta": {
"class": "all",
"coins": 123,
"updated_at": "2023-11-07T05:31:56Z",
"total": 123,
"limit": 123,
"offset": 123,
"oi_excluded_venues": [
{
"exchange": "<string>",
"reason": "<string>"
}
]
},
"pagination": {
"cursor": "<string>",
"has_more": true,
"total": 1
}
},
"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
Settlement window. current is the next 24 hours of funding at current rates (each contract's forward rate x 24 / its own interval hours, priced live off open interest) and labelled estimated. 1d/3d/7d are realised windows from the funding_fee_settlement matview.
current, 1d, 3d, 7d Asset-class scope, the same categories as the funding board: all, crypto, equity, commodity, fx or index (one asset_class each). rwa is every non-crypto class at once (equity + commodity + fx + index). In the totals block the five classes, and crypto + rwa, reconcile exactly to all.
all, crypto, equity, commodity, fx, index, rwa Filter to coins settling on a single venue. Accepts the slug, the display name as returned in the venues[].exchange field, 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. Implies the per-venue breakdown internally; the response still omits venues unless expand=venues is also set.
32Sort field for the selected window, optionally prefixed with "-" for descending. Rows with no value for the sort field (an unpriced coin) always sort last, regardless of direction.
base_coin, net, long_paid, short_paid, open_interest_usd, -base_coin, -net, -long_paid, -short_paid, -open_interest_usd 
