Contest by full ticker
const url = 'https://api.cotes.ai/v1/contests/KXBTC15M-26AUG061600-00';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.cotes.ai/v1/contests/KXBTC15M-26AUG061600-00 \ --header 'Authorization: Bearer <token>'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Full contest ticker as the venue issues it, trailing suffix included, e.g. KXBTC15M-26AUG061600-00. Opaque — take it from a Contest.ticker rather than constructing one; a truncated ticker returns 404.
Example
KXBTC15M-26AUG061600-00Responses
Section titled “Responses”Contest (live or settled)
object
Series prefix of the ticker, as passed in the series query parameter.
The underlying asset this contest is on: BTC, ETH, SOL or XRP for the catalog series. A recorded series outside the catalog reports its own asset, such as GOLD for KXGOLD15M.
object
Strike / to-beat price of the contest’s own asset in USD, if known. The scale follows the asset: tens of thousands for BTC, a few dollars with fractions of a cent for XRP.
Oracle settled underlying price (expiration value) in USD once the contest is settled; null while live or if the oracle did not report it.
All Cotes AI signals for this contest (consumers apply their own thresholds).
object
Contest ticker this signal belongs to (same as parent Contest.ticker).
Model probability on side (0–100).
Venue quote for side on the 0–100¢ scale ($0.54 → 54). Same denomination as edge_cents.
Confidence − entry_price_cents. Signed probability points, not settlement money.
Version tag of the model that produced this reading. Stable across a model’s life and changes only when a new model is deployed, so it groups readings by the model behind them. Null on readings stored before the tag was recorded.
Whether SpectralEdge showed this reading as a signal: it cleared the platform’s confidence, edge and distance-from-strike thresholds in force when it was raised. Readings that did not fire are still listed.
Example
{ "series": "KXBTC15M", "asset": "BTC", "state": "live", "settled_side": "up", "signals": [ { "side": "up", "outcome": "pending", "model_version": "c5456da6" } ]}Missing or invalid API key
object
Examplegenerated
{ "type": "https://example.com", "title": "example", "status": 1, "detail": "example"}The key is valid, but the account’s trial or subscription does not grant
access: it has lapsed, or a live trial needs a card. Problem type
payment-required. Not retryable until the account is renewed at
https://app.cotes.ai.
object
Examplegenerated
{ "type": "https://example.com", "title": "example", "status": 1, "detail": "example"}The client IP address is blocked. Problem type forbidden. Returned
before the key is checked, and not retryable.
object
Examplegenerated
{ "type": "https://example.com", "title": "example", "status": 1, "detail": "example"}No matching contest
object
Examplegenerated
{ "type": "https://example.com", "title": "example", "status": 1, "detail": "example"}Too many requests
object
Examplegenerated
{ "type": "https://example.com", "title": "example", "status": 1, "detail": "example"}