Appearance
Reference
Lookup material: endpoints, SDK surface, contract addresses, chain and provider tables, environment variables, and the failure modes each produces.
HTTP APIEndpoint-by-endpoint, split by domain: trading, providers, fiat, perps, automation, chat.swap-sdkTradeManager, the aggregator contract, Quote, and the relayer builder.ContractsEvery deployed proxy and implementation address, plus where each ABI lives.Chains36 chains named by the SDK, 22 that can settle a swap, and why they differ.Providers26 aggregators integrated, 21 registered, and which need a backend proxy.EnvironmentEvery variable, grouped by concern, with secrets marked.
HTTP API
Two mounts on bz-backend:
| Mount | Contents | Route files |
|---|---|---|
/api | The original surface — trading, providers, fiat, perps, DCA, Autopilot, plus the whole ecosystem layer | 65 |
/api/v1 | BlazAI, dApp builder, audit, safety, wallet cards, training data, feedback, notifications | 9 |
/api/pinata | IPFS pinning | 1 |
Base URLs: https://api.blazpay.com/api in production, http://localhost:5000/api locally.
| Page | Covers |
|---|---|
| Trading & quotes | SSE quotes, transaction build, signing, history |
| Provider proxies | The 14 key-bearing provider passthroughs |
| Fiat on/off-ramp | 5 ramps, catalogues, webhooks |
| Perpetuals (Orderly) | Account lifecycle, orders, positions |
| DCA | CSIP positions, fills, claims |
| Autopilot | Agents, policies, activity |
| BlazAI chat | Streaming chat, sessions, suggestions |
| Audit & safety | Reports, certificates, token scans, wallet cards |
| dApp builder | Projects, versions, smart accounts |
| Platform & ecosystem | The remaining 50-odd route groups |
SDK & contracts
| Page | Covers |
|---|---|
| swap-sdk | TradeManager, AggregatorFactory, RelayerFactory, Quote, constants |
| Contract addresses | Every deployed proxy and implementation |
| Contract ABIs | Where each ABI lives and how they stay in sync |
Data tables
| Page | Covers |
|---|---|
| Chains | 36 named, 22 settleable, 24 with landing pages |
| Liquidity providers | 26 integrated, 21 registered |
| Environment variables | Every variable, grouped, secrets marked |
| Errors & failure modes | Symptom → cause → fix |
Conventions
Read conventions before using the API pages — it covers response envelopes, the wallet-parameter pattern, SSE framing, address casing and pagination.
The API is internal-first
There is no published public API, no versioned deprecation policy and no API keys for third parties. /api/v1 is a code-organisation boundary, not a compatibility contract. Endpoints change without notice, and several are administrative (catalogue refresh, seeders) rather than product surfaces.
Treat everything here as documentation of the current implementation, not as a stable interface.