GET /tokenList

This endpoint retrieves a list of supported tokens, including their categories and metadata.

This API allows developers to programatically check which tokens are supported by the Haiku Intents API suite, including essential metadata like token symbols, addresses, and categories. This data is crucial for:

• Verifying token support: Ensuring input and target tokens are supported before constructing an intent.

• Preparing for quoting and execution: Validated tokens can be passed into the POST /quoteIntent API to preview expected outcomes, fees, and approvals.

• Streamlining intent execution: Verified token data is used to finalise and execute trades via the POST /solveIntent API.

GET /tokenList

Base URL: https://api.haiku.trade/v1

Full example with Chain ID:

https://api.haiku.trade/v1/api/tokenList?chainId=42161

URL Parameter

Parameter	Type	Description
chainID	number	The chain ID to fetch tokens for (e.g. 80094 for Berachain)

curl 'https://api.haiku.trade/v1/tokenList?chainId=42161'

{
  "tokenCategories": [
    "token"
  ],
  "tokens": [
    {
      "chainId": <Number>,
      "address": <String>,
      "symbol": <String>,
      "name": <String>,
      "decimals": <Number>,
      "priceUSD": <String>,
      "coinKey": <String>,
      "logoURI": <String>,  // optional
      "primaryColor": <String>,  // optional
      "tokenCategory": <String>, // optional
      "iid": <String>,
    }
  ]
}

Parameter	Type	Description
tokenCategories	array	Types of supported tokens (e.g. ["token", "collateral", "varDebt"])
tokens.chainID	number	The chain ID for the token
tokens.address	string	The contract address of the token
tokens.symbol	string	The symbol of the token (e.g. WETH)
tokens.name	string	The full name of the token
tokens.decimals	number	The decimals used by the token
tokens.priceUSD	string	The current price of the token in USD
tokens.coinKey	string	Internal identifier, use iid to uniquely identify tokens
tokens.logoURI	string	The optional logo URL for the token
tokens.primaryColor	string	The optinal primary color for visual displays
tokens.tokenCategory	string	The optional token category
tokens.iid	string	Unique identifier for the token

{
  "tokens": [
    {
      "chainId": 42161,
      "address": "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1",
      "symbol": "WETH",
      "name": "WETH",
      "decimals": 18,
      "priceUSD": "2618.01",
      "coinKey": "WETH",
      "logoURI": "https://static.debank.com/image/era_token/logo_url/0x5aea5775959fbc2557cc8789bc1bf90a239d9a91/61844453e63cf81301f845d7864236f6.png",
      "primaryColor": "#3498db",
      "tokenCategory": "token",
      "iid": "arb:0x82af49447d8a07e3bd95bd0d56f35241523fbab1",
    }
  ]
}