API Docs
Binary-2048 API v0.1.0
OpenAPI JSON source: /api/openapi
Docs hub: /docs | User guide: /docs/user | Developer guide: /docs/developer
/api/ads/rewardPOSTGrant rewarded-ad inventory after server-side signature and anti-fraud checks
/api/auth/bridge-tokenPOSTMint auth-bridge bearer token from authenticated Auth.js session
/api/auth/dev-tokenPOSTDev-only auth bridge token minting helper (env-gated)
/api/auth/entitlements/proofPOSTMint short-lived entitlement proof from signed auth bridge token
/api/bots/tournamentPOSTRun server-side AI-vs-AI tournament for configured seeds
/api/challenges/dailyGETGet Bitstorm Daily challenge and daily leaderboard window
/api/challenges/daily/submitPOSTSubmit replay for Bitstorm Daily leaderboard
/api/challenges/ghost-raceGETGet ghost race challenge (rollout bot replay on selected seed)
/api/challenges/ghost-race/submitPOSTSubmit replay for ghost race comparison
/api/gamesPOSTCreate a game session
/api/games/{id}GETGet game state by id
/api/games/{id}/encodedGETGet AI-friendly encoded state
/api/games/{id}/exportGETExport game JSON
/api/games/{id}/movePOSTApply one move
/api/games/{id}/replayGETGet canonical replay payload (header + moves)
/api/games/{id}/undoPOSTUndo the last move
/api/games/importPOSTImport game JSON
/api/healthGETHealth check
/api/leaderboardGETList ranked leaderboard entries
/api/leaderboard/submitPOSTSubmit finished ranked game to leaderboard (server-authoritative)
/api/marketing/eventsGETList tracked marketing events
/api/marketing/trackPOSTTrack marketing/share CTA events
/api/matches/{id}GETGet async match details and standings
/api/matches/{id}/submitPOSTSubmit moves for async same-seed PvP match
/api/matches/same-seedPOSTCreate async same-seed PvP match
/api/openapiGETOpenAPI spec document
/api/ops/telemetryGETGet lightweight route telemetry and anomaly flags
/api/replayPOSTDeterministically reconstruct replay from export or replay payload
/api/replay/codeGETDecode shareable replay code back to compact replay payload
POSTCreate shareable replay code from replay payload
/api/replay/postmortemPOSTReplay postmortem analyzer for highest-cost moves
/api/replay/validatePOSTValidate replay payload compatibility and deterministic rerun
/api/runs/{id}GETGet canonical persisted run record by id
/api/runs/{id}/replayGETGet persisted compact replay payload for run id
/api/sim/runPOSTRun deterministic scenario
/api/simulatePOSTBatch simulation endpoint
/api/store/catalogGETList active paid packet SKUs
/api/store/consumePOSTConsume inventory for subscriber and append ledger entry
/api/store/inventoryGETGet store inventory and recent ledger entries
POSTGrant inventory to subscriber
/api/store/purchasePOSTPurchase a paid packet SKU and grant inventory bundle
/api/subscriptionsGETList notification subscriptions for a subscriber
POSTCreate or update notification subscription
DELETEDelete notification subscription by id
/api/user/dataDELETEDelete authenticated user data package
/api/user/data/exportGETExport authenticated user data package