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

# Currency Search (Typeahead)

`GET /search/currencies`

Token search / typeahead for source and destination pickers. Filtered to chains we can quote against. Cacheable for 5 minutes (Cache-Control: max-age=300). 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 (exact symbol → prefix → name → substring → address-prefix). May be empty.

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

## Other responses

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

---

[API](https://skmtc.net/coinvoyage/apis/coinvoyage-api.md) · [All operations](https://skmtc.net/coinvoyage/apis/coinvoyage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coinvoyage/coinvoyage-api/revisions/29e628200554/schema)