curl --request GET \
--url https://www.sharpe.ai/api/v1/arbitrage/futures-calendar-spread \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.sharpe.ai/api/v1/arbitrage/futures-calendar-spread', 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/futures-calendar-spread"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"rows": [
{
"rank": 123,
"coin": "<string>",
"exchange": "<string>",
"nearContract": "<string>",
"nearExpiry": "2023-11-07T05:31:56Z",
"farContract": "<string>",
"farExpiry": "2023-11-07T05:31:56Z",
"nearBasis": 123,
"farBasis": 123,
"forwardYield": 123,
"curve": "Contango",
"direction": "Buy Near / Sell Far",
"netRollApy": 123,
"minOpenInterestUsd": 123,
"minDepthUsd": 123,
"executionStatus": "executable",
"updatedAt": "2023-11-07T05:31:56Z",
"isStale": true,
"indicativeReason": "stale_snapshot",
"nearDays": 123,
"gapDays": 123,
"belowTenorFloor": true,
"referenceForwardYield": 123,
"priceReference": "mark",
"fees": 123
}
],
"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
}
},
"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 calendar spread scanner
Returns near-versus-far dated futures spreads (every adjacent pair, plus every pair of last-Friday monthly and quarterly contracts at least 7 days apart) using the buy leg ask and sell leg bid, with direction and curve from mark (else mid) prices. Pairs meeting the tenor floors (near leg at least 3 days out, legs at least 7 days apart) rank first; within them executable pairs that clear their fees, then such pairs executable on a live read (snapshot_quote), then the rest, each by signed post-fee net roll APY.
curl --request GET \
--url https://www.sharpe.ai/api/v1/arbitrage/futures-calendar-spread \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.sharpe.ai/api/v1/arbitrage/futures-calendar-spread', 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/futures-calendar-spread"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"rows": [
{
"rank": 123,
"coin": "<string>",
"exchange": "<string>",
"nearContract": "<string>",
"nearExpiry": "2023-11-07T05:31:56Z",
"farContract": "<string>",
"farExpiry": "2023-11-07T05:31:56Z",
"nearBasis": 123,
"farBasis": 123,
"forwardYield": 123,
"curve": "Contango",
"direction": "Buy Near / Sell Far",
"netRollApy": 123,
"minOpenInterestUsd": 123,
"minDepthUsd": 123,
"executionStatus": "executable",
"updatedAt": "2023-11-07T05:31:56Z",
"isStale": true,
"indicativeReason": "stale_snapshot",
"nearDays": 123,
"gapDays": 123,
"belowTenorFloor": true,
"referenceForwardYield": 123,
"priceReference": "mark",
"fees": 123
}
],
"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
}
},
"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
