---
title: "Search Tokens"
method: GET
path: "/api/v1/developer/tokens/search"
tags: ["TOKENS", "DEVELOPER"]
---

# Search Tokens

`GET /api/v1/developer/tokens/search`

## Query parameters

- `q` string, required — The query string to search in name and symbol. Performs a case-insensitive substring search.
- `chain` string — The chain of the tokens. Do not pass anything to search across all tokens.
- `sort` 'volume' | 'trade_count' | 'fully_diluted_valuation' — Sort by a certain field
- `granularity` '1d' | '1h'
- `order` 'asc' | 'desc' — Sorting order
- `limit` integer — Maximum number of tokens to return.
- `volume_usd_1d_threshold` number — Minimum 1d volume in USD. Only returns tokens with volume >= this value.
- `volume_usd_1h_threshold` number — Minimum 1h volume in USD. Only returns tokens with volume >= this value.

## Response `200`

Successful Response

- Token[]
  - `object` 'token'
  - `chain` string, required — Lowercase chain name
  - `address` string, required — Token contract address
  - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
  - `price` number, nullable — Current price (USD)
  - `decimals` integer, nullable — Token decimal places
  - `info` TokenInfo
    - `name` string, required — Token name
    - `symbol` string, required — Token symbol
  - `attributes` TokenAttributes
    - `total_liquidity_usd` LiquidityResults
      - `amount` number, nullable — Liquidity amount (USD)
      - `details` string, nullable — Status when amount unavailable (e.g. LIQUIDITY_TOO_HIGH)
    - `price_diff_1d` number, nullable — Price change (USD) over last 24h
    - `price_diff_pct_1d` number, nullable — Price change (%) over last 24h
    - `price_diff_1h` number, nullable — Price change (USD) over last 1h
    - `price_diff_pct_1h` number, nullable — Price change (%) over last 1h
    - `total_supply` number, nullable — Total token supply
    - `fully_diluted_valuation_usd` number, nullable — Fully diluted valuation (USD)
    - `volume_1h` number, nullable — Trading volume over last 1h
    - `volume_1d` number, nullable — Trading volume over last 24h
    - `volume_usd_1h` number, nullable — Trading volume (USD) over last 1h
    - `volume_usd_1d` number, nullable — Trading volume (USD) over last 24h
    - `volume_24h` number, nullable — Trading volume over last 24h
    - `volume_usd_24h` number, nullable — Trading volume (USD) over last 24h
    - `trade_count_1h` integer, nullable — Trade count over last 1h
    - `trade_count_1d` integer, nullable — Trade count over last 24h
    - `all_time_high` number, nullable — All-time high price (USD)
    - `all_time_low` number, nullable — All-time low price (USD)
    - `image_url` string, nullable — Token logo URL
    - `token_creation_time` string, date-time, nullable — Token creation timestamp (UTC)
    - `holders_count` integer, nullable — Number of token holders
    - `stellar_fields` object, nullable — Stellar-specific metadata

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/allium/apis/allium-account-api.md) · [All operations](https://skmtc.net/allium/apis/allium-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/allium/allium-account-api/versions/6c79c032c85d/schema)