/tokens - Request supported tokens by a swap provider

The /tokens endpoint provides a list of tokens for a specified provider. This endpoint requires a query parameter to determine which provider's tokens you want to retrieve.

Method: GET

URL: https://crunchy-testing.dorito.club/api/tokens provider=CHAINFLIP_STREAMING

Example Request

curl -X 'GET' \
  'https://chrunchy.dorito.club/tokens?provider=CHAINFLIP' \
  -H 'accept: application/json'

Example shortened response

{
  "provider": "CHAINFLIP",
  "name": "CHAINFLIP",
  "timestamp": "2025-01-11T16:31:04.355Z",
  "version": {
    "major": 1,
    "minor": 0,
    "patch": 0
  },
  "keywords": [],
  "count": 10,
  "tokens": [
    {
      "chain": "BTC",
      "chainId": "bitcoin",
      "ticker": "BTC",
      "identifier": "BTC.BTC",
      "symbol": "BTC",
      "name": "Bitcoin",
      "decimals": 8,
      "logoURI": "https://crispy.sfo3.cdn.digitaloceanspaces.com/btc.btc.png",
      "coingeckoId": "bitcoin"
    },
    {
      "chain": "ARB",
      "chainId": "42161",
      "ticker": "ETH",
      "identifier": "ARB.ETH",
      "symbol": "ETH",
      "name": "Arbitrum Ether",
      "decimals": 18,
      "logoURI": "https://crispy.sfo3.cdn.digitaloceanspaces.com/arb.eth.png",
      "coingeckoId": "ethereum"
    },
    {
      "chain": "SOL",
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "chainId": "solana",
      "ticker": "USDC",
      "identifier": "SOL.USDC-EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "symbol": "USDC-EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "name": "Solana USDC",
      "decimals": 6,
      "logoURI": "https://crispy.sfo3.cdn.digitaloceanspaces.com/sol.usdc-epjfwdd5aufqssqem2qn1xzybapc8g4weggkzwytdt1v.png"
    },
    ...
  ]
}

Response fields

The relevant response fields are:

Field	Type	Description
chain	string	The blockchain the token is associated with (e.g., ETH, BTC, SOL).
address	string	The contract address of the token (only provided if it is not the gas token of the network).
chainId	string	The ID of the chain. It could be a numeric ID (e.g., 42161 for Arbitrum) or a name like solana.
ticker	string	The ticker symbol of the token (e.g., ETH, BTC).
identifier	string	An identifier for the token that combines chain and token address, used to identify the token in dKit API.
symbol	string	The token symbol, which includes address information.
name	string	The full name of the token.
decimals	string	The number of decimal places the token supports.
logoURl	string	A URL pointing to the token's logo image.
coingeckoId	string	The identifier of the token on CoinGecko (if available).

Notes

• The identifier is what dKit uses to uniquely identify a token in all its requests and responses. It includes the chain, the name and the token address. It is how the token should be named when using the /quoteendpoint.

  • The identifier is built by putting together Chain.Ticker-ContractAddress (e.g., "ETH.USDC-0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48").

  • Gas assets like BTC, ETH or SOL don't require a contract address, so their identifier is just BTC.BTCfor example.

• Tokens with an address field are specific instances of a token on a given chain (e.g., USDC on Ethereum or Solana). While the coingeckoIdcould be shared, we provide the relevant contract address for the token in the specific chain.