API Documentation

Free tier requires no API key. Rate limit: 60 requests/hour per IP.

GET/v1/spots

Get current spot prices for all models.

curl https://api.exostream.ai/v1/spots

GET/v1/greeks

Get full Greek sheet for all models.

curl https://api.exostream.ai/v1/greeks

GET/v1/forwards/:ticker

Get forward curve for a model.

curl https://api.exostream.ai/v1/forwards/OPUS-4.5

POST/v1/price

Calculate cost for a task profile.

curl -X POST https://api.exostream.ai/v1/price \
  -H "Content-Type: application/json" \
  -d '{
    "model": "OPUS-4.5",
    "n_in": 30000,
    "n_out": 800,
    "eta": 0.6,
    "horizon_months": 3
  }'

Parameter	Description	Required
model	Ticker or model_id	Yes
n_in	Input tokens	Yes
n_out	Output tokens	Yes
eta	Cache hit ratio (0-1)	Default: 0
n_think	Thinking tokens	Default: 0
horizon_months	Forward horizon	Optional

POST/v1/compare

Compare models for a task profile, ranked by cost.

curl -X POST https://api.exostream.ai/v1/compare \
  -H "Content-Type: application/json" \
  -d '{
    "models": ["opus-4.6", "gpt-5.2", "sonnet-4.6"],
    "n_in": 10000,
    "n_out": 500,
    "eta": 0.4
  }'

GET/v1/history/:ticker

Get price history with provenance markers.

curl "https://api.exostream.ai/v1/history/GPT-4O?from=2024-01-01"

GET/v1/ici

Get the EICI value with constituents and weights.

curl "https://api.exostream.ai/v1/ici?type=unified"

Parameter	Description	Values
type	Index variant	unified \| batch \| sync

POST/v1/swap

Price an inference cost swap (EICS). Returns fair fixed rate, NPV, and Greeks.

curl -X POST https://api.exostream.ai/v1/swap \
  -H "Content-Type: application/json" \
  -d '{
    "model": "OPUS-4.6",
    "taskType": "coding",
    "tenor": "3M",
    "notionalTokens": 1000000
  }'

Parameter	Description	Required
model	Ticker or model_id	Yes
taskType	Task type (coding, reasoning, etc.)	Yes
tenor	Contract duration: "1M", "3M", or "6M"	Yes
notionalTokens	Total output tokens over contract life	Yes

GET/v1/monte-carlo/:ticker

Run a Monte Carlo simulation for future price distribution.

curl "https://api.exostream.ai/v1/monte-carlo/OPUS-4.6?taskCategory=coding&horizonMonths=3"

Parameter	Description	Required
taskCategory	Task type for token profile	Yes
horizonMonths	Simulation horizon (1, 3, or 6)	Yes

GET/v1/backtest

Get forward curve backtest results — tenor summaries, family breakdowns, and individual predictions.

curl https://api.exostream.ai/v1/backtest