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 http://localhost:8080/v1/spots

GET/v1/greeks

Get full Greek sheet for all models.

curl http://localhost:8080/v1/greeks

GET/v1/forwards/:ticker

Get forward curve for a model.

curl http://localhost:8080/v1/forwards/OPUS-4.5

POST/v1/price

Calculate cost for a task profile.

curl -X POST http://localhost:8080/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 all models for a task profile, ranked by cost.

curl -X POST http://localhost:8080/v1/compare \
  -H "Content-Type: application/json" \
  -d '{
    "n_in": 10000,
    "n_out": 500,
    "eta": 0.4
  }'

GET/v1/history/:ticker

Get price history with provenance markers.

curl "http://localhost:8080/v1/history/GPT-4O?from=2024-01-01"

GET/v1/events

Get recent price change events.

curl "http://localhost:8080/v1/events?since=2024-01-01"