Developer
Developer API
Programmatic access to Tourmaline analysis. API access requires the Researcher plan; every request is metered against a monthly quota and audited in usage events.
Authentication
Send your key as a header on every call:
Authorization: Bearer tmr_live_… # or X-API-Key: tmr_live_…
Keys are shown once at creation and stored as SHA-256 hashes. Revoke instantly from this page — revoked keys fail on their next request.
Endpoints
GET /api/v1/wallet/overview?chain=ethereum&address=0x…
Wallet overview: native balance plus tracked token balances, normalized (section 11.4).
GET /api/v1/token/research?chain=ethereum&address=0x…
Full token research: metadata, honeypot detection (4 layers), and risk engine output.
Responses use the standard Tourmaline envelope: { success, data, meta: { requestId, chain, fetchedAt, dataFreshnessSeconds }, error }. Errors carry a machine-readable code and a retryAfterSeconds hint when rate limited. The X-RateLimit-Remaining header reports your remaining monthly quota.
Quotas
| Plan | API access | Requests / month |
|---|---|---|
| Free | — | 0 |
| Explorer / Pro | — | 0 |
| Researcher | included | 100,000 |