curl --request GET \
--url https://www.sharpe.ai/api/v1/arbitrage/dated-futures-basis \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.sharpe.ai/api/v1/arbitrage/dated-futures-basis', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://www.sharpe.ai/api/v1/arbitrage/dated-futures-basis"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"rows": [
{
"rank": 123,
"coin": "<string>",
"spotVenue": "<string>",
"futuresVenue": "<string>",
"contract": "<string>",
"expiry": "2023-11-07T05:31:56Z",
"days": 123,
"spotAsk": 123,
"futureBid": 123,
"basisUsd": 123,
"basis": 123,
"annualizedBasis": 123,
"netApr": 123,
"volume24hUsd": 123,
"openInterestUsd": 123,
"oiToVolume": 123,
"depthUsd": 123,
"executionStatus": "executable",
"fees": 123,
"marginType": "linear",
"updatedAt": "2023-11-07T05:31:56Z",
"isStale": true,
"indicativeReason": "stale_snapshot",
"nearExpiry": true
}
],
"scannerMeta": {
"kind": "dated-futures-basis",
"status": "ok",
"generatedAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"stale": true,
"freshnessSlaSeconds": 123,
"source": "supabase",
"notionalUsd": 123,
"rowCount": 123,
"supportedCoins": [
"<string>"
],
"warnings": [
"<string>"
],
"transferScan": {
"coinsScanned": 123,
"scannedCoins": [
"<string>"
],
"venuesAnswering": 123,
"venues": [
{
"exchange": "<string>",
"status": "ok"
}
],
"routesEvaluated": 123,
"routesProfitable": 123,
"bestNetReturn": 123
}
},
"pagination": {
"cursor": "<string>",
"has_more": true,
"total": 1
},
"aggregate": [
{
"coin": "<string>",
"totalOpenInterestUsd": 123,
"oiWeightedApr": 123,
"bestVenue": "<string>",
"bestApr": 123,
"contractCount": 123
}
]
},
"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
}
}Dated futures basis scanner
Returns cash-and-carry rows priced at spot ask and futures bid across Binance, OKX and Bybit (Deribit has no spot leg, so it appears only in calendar spreads). Rows at least 3 days from expiry rank first; within them executable rows at the requested notional, then rows executable on a live read (snapshot_quote), then the rest, each by fee-adjusted net APR. Reference-only rows are omitted. Days to expiry are recomputed from the expiry on every request. The per-coin aggregate covers only contracts at least three days from expiry.
curl --request GET \
--url https://www.sharpe.ai/api/v1/arbitrage/dated-futures-basis \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.sharpe.ai/api/v1/arbitrage/dated-futures-basis', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://www.sharpe.ai/api/v1/arbitrage/dated-futures-basis"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"rows": [
{
"rank": 123,
"coin": "<string>",
"spotVenue": "<string>",
"futuresVenue": "<string>",
"contract": "<string>",
"expiry": "2023-11-07T05:31:56Z",
"days": 123,
"spotAsk": 123,
"futureBid": 123,
"basisUsd": 123,
"basis": 123,
"annualizedBasis": 123,
"netApr": 123,
"volume24hUsd": 123,
"openInterestUsd": 123,
"oiToVolume": 123,
"depthUsd": 123,
"executionStatus": "executable",
"fees": 123,
"marginType": "linear",
"updatedAt": "2023-11-07T05:31:56Z",
"isStale": true,
"indicativeReason": "stale_snapshot",
"nearExpiry": true
}
],
"scannerMeta": {
"kind": "dated-futures-basis",
"status": "ok",
"generatedAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"stale": true,
"freshnessSlaSeconds": 123,
"source": "supabase",
"notionalUsd": 123,
"rowCount": 123,
"supportedCoins": [
"<string>"
],
"warnings": [
"<string>"
],
"transferScan": {
"coinsScanned": 123,
"scannedCoins": [
"<string>"
],
"venuesAnswering": 123,
"venues": [
{
"exchange": "<string>",
"status": "ok"
}
],
"routesEvaluated": 123,
"routesProfitable": 123,
"bestNetReturn": 123
}
},
"pagination": {
"cursor": "<string>",
"has_more": true,
"total": 1
},
"aggregate": [
{
"coin": "<string>",
"totalOpenInterestUsd": 123,
"oiWeightedApr": 123,
"bestVenue": "<string>",
"bestApr": 123,
"contractCount": 123
}
]
},
"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
Minimum of the board's net figure, as a fraction (0.05 is 5%): netApr on the dated basis board, netRollApy on the calendar board, netCarryApr (the fee-adjusted annualized net carry, not the edge to expiry) on the perp-dated carry board, netReturn (per trip, not annualized) on the CEX transfer board.
Position notional in USD. On the dated-futures basis, calendar-spread and perp-dated carry scanners a row is executable only when its book depth (level 1 on the stored snapshot; on a live read a top-20 walk where level 1 is thin, the side then priced at that walk's VWAP), any reported open interest and its 24h volume are at least this notional (and its quotes are at most 10 minutes old). The CEX spot transfer scanner sizes its order-book fills with it.
0 < x <= 1000000000
