Skip to content

Series with signals

GET
/v1/series
curl --request GET \
--url https://api.cotes.ai/v1/series \
--header 'Authorization: Bearer <token>'

Every series the API publishes signals for: one Kalshi 15-minute series per asset (BTC, ETH, SOL, XRP). Pass a row’s series to the contest and stream endpoints.

Each row also says what is live on that series right now: the ticker of the round trading, and the model and time of the newest signal stored for it. model_version and last_signal_at are null for a series that has no signals yet. A catalog entry does not promise a running producer. Model tags can differ by asset; older unversioned readings can have a null model_version with a non-null last_signal_at. Timestamps may be stale after a producer stops. This is the crypto catalog, not an allowlist: existing contest endpoints also accept other recorded series such as KXGOLD15M.

The series, in a fixed order with BTC first

Media typeapplication/json
object
series
required
Array<object>
object
series
required

Series prefix to pass as series to the contest and stream endpoints.

string
asset
required

The underlying asset the contests in this series are on.

string
Allowed values: BTC ETH SOL XRP
name
required
string
active_ticker
required

Ticker of the round trading now; null in the changeover between one round settling and the next opening.

string | null
model_version
required

Version tag on the newest signal stored for this series. Null when the series has no signals yet, or its latest stored reading has no model tag.

string | null
last_signal_at
required

When the newest signal for this series was raised. Null when it has none.

string | null format: date-time
Example
{
"series": [
{
"series": "KXBTC15M",
"asset": "BTC",
"name": "Bitcoin 15-minute",
"active_ticker": "KXBTC15M-26NOV121430-30",
"model_version": "34fa82b3",
"last_signal_at": "2026-11-12T14:21:05Z"
},
{
"series": "KXETH15M",
"asset": "ETH",
"name": "Ethereum 15-minute",
"active_ticker": "KXETH15M-26NOV121430-30",
"model_version": null,
"last_signal_at": null
}
]
}

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"
}

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.

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"
}

The client IP address is blocked. Problem type forbidden. Returned before the key is checked, and not retryable.

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"
}

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"
}
Retry-After
integer
X-RateLimit-Limit
integer
X-RateLimit-Remaining
integer