Live contest for a series
const url = 'https://api.cotes.ai/v1/contests/active?series=KXBTC15M';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/active?series=KXBTC15M' \ --header 'Authorization: Bearer <token>'Returns the live contest for the given series prefix (KXBTC15M, KXETH15M, KXSOL15M or KXXRP15M), including all Cotes AI signals for that contest.
Returns 404 in the changeover between one round settling and the next
opening; retry shortly. A series nothing is recorded for returns the same
404 and never resolves. The problem detail says which case it is, and
GET /v1/series lists the supported prefixes.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Series prefix: KXBTC15M, KXETH15M, KXSOL15M or KXXRP15M (GET /v1/series lists them). Match is exact and case-sensitive on the prefix. A full ticker also resolves while that round is live, but use /v1/contests/{ticker} for a specific round.
Example
KXBTC15MResponses
Section titled “Responses”Active contest
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"}