swap.coffee constantly updates its list of supported tokens (or jettons on TON). This list determines which assets our swap algorithms can use. Token data and its market properties (price, TVL, volume, holders, FDMC, etc.) are aggregated from various sources and refreshed regularly. You can read the list to power your own applications — build analytics dashboards, token explorers, trading bots, or integrate the data directly into your product.Documentation Index
Fetch the complete documentation index at: https://docs.swap.coffee/llms.txt
Use this file to discover all available pages before exploring further.
Endpoints
- Base URL:
https://tokens.swap.coffee - Interactive Swagger UI:
/api/v3/swagger-ui - OpenAPI specification:
/api/v3/openapi.yaml
Rate Limits
All read endpoints documented here are public and require no authentication. Public access is rate-limited to roughly 1 request per second per IP. Beyond that, the API returns429 Too Many Requests.
If you need higher throughput for an integration, request an API key through the Get API Key form and pass it via the X-Api-Key header:
Error Format
All error responses share the same shape:400 Bad Request— malformed input or invalid parameter.404 Not Found— the requested jetton or resource does not exist.429 Too Many Requests— rate limit hit.
Conventions
- All datetime fields are in ISO 8601 format.
- Jetton addresses are always returned in raw form (
workchain:hash). - Token amounts are returned as strings in base units (no decimal point applied).
Community Libraries
⚠️ Note: The libraries below are maintained by third parties rather than the swap.coffee team. We cannot guarantee their stability or correctness.| Language | Library | Description |
|---|---|---|
| Python | py-stollen/swapcoffee-tokens | Python wrapper for the Tokens API (legacy v2) |