---
title: "Search tokens"
method: GET
path: "/tokens"
tags: ["Tokens"]
---

# Search tokens

`GET /tokens`

## Query parameters

- `pageSize` integer
- `page` integer
- `term` string
- `chain` string
- `mainnet` boolean
- `hasCex` boolean
- `hasDex` boolean
- `address` string
- `symbol` string
- `unverified` boolean
- `hasSelfPrivate` boolean

## Response `200`

Success

- TokenSearchResult
  - `tokens` Token[], required
    - `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
  - `total` number, double, required
  - `totalPages` number, double, required

## Other responses

- `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)