The API
https://api.s2ar.dev · every tool answers GET with query parameters and POST with a JSON body
Evidence an agent can hand on: each answer measures something and comes back with the evidence and a signed record anyone can verify, free.
Paying
Sales are paused since 2026-10-16 (the charter, clause 3): no card pack is sold and no rail is offered. A key already bought keeps working, and verify, the free calls and the environments stay open.
- Free: Ten keyless calls a day are free on each plain route (three for certify or a starbox shot, one for an audit); signing in grants $1.00.
- A key:
Authorization: Bearer <key>, from your account page (or, when sales are open, a card pack: POST /v1/credits/buy); calls draw on its credit. - x402, when sales are open: every paid route has a mirror under
/x402; unpaid, it answers 402 with accepts[] (USDC on Base); send the signed payment as PAYMENT-SIGNATURE or X-PAYMENT, and the answer carries PAYMENT-RESPONSE. While paused the mirrors answer 410. - The Machine Payments Protocol, when sales are open: a 402 carries a
WWW-Authenticate: Payment challenge; while paused it carries none.
A call that fails is never charged.
Records
/v1/verify/{record_sha256} | GET | re-check a record by its sha256: the seal recomputed and the signature checked; `?file=<sha256>` asks whether a downloaded file is one of a build record's outputs |
/v1/verify | POST | re-check a record you hold, posted as JSON |
/v1/badge/{record_sha256}.svg | GET | a badge for a record, for a README |
/.well-known/assay.json | GET | the issuer: its key and the Assay standard's version |
/assay/standard | GET | the Assay standard, the record format every answer is sealed in |
The tools' companions
/v1/score/forms | GET | the forms score can measure a text against |
/v1/assert/checks | GET | the checks assert can run |
/v1/x402/inspect/checks | GET | the checks inspect runs on an endpoint |
/v1/diff/checks | GET | the comparisons diff can make |
/v1/extract_text/languages | GET | the languages extract reads |
/v1/env | GET | the environments an episode can be played in |
/v1/env/step | GET POST | one step of a running episode |
/v1/env/episode/{episode_id} | GET | a sealed episode, by its id |
/v1/env/tape/{record_sha256} | GET | a sealed episode as a tape: seed, level, actions and every ply's state digest, for a core at core_sha to replay and compare (free) |
/v1/env/scorecard | POST | a scorecard sealed over episodes |
/v1/audit/{job} | GET | an audit's result, fetched again |
/v1/audit/sample-grader | POST | the sample grader an audit can be tried on, free |
/v1/x402/watch/{host} | GET | a watched endpoint's page of results |
/v1/badge/x402/{host}.svg | GET | a watched endpoint's badge |
The house
/health | GET | the service's own checks (house database, store, disk, rooms); 503 when down |
/v1/version | GET | the release that is running |
/v1/releases | GET | every release, newest first (also /changelog and /changelog.atom) |
/changelog | GET | what changed, as a page |
/changelog.atom | GET | what changed, as a feed |
/charter | GET | the charter the service runs under (also /.well-known/charter.md) |
/.well-known/charter.md | GET | the charter |
/.well-known/proceedings.json | GET | today's proceedings: each day's counts, signed |
/.well-known/proceedings/{day}.json | GET | a day's proceedings |
/.well-known/security.txt | GET | where to report a flaw (once the contact is published) |
Agents and discovery
/mcp | POST | the MCP server (streamable HTTP): every tool, paid by key, by x402 or within the free calls |
/mcp/directory | GET POST DELETE | the same server, as listed in Claude's connectors directory: no payment tools |
/.well-known/x402 | GET | the x402 manifest: every paid route and its price (404 while sales are paused) |
/v1/models | GET | certify as an OpenAI-compatible model listing |
/v1/chat/completions | POST | certify through the OpenAI chat shape |
Accounts, pages and the issuer
/v1/credits/buy | POST | a card pack: Stripe Checkout, a key minted when it is paid (503 while sales are paused) |
/.well-known/openid-configuration | GET | the s2ar identity's issuer (id.s2ar.dev) |
/.well-known/jwks.json | GET | the issuer's public keys |
/pages/me | GET PUT DELETE | your page at s2ar.dev/@handle, published by an app with your token |
/pages/{pid} | PUT DELETE | a project's page |
Reports from the games
/v1/reports | POST | the in-game Report: a player's words, sealed and held for the house's triage; no account, rate-limited |
/v1/reports/{record_sha256} | GET | where a report stands: the record's essentials and its issue's standing |
/reports/{record_sha256} | GET | the same, as the page a reporter watches without an account |
Errors
Every error is JSON: {"error": {"type": …, "message": …}}.
| status | type | what it means |
|---|
| 400 / 422 | invalid_request, invalid_repo, invalid_ref, image_url, … | the call itself is wrong: a parameter out of range, a body that does not match, a URL we will not fetch |
| 401 | auth_error | a key was sent and it is not one of ours |
| 402 | payment required, insufficient_credit, insufficient_balance | no free call left and no payment: the answer says how to pay (a key, x402's accepts[], or MPP's challenge); while sales are paused it offers no rail and names the pause |
| 404 | not_found | no such record, job, episode or page |
| 413 | (the proxy) | a body over the cap: 2 MB for JSON, 60 MB for the image routes |
| 429 | rate_limit_error | too fast: wait the Retry-After seconds |
| 503 | temporarily_unavailable | a service behind the route is down; nothing was charged |