curl --request GET \
--url https://www.sharpe.ai/api/v1/arbitrage/perp-dated-carry \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.sharpe.ai/api/v1/arbitrage/perp-dated-carry', 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/perp-dated-carry"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"rows": [
{
"rank": 123,
"coin": "<string>",
"perpVenue": "<string>",
"datedVenue": "<string>",
"datedContract": "<string>",
"expiry": "2023-11-07T05:31:56Z",
"days": 123,
"perpFundingApr": 123,
"expectedFundingToExpiry": 123,
"datedBasis": 123,
"carryEdge": 123,
"netCarryEdge": 123,
"grossCarryApr": 123,
"netCarryApr": 123,
"bestLeg": "Perp Carry",
"nextFunding": "2023-11-07T05:31:56Z",
"executableDepthUsd": 123,
"minOpenInterestUsd": 123,
"oiDepthUsd": 123,
"executionStatus": "executable",
"updatedAt": "2023-11-07T05:31:56Z",
"isStale": true,
"indicativeReason": "stale_snapshot",
"direction": "Long perp / Short dated",
"crossVenue": true,
"nearExpiry": true,
"funding7dApr": 123,
"funding7dCumulative": 123,
"fundingProjection": "7d_average",
"fundingIntervalHours": 123,
"fundingSettlementsToExpiry": 123,
"datedLegPrice": 123,
"perpLegPrice": 123,
"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
}
}Perp versus dated futures carry scanner
Returns perp-versus-dated carry rows: the dated contract’s basis against the perp at the chosen trade’s executable sides, against the funding the perp is expected to pay to expiry (the 7-day realised average; the current print under 3 days), with fee-adjusted annualized net carry used for filtering and ranking. Rows at least 3 days from expiry rank first; within them executable rows, then rows executable on a live read (snapshot_quote), then the rest. The perp and dated legs are often on different venues (crossVenue): separate accounts and collateral.
curl --request GET \
--url https://www.sharpe.ai/api/v1/arbitrage/perp-dated-carry \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.sharpe.ai/api/v1/arbitrage/perp-dated-carry', 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/perp-dated-carry"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"rows": [
{
"rank": 123,
"coin": "<string>",
"perpVenue": "<string>",
"datedVenue": "<string>",
"datedContract": "<string>",
"expiry": "2023-11-07T05:31:56Z",
"days": 123,
"perpFundingApr": 123,
"expectedFundingToExpiry": 123,
"datedBasis": 123,
"carryEdge": 123,
"netCarryEdge": 123,
"grossCarryApr": 123,
"netCarryApr": 123,
"bestLeg": "Perp Carry",
"nextFunding": "2023-11-07T05:31:56Z",
"executableDepthUsd": 123,
"minOpenInterestUsd": 123,
"oiDepthUsd": 123,
"executionStatus": "executable",
"updatedAt": "2023-11-07T05:31:56Z",
"isStale": true,
"indicativeReason": "stale_snapshot",
"direction": "Long perp / Short dated",
"crossVenue": true,
"nearExpiry": true,
"funding7dApr": 123,
"funding7dCumulative": 123,
"fundingProjection": "7d_average",
"fundingIntervalHours": 123,
"fundingSettlementsToExpiry": 123,
"datedLegPrice": 123,
"perpLegPrice": 123,
"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
