Get CEX Tokens API

Fetches a list of tokens supported by Houdini Swap, detailing their respective chains. This information is useful for constructing token selection interfaces in applications.

Endpoint: GET /tokens

Response: A JSON object containing Token details.

Parameters: none

Example Request:

GET /tokens

Example Response:

[
  {
    "id": "USDT",
    "name": "Tether",
    "symbol": "USDT",
    "network": {
      "name": "Ethereum Mainnet",
      "shortName": "ETH",
      "addressValidation": "^(0x)[0-9A-Fa-f]{40}$",
      "memoNeeded": false,
      "explorerUrl": "https://etherscan.io/tx/",
      "addressUrl": "https://etherscan.io/address/",
      "priority": 1,
      "kind": "evm",
      "chainId": 1
    },
    "color": "#26a17b",
    "keyword": "usdt usdterc20 tether usdteth erc-20 erc20 eth",
    "displayName": "USDT (ETHEREUM)",
    "chain": 1,
    "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "hasMarkup": true,
    "networkPriority": 2,
    "icon": "https://...",
    "hasFixed": true,
    "hasFixedReverse": true
  }
]

Response fields:

Field	Type	Description
id	string	Unique identifier for the token.
name	string	Full name of the token (e.g., Tether).
symbol	string	The ticker symbol representing the token (e.g., USDT).
network	object	The blockchain network associated with the token. See NetworkDTO.
color*deprecated	string	Hex color code associated with the token.
keyword	string	Keywords related to the token for searchability.
displayName	string	A user-friendly display name for the token.
icon	string	URL for the token’s icon.
hasFixed*deprecated	boolean	Indicates if the token supports fixed swap.
hasFixedReverse*deprecated	boolean	Indicates if the token supports fixed swaps in reverse (using to direction).

The network field refers to the NetworkDTO, which includes:

Field	Type	Description
name	string	Full name of the blockchain network (e.g., Ethereum Mainnet).
shortName	string	Short identifier for the network (e.g., ETH).
memoNeeded	boolean	Indicates if a memo or extra ID is required for transactions.
addressValidation	string	Regular expression pattern for address validation on this network.