Skip to main content
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.

​
Endpoints

You can generate your own API wrapper with any OpenAPI code generator.

​
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 returns 429 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: 
curl -H "X-Api-Key: <your-api-key>" https://tokens.swap.coffee/api/v3/jettons

​
Error Format

All error responses share the same shape: 
{ "error": "human-readable error description" }
Typical status codes:
  • 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.
LanguageLibraryDescription
Pythonpy-stollen/swapcoffee-tokensPython wrapper for the Tokens API (legacy v2)
If you maintain a Tokens API wrapper in another language and would like it listed here, reach out in @swap.coffee DEV Chat.