Supra Core API — Public Client Documentation Index
Italiano: Documentazione pubblica per i client dell'API Supra Core.
This manual describes the supported public HTTP contract of the authenticated commercial Supra Core API service. The documentation and OpenAPI specification are publicly available so developers can evaluate the contract and prepare an integration before requesting access.
Commercial Access
Access to the API service requires a valid API key associated with an enabled plan. Available plans, rate limits, permitted usage, and commercial terms are provided separately by TCP Labs. Every endpoint, including health, requires authentication. Public availability of this manual and the OpenAPI specification does not grant access to the service.
Supported authentication methods:
X-API-Key: <API_KEY>Authorization: Bearer <API_KEY>
Getting Started
| Chapter | Description |
|---|---|
| Introduction | API capabilities, data domains, read-only scope, and navigation. |
| Getting Access | Access request, secure credential delivery, and initial verification. |
| Authentication | Supported authentication headers and safe API key handling. |
| Rate Limits | Plan-dependent limits, HTTP 429, retry, and backoff guidance. |
| Response Format | Common JSON envelopes, nullability, precision, and timestamps. |
| Error Codes | Public error codes, HTTP statuses, retryability, and corrective actions. |
Data Endpoints
| Chapter | Description |
|---|---|
| Health Endpoint | Service status, cursor state, and data freshness. |
| Market Current Endpoint | Paginated current market snapshots. |
| Market Pair Endpoint | Current snapshot for one token/quote pair. |
| Candles Endpoint | Canonical OHLCV candles and supported granularities. |
| FA Swaps Endpoint | Normalized FA swap history. |
| LEGACY Swaps Endpoint | Normalized LEGACY swap history. |
| FA Liquidity Events Endpoint | FA pool and farm event history. |
| LEGACY Liquidity Events Endpoint | LEGACY liquidity event history. |
| FA Burn Events Endpoint | Normalized FA burn history. |
Integration and Reference
| Chapter | Description |
|---|---|
| Pagination, Filters, and Limits | Shared list-query behavior and endpoint-specific limits. |
| Curl Examples | Copy-safe authenticated request examples. |
| Integration Guide | Client architecture, polling, caching, retries, and defensive parsing. |
| Support | Safe support escalation and sanitized reproduction details. |
| Glossary | Client-facing API terminology used throughout the manual. |
Machine-Readable Contract
The certified machine-readable contract is available in the Supra Core OpenAPI specification.
For a project-level introduction, see the Supra Core overview.
Supra Core is an independent project developed by TCP Labs for the Supra ecosystem. It is not an official product of Supra or the Supra Foundation.