Docs / API
Public data and unsigned transactions only: no keys, accounts, cookies or signing. Nothing here can change a rule, claim a fee, or adopt an existing token. Version 1.0.0; within v1 changes are additive only.
Base
API=https://burnticker.com/api/burnticker/v1 curl -s "$API/catalogue" # every source and its tier curl -s "$API/tokens" # every coin on the platform curl -s "$API/tokens/<TICKER>/receipts"
Machine-readable contract: /api/burnticker/v1/openapi.json (OpenAPI 3.1). TypeScript bots: @burnticker/sdk wraps every endpoint and adds local receipt verification.
Endpoints
| Method | Path | What | Cache | Bucket |
|---|---|---|---|---|
| GET | /catalogue | Every resolution source with its tier | 300 s | read |
| GET | /sources/{id}/preview | What a catalogue rule would have burned over the source's frozen fixture | 300 s | read |
| GET | /kalshi/events | Search Kalshi events: games, contests, people (or list a series' upcoming events) | 60 s | heavy |
| GET | /kalshi/teams | Teams of a game series, with next game and season record (team coins) | 60 s | heavy |
| GET | /kalshi/search | Search Kalshi series and events (or read one series with its open markets) | 60 s | heavy |
| POST | /kalshi/backtest | Back-test a rule on the venue's own settled history | — | heavy |
| POST | /rules/validate | Validate a rule; get its canonical JSON and sha256 | — | read |
| POST | /launch/bundle | Build the unsigned launch transactions + the review payload | — | write |
| POST | /launch/confirm | Report the landed launch transaction (takes the draft live) | — | write |
| GET | /tokens | Every token on the platform | 30 s | read |
| GET | /tokens/{ticker} | One token: status, receipts, next burn, implied chance | 30 s | read |
| GET | /tokens/{ticker}/receipts | A token's receipts | 30 s | read |
| GET | /tokens/{ticker}/verify/{id} | Verify one receipt from the source and the chain | 60 s | heavy |
| GET | /trust | The Powers Register and the live fee bps | 60 s | read |
| GET | /openapi.json | This document | 3600 s | read |
Rate limits (per client)
- read — 120 requests burst, 120 per minute sustained
- heavy — 20 requests burst, 20 per minute sustained (these call Kalshi or re-read a source)
- write — 10 per hour (launch bundles and confirmations)