> For the complete documentation index, see [llms.txt](https://docs.eldorito.club/dkit-by-eldorito/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eldorito.club/dkit-by-eldorito/dkit-api/tokens-request-supported-tokens-by-a-swap-provider.md).

# /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 <a href="#notes" id="notes"></a>

* 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 `/quote`endpoint.
  * 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.BTC`for 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 `coingeckoId`could be shared, we provide the relevant contract address for the token in the specific chain.