Developers & agents
The Scopes API & MCP server
Every prediction market's price next to an independent Scopes Fair Value, the divergence between them, and the mechanical record of which side proved right, as a stable read API and an MCP server. Point-in-time as_of queries are reproducible and citable.
Dashboard to read it · API keys to query it · Reference to build on it.
Quickstart
- 1. Create an API key (any signed-in account). Send it as
Authorization: Bearer <key>. - 2. Call the versioned base
https://scopes.com/api/v1, or point an MCP client athttps://scopes.com/api/mcp. - 3. A key inherits its owner's API plan; Research access includes free-tier API access.
# Iowa Senate 2026 (poll desk): last 30 days, point-in-time
curl -H "Authorization: Bearer $SCOPES_KEY" \
"https://scopes.com/api/v1/series?outcome=15&since=30&as_of=2026-08-01T00:00:00Z"Endpoints
| GET /api/v1/divergences | Widest market-vs-fair-value divergences (delayed sample). |
| GET /api/v1/outcomes | Discover markets; each row carries a series_ref to chain into /series. |
| GET /api/v1/series | Point-in-time series (price, Scopes Fair Value, Scopes Divergence). Accepts as_of. |
| GET /api/v1/calibration | Calibration record: which side proved right, by desk/family. |
| GET /api/v1/sci | Scopes Calibration Index now: composite and each desk, latest publication. |
| GET /api/v1/sci/series | SCI series catalogue: every permanent code with its latest value. |
| GET /api/v1/sci/series/{code} | One SCI series (e.g. SCI-D-SPORTS), latest publication with full statistics. History and as_of are licensed. |
| GET /api/v1/scopes | The Scope index (last-hour objects). Filter by desk, since. |
| GET /api/v1/scopes/{id}.json | One Scope: venue lanes, minutes, metrics. Access + rights gated. |
| GET /api/v1/convergence | Divergence→convergence study result. |
| GET /api/v1/coverage | Dataset coverage / odometer. |
| GET /api/v1/health | Liveness + version. |
MCP tools: get_divergences, list_outcomes, get_series, get_calibration_summary, get_coverage, get_sci, get_sci_series. Full schema in the OpenAPI spec and llms.txt. Rate-desk series are withheld (403) pending data licensing. How each fair value is computed + version history: methodology & changelog.
Reference Reports: a point-in-time report for any contract (the market price, the Scopes Fair Value, the divergence, the resolution, and the Merkle inclusion proof), as a page, a PDF, or JSON at /api/reference/report/{id}. Request one.
Scorecard evidence: one row per resolved binary event (scored and set-aside), with the winner column and the Scopes-owned fields, so the headline reproduces to the row. Venue price fields follow the rights gate. Download the CSV or read the recipe on how the number is computed.
Quotas
Metering is by calls (one API request or MCP tool call = 1). The free plan includes a monthly quota; when it is spent, calls return 429 until the quota resets: no metered overage, no surprise bills. Every response carries X-Quota-Limit, X-Quota-Used, and X-Quota-Remaining so agents can self-pace. Data entitlements (live vs delayed, archive depth) follow the key's plan.
Access & licensing
API & MCP access
The same record, for machines: your code and agents querying /api/v1. Just want to read the boards in a browser? That's dashboard access from $49/mo. See full pricing.
API plans are licensed for internal research and evaluation use only. Production deployment, redistribution, derived commercial products, and multi-team use require a Scopes Reference data license.
API access is licensed per client. The free plan and the subscriber plans include the documented read endpoints at the documented rate limits. For production use, redistribution, files, Snowflake delivery, or point-in-time audit trails, that is a Scopes Reference data license.
Research and information only, not investment advice. API and MCP responses return a machine-readable terms pointer in the X-Scopes-Terms header. Manage your plan anytime from API keys → Billing.