API reference
Endpoints
Every route Scout exposes.
Answering
| Endpoint | Returns |
|---|
| POST /api/answer | search → cited answer → receipt, with an itemised FLOP price |
| POST /api/quote | the price before you send it. No search, no inference, no ledger row |
| GET /api/pricing | the full catalogue, metering mode, and which services are available |
| GET /api/catalog | sources, presets and models |
Miners
| Endpoint | Returns |
|---|
| GET /api/router | live miner ranking with scores |
| GET /api/miners | every miner with GPU, stake, router score and 24h settlement delta |
| GET /api/miners/{address} | one miner, same shape as a row |
| GET /api/miners/{address}/history | one miner's settlement history from Scout's own snapshots. window in seconds (default 7 days, max 30). Never touches the gateway |
| POST /api/alerts | subscribe to a settle-rate alert. Fields: address (SS58 or *), threshold (0–1), channel (site | telegram | twitter), handle. Returns an alert id |
| GET /api/alerts/check | poll pending triggers. Optional address filter. Marks returned events as seen |
| DELETE /api/alerts/{id} | deactivate an alert |
| GET /api/reliability | settlement-rate deltas per miner over a window (default 24h) |
| GET /api/inference-prices | every FLOP model priced as a whole request — FLOP cost, tokens, GFLOPs, latency blocks — by the gateway's own estimator. Needs no key, spends nothing |
Operations
| Endpoint | Returns |
|---|
| GET /api/stats | success rate per model, payer split, quoted vs charged totals |
| GET /api/analytics | daily demand aggregates. No question text, no client IDs |
| GET /api/health | liveness, metering mode, and whether the gateway accepts the key |