---
title: "Currency Search (Typeahead)"
method: GET
path: "/search/currencies"
tags: ["search"]
---

# Currency Search (Typeahead)

`GET /search/currencies`

## Request

- Base URL: `https://api.coinvoyage.io/v3`
- URL: `https://api.coinvoyage.io/v3/search/currencies`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/docs/search/currencies/get.ts> (a function with typed inputs; its response is checked against the schema)

Token search for source/destination pickers. Queries shorter than 2 characters return an empty list.

## Query parameters

- `q` string, required
- `chain_ids` string
- `limit` integer

## Headers

- `X-API-KEY` string, required

## Response `200`

Ranked currency matches (may be empty)

- CurrencySearchResponse
  - `currencies` Currency[], required
    - `id` string, required
    - `chain_id` 1 | 10 | 56 | 137 | 4663 | 8453 | 42161 | 20000000000001 | 20000000000002 | 30000000000001 | 30000000000002, required
    - `address` string, nullable
    - `symbol` string, required
    - `name` string
    - `decimals` integer, required
    - `image_uri` string, nullable
    - `chain_image_uri` string, nullable
    - `price_usd` number, nullable

## Other responses

- `401`: Unauthorized
- `429`: Per-IP rate-limit exceeded

## Changes

- **2026-10-13** `9b0a781499e3`: 1 warning
  - added the new `20000000000002.00` enum value to the `currencies/items/chain_id` response property for the response status `200`
- **2026-07-31** `9bac53bd1da7`: 1 breaking, 1 warning, 1 info
  - the response property `currencies/items/name` became optional for the status `200`
  - added the new `4663.00` enum value to the `currencies/items/chain_id` response property for the response status `200`
  - added the optional property `currencies/items/chain_image_uri` to the response with the `200` status

[Operation history](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/changes/search/currencies/get.md)

---

[API](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3.md) - [All operations](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/coinvoyage/apis/coinvoyage-api-v3/revisions/3535f46f4c27?raw)