Skip to content
SpectralBotSpectralBot API

Getting started

The Public Signals API gives you live prediction-market contest snapshots and Cotes AI signals over HTTPS JSON and Server-Sent Events.

Base URL

Section titled “Base URL”
https://api.cotes.ai

Quick start

Section titled “Quick start”
Terminal window
export COTES_API_KEY='your-key'
export BASE='https://api.cotes.ai'


# Liveness (no auth)
curl -sS "$BASE/v1/health"


# Active contest for a series
curl -sS -H "Authorization: Bearer $COTES_API_KEY" \
  "$BASE/v1/contests/active?series=KXBTC15M"

Endpoints

Section titled “Endpoints”
Method Path Auth
GET /v1/health none
GET /v1/contests/active?series={series} API key
GET /v1/contests?series={series} API key
GET /v1/contests/{ticker} API key
GET /v1/stream/contests?series={series} API key (SSE)

series is a series prefix such as KXBTC15M. Use the full ticker only on /v1/contests/{ticker}.

Next steps

Section titled “Next steps”