curl --request GET \
--url https://www.sharpe.ai/api/v1/futures/data \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.sharpe.ai/api/v1/futures/data', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://www.sharpe.ai/api/v1/futures/data"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"chart": "perp-dislocation",
"coin": "<string>",
"timeframe": "1W",
"data": [
{
"exchange": "<string>",
"base_coin": "<string>",
"open_interest_value": 123,
"timestamp": "2023-11-07T05:31:56Z",
"_type": "funding"
}
],
"coverage": {
"availableSince": "2023-11-07T05:31:56Z",
"availableTimeframes": [
"1W"
],
"status": "full",
"availableUntil": "2023-11-07T05:31:56Z",
"pointCount": 123,
"warnings": [
"<string>"
]
},
"source": "supabase",
"openInterestExcludedVenues": [
{
"exchange": "<string>",
"reason": "<string>"
}
],
"pagination": {
"cursor": "<string>",
"has_more": true,
"total": 1
},
"summary": {
"oi_total_usd": 123,
"oi_venue_count": 123,
"oi_as_of": "2023-11-07T05:31:56Z",
"oi_excluded_venues": [
{
"exchange": "<string>",
"reason": "<string>"
}
],
"oi_null_reason": "<string>"
}
},
"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
}
}Futures chart data
Returns time-series data for a specific futures chart. Supports open interest (one-sided USD notional per venue), volume, funding rate history, liquidations, long/short ratios, basis, term structure, OHLCV, and more. A database read that fails before returning any row answers 503 (Retry-After) rather than an empty dataset; one that fails part-way returns the rows it has, with coverage.status “partial”, coverage.warnings and an X-Data-Partial header. chart=cvd serves OHLCV candle rows with the CVD precomputed: each candle with a taker volume carries cvd_delta_usd ((2 * taker_buy_volume - volume) * close) and cvd_usd, the running sum per venue from the first candle in the window (Binance only today; coverage.warnings names the venues without one). returns-session, returns-heatmap, returns-hour and returns-day serve the raw 1h candles of the highest-volume venue (the averages are computed by the client). Composite charts (perp-dislocation, funding-cost, crowding-risk, flow-confirmation, carry-curve) serve their raw input rows tagged with _type. Liquidation quantity is USD notional.
curl --request GET \
--url https://www.sharpe.ai/api/v1/futures/data \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.sharpe.ai/api/v1/futures/data', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://www.sharpe.ai/api/v1/futures/data"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"chart": "perp-dislocation",
"coin": "<string>",
"timeframe": "1W",
"data": [
{
"exchange": "<string>",
"base_coin": "<string>",
"open_interest_value": 123,
"timestamp": "2023-11-07T05:31:56Z",
"_type": "funding"
}
],
"coverage": {
"availableSince": "2023-11-07T05:31:56Z",
"availableTimeframes": [
"1W"
],
"status": "full",
"availableUntil": "2023-11-07T05:31:56Z",
"pointCount": 123,
"warnings": [
"<string>"
]
},
"source": "supabase",
"openInterestExcludedVenues": [
{
"exchange": "<string>",
"reason": "<string>"
}
],
"pagination": {
"cursor": "<string>",
"has_more": true,
"total": 1
},
"summary": {
"oi_total_usd": 123,
"oi_venue_count": 123,
"oi_as_of": "2023-11-07T05:31:56Z",
"oi_excluded_venues": [
{
"exchange": "<string>",
"reason": "<string>"
}
],
"oi_null_reason": "<string>"
}
},
"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
Futures chart identifier.
perp-dislocation, funding-cost, crowding-risk, flow-confirmation, carry-curve, perpetual-price, liquidations, oi-stacked, oi-change, oi-daily-change, oi-snapshot, oi-volume, volume-snapshot, volume-history, cvd, long-short-ratio, funding-rate, top-trader-ls, returns-session, returns-heatmap, returns-hour, returns-day, annualized-basis, term-structure 
