API Docs

Returns service status, version, and uptime.

{
  "service": "Pythia",
  "status": "ok",
  "version": "1.0.0",
  "started_at": "2026-05-28T12:00:00.000Z"
}

Active lanes, scan loop state, historical prior WR.

{
  "current_lanes": [{"sport_key": "mlb"}, {"sport_key": "nhl"}],
  "active_lanes_count": 6,
  "scan_loop_enabled": true,
  "scan_interval_seconds": 60,
  "live_executable_signals": 8,
  "historical_prior_wr": 0.608,
  "historical_prior_wr_display": "60.8%",
  "latest_scan_finished_at": "2026-05-28T12:25:00.000Z"
}

Free ranked signals — Pythia Premium first, then Strongest, then native. Returns up to 18 signals.

{
  "signals": [...],
  "pythia_count": 10,
  "pythia_executable_fresh_count": 6,
  "pythia_stale_count": 4,
  "native_count": 4,
  "latest_scan_finished_at": "2026-05-28T12:25:00.000Z",
  "scan_interval_seconds": 60
}

Free cache-first single strongest preview. No payment required.

{ "signal_id": "sig_...", "provider": "pythia", "provider_lane": "PREMIUM", ... }

Current best executable-fresh row. GET is free preview. POST requires x402 payment header.

# GET — free preview
curl "https://pythiaterminal.xyz/signal/strongest"

# POST — x402 paid
curl -X POST "https://pythiaterminal.xyz/signal/strongest" \
  -H "Content-Type: application/json" \
  -H "X-Payment: <x402-payment-header>" \
  -d '{}'

Returns all available endpoints and service metadata.

JSON schema for signal objects. Describes all fields and types.

x402 payment manifest. Returns price, network, and asset details.

{
  "endpoint": "POST /signal/strongest",
  "price": { "amount": "0.50", "currency": "USDC" },
  "network": "base",
  "asset": "USDC"
}