---
title: "Get a token by its ID"
method: GET
path: "/tokens/{id}"
tags: ["Tokens"]
---

# Get a token by its ID

`GET /tokens/{id}`

## Path parameters

- `id` string, required

## Response `200`

Success

- Token
  - `icon` string, required
  - `id` string, required
  - `address` string, nullable
  - `chain` string, required
  - `decimals` number, double
  - `symbol` string
  - `name` string
  - `created` string, date-time, required
  - `modified` string, date-time
  - `chainData` Chain, required
    - `icon` string, required
    - `addressValidation` string, required
    - `tokenAddressValidation` string, required
    - `id` string, required
    - `created` string, date-time, required
    - `modified` string, date-time
    - `name` string, required
    - `shortName` string, required
    - `memoNeeded` boolean, nullable
    - `hashUrl` string
    - `explorerUrl` string, required
    - `addressUrl` string, required
    - `priority` number, double
    - `kind` string, required
    - `chainId` number, double, nullable
    - `enabled` boolean, required
    - `shortNameV1` string, required
  - `description` string, nullable
  - `mainnet` boolean
  - `enabled` boolean
  - `unverified` boolean
  - `hasDex` boolean
  - `hasCex` boolean
  - `hasSelfPrivate` boolean — Indicates if token supports private (self-to-self) swaps. Stored field computed when token is saved. True when token has CEX support AND at least 2 enabled CEX swap provider mappings.
  - `cexTokenId` string
  - `rank` number, double, nullable
  - `cgId` string, nullable
  - `marketCapChange24h` number, double — 24h market cap change percentage from CoinGecko.
  - `circulatingSupply` number, double — Token circulating supply from CoinGecko.
  - `price` number, double, nullable
  - `marketCap` number, double, nullable
  - `volume` number, double, nullable
  - `fdv` number, double, nullable
  - `change` number, double, nullable
  - `priority` number, double, nullable
  - `warningMessage` string

## Other responses

- `404` — Token not found
- `422` — Validation Failed
- `500` — Internal Server Error

---

[API](https://skmtc.net/houdiniswap/apis/houdiniswap-backend.md) · [All operations](https://skmtc.net/houdiniswap/apis/houdiniswap-backend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/houdiniswap/houdiniswap-backend/revisions/2063dbc88d59/schema)