Skip to content
POST AI agent ready /v1/exchange/search

Crypto Search API - Find Coins by Name or Symbol

Searches the cryptocurrency registry for coins matching your query. Returns the coin ID (used in other endpoints), full name, ticker symbol, and market cap rank. Ideal for building autocomplete inputs, coin pickers, and search-driven crypto UIs.

Parameters

stringrequired

Search query matching coin name or ticker symbol.

Code examples

curl -X POST https://api.botoi.com/v1/exchange/search \
  -H "Content-Type: application/json" \
  -d '{"query":"ethereum"}'

When to use this API

Autocomplete coin picker in trading UIs

As the user types in a coin search field, query this endpoint with debounced input (150-300ms). Display matching coins with their name, symbol, and rank. When the user selects a coin, pass its ID to the crypto price endpoint to fetch live data.

Coin directory and exploration pages

Build a searchable directory of cryptocurrencies. Let users browse coins by name, filter by market cap rank, and click through to detailed pages showing live prices, charts, and market data.

Portfolio import with fuzzy matching

When a user pastes a list of coin names or symbols from a spreadsheet, use this endpoint to resolve each entry to a canonical coin ID. Handle ambiguous entries (e.g., "ETH" matching both Ethereum and Ethereum Classic) by showing the user a disambiguation picker.

Frequently asked questions

Can I search by ticker symbol?
Yes. The query matches against both the coin name and ticker symbol. Searching "btc" will return Bitcoin, and searching "ethereum" will return Ethereum.
How do I use the coin ID from the results?
The id field (e.g., "ethereum") is used as the coin parameter in the crypto price endpoint. Search for a coin here, then pass its ID to get live price data.
Are new coins added automatically?
The coin registry updates regularly. New coins listed on major exchanges appear within days of their listing. Very new or micro-cap coins may take longer to appear.
What does market_cap_rank represent?
The market_cap_rank is the coin's global ranking by market capitalization. Rank 1 is Bitcoin, rank 2 is Ethereum, and so on. This helps users quickly assess a coin's relative size and importance.
Is the search case-sensitive?
No. The search is case-insensitive. "Bitcoin", "bitcoin", and "BITCOIN" all return the same results.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs