Skip to content
SpectralBotSpectralBot API

Contest by full ticker

GET
/v1/contests/{ticker}
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”
ticker
required
string
>= 1 characters

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-00

Responses

Section titled “Responses”

200

Section titled “200”

Contest (live or settled)

Media typeapplication/json
object
ticker
required
string
state
required
string
Allowed values: live expired settled
window
required
object
opens_at
required
string format: date-time
expires_at
required
string format: date-time
strike_price_dollars

Strike / to-beat underlying price in USD, if known.

number | null
settled_side
string | null
Allowed values: up down
settled_price_dollars

Oracle settled underlying price (expiration value) in USD once the contest is settled; null while live or if the oracle did not report it.

number | null
signals
required

All Cotes AI signals for this contest (consumers apply their own thresholds).

Array<object>
object
ticker
required

Contest ticker this signal belongs to (same as parent Contest.ticker).

string
raised_at
required
string format: date-time
side
required
string
Allowed values: up down
confidence
required

Model probability on side (0–100).

number
entry_price_cents
required

Venue quote for side on the 0–100¢ scale ($0.54 → 54). Same denomination as edge_cents.

number
edge_cents
required

Confidence − entry_price_cents. Signed probability points, not settlement money.

number
outcome
required
string
Allowed values: pending win loss void
model_version

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.

string | null
Example
{
  "state": "live",
  "settled_side": "up",
  "signals": [
    {
      "side": "up",
      "outcome": "pending",
      "model_version": "c5456da6"
    }
  ]
}

401

Section titled “401”

Missing or invalid API key

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
detail
required
string
Examplegenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example"
}

404

Section titled “404”

No matching contest

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
detail
required
string
Examplegenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example"
}

429

Section titled “429”

Too many requests

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
detail
required
string
Examplegenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example"
}

Headers

Section titled “Headers”
Retry-After
integer
X-RateLimit-Limit
integer
X-RateLimit-Remaining
integer