Reports
Three reports rendered as markdown on the server: the market briefing, one coin's analysis, and the funding-arbitrage opportunities. Each is composed on the server from the read models of the endpoints documented elsewhere in this reference (not an HTTP call), read with the queries listed below, and every number it prints is a field those routes serve. The MCP tools market_briefing, analyze_coin and find_opportunities print report_md exactly as these endpoints serve it.
A report is never an error because one of its reads failed: that section says the data is unavailable and a **Data gaps:** line names the read and why. The report closes with the freshness of every answer it read (**Data freshness:**). Only when every read fails does the endpoint answer 503. The report endpoints need an API key from a paid plan.
The report object
Every report endpoint answers one object as its data.
- Name
report- Type
- string
- Description
Which report:
briefing,coin-analysisoropportunities.
- Name
coin- Type
- string
- Description
The ticker the coin analysis covers, upper-cased. Coin analysis only.
- Name
report_md- Type
- string
- Description
The report as markdown. It ends with the freshness of each answer it read and, when a read failed, a
**Data gaps:**line.
- Name
inputs- Type
- object[]
- Description
The reads the report was composed from, in its order: each read's
label, theendpointit read, itsquery, the answer'sdataset_id,as_of,freshness_statusandruntime_status, and theerrorit printed underData gaps(nullwhen it answered).
meta carries the most cautious freshness of the inputs: the oldest as_of, the earliest stale_after, the worst freshness_status, and runtime_status: "degraded" when a read failed or came back degraded (such a report is never cached).
Get the market briefing
Total market cap, 24h volume, BTC dominance and the Fear & Greed Index; the top 5 and bottom 3 narratives by 24h change as the API ranks them; the funding book's highest and lowest markets by 8h-equivalent rate among fresh markets with at least $1M of open interest, printed as APR; and the whole market's funding estimated over the next 24 hours at current rates. No query parameters.
Reads the data behind /v1/tracker/market-overview, /v1/narratives/data with sort=-return24h&top=5&bottom=3, /v1/funding/rates with type=current&extremes=3&min_oi_usd=1000000, and /v1/funding/settlement with window=current.
Request
curl https://www.sharpe.ai/api/v1/briefing \
-H "Authorization: Bearer sk_live_your_key_here"
Response
{
"data": {
"report": "briefing",
"report_md": "## Market Briefing\n\n### Market Stats\n**Total Market Cap:** $2.86T\n...",
"inputs": [
{
"label": "market-overview",
"endpoint": "tracker-market-overview",
"query": {},
"dataset_id": "sectors",
"as_of": "2026-09-29T02:04:33.792Z",
"freshness_status": "fresh",
"runtime_status": "ok",
"error": null
}
]
},
"meta": {
"request_id": "req_abc123def456ghij",
"timestamp": "2026-09-29T02:23:10Z",
"elapsed_ms": 48,
"dataset_id": "funding_rates_current",
"freshness_status": "fresh",
"runtime_status": "ok"
}
}
Get a coin's analysis
One coin's price-prediction score and signals (when its asset is in the prediction coverage list), headed by the price and 24h change from the global board (refreshed every 10 minutes, with its as-of; the prediction's own as-of follows its score, and the prediction snapshot's price stands in only when the board has none); its current funding on its 10 largest markets by open interest, each labelled with what the venue's rate is (rate_kind: on most venues the estimate of the next payment, not yet charged), with the average and median across venues; the asset's open-interest total from the global board in USD notional, its 1h and 24h change printed beside the 24h price change (USD open interest moves with price); and the dollars its funding is estimated to move over the next 24 hours at current rates, with the contract spellings of the asset that figure leaves out.
Path parameters
- Name
coin- Type
- string
- Description
Coin ticker, any case:
BTC,eth,1000PEPE. The funding reads resolve it to its asset (PEPE brings its 1000PEPE and KPEPE contracts); the prediction is matched in the coverage list by the asset the funding read resolved (bitcoinis BTC), else by ticker, never by a guessed slug. The settlement read matches the ticker as written; the report names the asset's other spellings it leaves out. 1 to 64 characters, else400 invalid_parameter.
Reads the data behind /v1/price-prediction/data (the coverage list), /v1/funding/rates with type=current&coin=<COIN> and sort=-open_interest, then summary=1, /v1/global/overview, and /v1/funding/settlement with coin=<COIN>&window=current.
Request
curl https://www.sharpe.ai/api/v1/coins/BTC/analysis \
-H "Authorization: Bearer sk_live_your_key_here"
Response
{
"data": {
"report": "coin-analysis",
"coin": "BTC",
"report_md": "## BTC Analysis\n\n**Price (as of 2026-09-29 02:05Z):** $83,469.00 | **24h:** -1.08%\n...",
"inputs": []
},
"meta": {
"request_id": "req_abc123def456ghij",
"timestamp": "2026-09-29T02:23:10Z",
"elapsed_ms": 48,
"dataset_id": "funding_rates_current",
"freshness_status": "fresh",
"runtime_status": "ok"
}
}
Get the arbitrage opportunities
The top 10 spot-perp basis trades (perp legs with at least $1M of open interest) and the top 10 cross-exchange funding pairs (both legs with at least $1M of open interest and 24h volume), each in its board's order with its gross and fee-adjusted net APR and status flags, and the funding book's market stats (mean and OI-weighted APR, markets paying each way). The spot-perp section says how many board rows are executable and marks open interest on a venue the API leaves out of its totals (MEXC) as unverified; a cross-exchange row prints its funding spread (netFundingRate per intervalHours) apart from its entry gap (spreadRate, negative = favourable). No query parameters.
Reads the data behind /v1/arbitrage/spot-perp with exchange=all&direction=all&minOiUsd=1000000, /v1/arbitrage/cross-exchange with minOiUsd=1000000&minVolUsd=1000000&limit=10, and /v1/funding/rates with type=current&stats=1.
Request
curl https://www.sharpe.ai/api/v1/opportunities \
-H "Authorization: Bearer sk_live_your_key_here"