API Reference
The Burn & Claim API is a REST API served over HTTPS. All endpoints live under a single base path.
Base URL
https://api.aerosol.com/api/v1/burnerContent type
All request and response bodies are JSON:
Content-Type: application/jsonAuthentication
Every request must include one of:
| Header | Credential | Use from |
|---|---|---|
X-Api-Key: ak_... | API key | Server only |
Authorization: Bearer <token> | Session token | Browser / mobile |
See Authentication for details.
Versioning
The API is versioned via the URL path (/api/v1/). Breaking changes will be introduced under a new version prefix. Non-breaking additions (new fields, new endpoints) are added to the current version without a version bump.
Endpoints
Sessions
| Method | Path | Description |
|---|---|---|
POST | /sessions | Create a session token (API key only) |
Wallet
| Method | Path | Description |
|---|---|---|
GET | /wallet/:address/assets | Get burnable assets in a wallet |
POST | /wallet/:address/transactions | Build unsigned transactions |
POST | /wallet/:address/transactions/submit | Submit signed transactions |
Read-only
| Method | Path | Description |
|---|---|---|
GET | /stats | Platform statistics |
GET | /leaderboard | Wallet leaderboard |
Common response headers
| Header | Present when | Description |
|---|---|---|
Retry-After | 429 responses | Seconds until the rate limit resets |
X-RateLimit-Limit | All responses | Requests allowed per minute for your tier |
X-RateLimit-Remaining | All responses | Requests remaining in the current window |
Last updated on