Celsi API

Programmatic access to Celsi weather edge data. Available on Pro Trader ($49.99/mo) and Autopilot ($99.99/mo) plans.

Authentication

All requests require an API key passed via the X-API-Key header.

curl -H "X-API-Key: celsi_ak_your_key_here" https://celsi.markets/api/v1/signals

Rate Limits

100 requests per hour per API key. Headers included on every response:

X-RateLimit-Limit — max requests per window
X-RateLimit-Remaining — requests left
X-RateLimit-Reset — window reset time (ISO 8601)

Response Format

// Success
{ "data": [...], "meta": { "total": 42, "timestamp": "..." } }

// Error
{ "error": "Rate limit exceeded", "detail": "Max 100 requests per hour" }

Endpoints

GET/api/v1/signals

Live edge scores for all weather contracts

Query Parameters

categoryTemperature, Precipitation, Storms, Seasonal

regionFilter by region (e.g., NYC, Chicago)

minScoreMinimum edge score (0-100)

sortscore (default), ev, volume, expiry

limitMax results (default 100, max 200)

GET/api/v1/markets/{region}

Contracts and analysis for a specific region

Query Parameters

categoryFilter by category

minScoreMinimum edge score

GET/api/v1/history

Historical edge scores and outcomes for backtesting

Query Parameters

categoryFilter by category

regionFilter by region

daysLookback days (default 30, max 90)

minScoreMinimum edge score

GET/api/v1/models

Current model accuracy and confidence weights

Query Parameters

categoryFilter by category

Signal Data Fields

scoreEdge score (0-100)

consensusWeighted model consensus (0-1)

directionRecommended side (YES/NO)

evExpected value

confidenceAverage model confidence

spreadModel disagreement spread

contract.yesPriceCurrent YES market price

contract.volumeTrading volume

contract.expiresContract expiry (ISO 8601)

models[]Individual model predictions

microclimateWind, clouds, dewpoint signals (Pro)

scoreTrendScore direction over time