Skip to content

Overview

Public developer API for Cotes prediction-market contest signals. Integrators receive signal metrics (confidence, entry price, edge) and apply their own thresholds. Authenticate with an API key. Call HTTPS + JSON directly — there is no first-party SDK.

Contests are Kalshi’s bitcoin 15-minute markets (series KXBTC15M). Fetch the live contest with GET /v1/contests/active, a single contest by ticker with GET /v1/contests/{ticker}, or settled history with graded signals with GET /v1/contests. GET /v1/stream/contests streams contest openings, new signals, and settlements as Server-Sent Events. GET /v1/health needs no key.

Errors use application/problem+json, and requests are rate limited per client IP. Guides: https://spectralbot.cotes.ai/docs/

Quick start: create a key under Account → API keys at https://app.cotes.ai, then request the live contest:

curl -sS -H "Authorization: Bearer $COTES_API_KEY" \
  "https://api.cotes.ai/v1/contests/active?series=KXBTC15M"

The response is one Contest: its ticker, state, trading window, strike price, and every Cotes AI Signal raised so far, each with a side, a confidence, an entry price (the venue quote for that side), and the edge between them. Signals are research output: the API reports every signal, and you choose which ones meet your own confidence and edge thresholds. Once the contest settles, settled_side says which side won and each signal’s outcome is graded win, loss or void.

Information

  • OpenAPI version: 3.1.0

API key issued for your integration.

Security scheme type: http