Introduction¶
swap.coffee constantly updates the list of tokens (or jettons for TON) that are supported by the platform. This list is used to determine the available tokens that can be used by our swap algorithms. The list of tokens and their specific properties (TVL, price, etc.) are collected from various sources and are updated on a regular basis.
You can use tokens from the list to swap them with other tokens or build your own logic on top of it.
OpenAPI Specification for the tokens API can be found here. You can build your own API wrapper by using the OpenAPI code generator.
Token properties¶
Each token from the list has the following properties:
symbol
- the token symbol (e.g.USDT
,CES
,TON
, etc.)name
- the token name (e.g.Tether
,Toncoin
,Scaleton
, etc.)address
- the token address on the blockchaindecimals
- the number of decimals the token hasblockchain_id
- the blockchain id where the token is located (currently for TON it is always1
)price_usd
- the price of the token in USDtvl
- the total value locked in the token (in USD)holders_count
- the number of holders of the tokenimage
- the URL of the token image
⚠️ Note: The address
property is represented in raw format. You should convert it to user-friendly format in
case of use it in swap.coffee DEX aggregator API.
Here is example of CES token:
{
"address": "0:a5d12e31be87867851a28d3ce271203c8fa1a28ae826256e73c506d94d49edad",
"blockchain_id": 1,
"name": "swap.coffee",
"symbol": "CES",
"decimals": 9,
"tvl": 681406.0524709618,
"image": "https://assets.dedust.io/images/ces.webp",
"id": 177,
"price_usd": 3.31246653703748,
"holders_count": 1930,
"external_id": "16288"
}