# Search > Prefix search over token names and symbols, and exact match on token, pool, wallet and hook addresses and v4 pool ids. Source: https://docs.crius.sh/reference/discovery/search/ · Updated 2026-10-28 GET https://api.crius.sh/v1/{chain}/search Prefix search over token names and symbols, and exact match on token, pool, wallet and hook addresses and v4 pool ids. `type` narrows the result kind; up to 20 results. > Prefix on name / symbol, exact on address / pool id. ## Path parameters `chain`stringrequired Chain slug (`robinhood`) or chain id (`4663`). ## Query parameters `q`string Default `shoot` Search text: a name or symbol prefix, or an exact address / pool id. `type`string Filter by item type. Comma list of `token`, `pool`, `wallet`, `hook`. `limit`integer Default `10` Maximum number of items to return. Up to 20. ## Guides that use this endpoint [**Build a Telegram token scanner bot for Robinhood Chain**Build a Telegram bot that scans Robinhood Chain tokens: price, liquidity, holders, taxes and a security score from two Crius API calls, with real examples.](https://docs.crius.sh/guides/build-a-telegram-token-scanner/)[**Search Robinhood Chain tokens, pools and wallets by name or address**Find a Robinhood Chain token's address by name or symbol, or look up any address or Uniswap v4 pool id, with one search call. Real responses included.](https://docs.crius.sh/guides/search-tokens/)[**Use the Crius API from AI agents (OpenAPI, llms.txt, MCP)**Give an AI agent Robinhood Chain data: Crius docs as llms.txt and Markdown, tool definitions from the OpenAPI document, an MCP server, and accuracy tips.](https://docs.crius.sh/guides/use-crius-with-ai-agents/)[**How to create a token on Robinhood Chain (launchpads compared)**The ways to create a token on Robinhood Chain: Pons, Flap.sh, Bankr, Long.xyz, Flywheel, King of the Markets or your own ERC-20, compared with real launch data.](https://docs.crius.sh/guides/create-a-token-on-robinhood-chain/)[**Robinhood Chain API for AI agents**Give an AI agent Robinhood Chain data with the Crius API: which endpoints to expose as tools, the OpenAPI document, structured errors and citing the block.](https://docs.crius.sh/use-cases/ai-agents/)[**Robinhood Chain API for Telegram and Discord bots**Build a Robinhood Chain token scanner, buy bot or launch-alert channel for Telegram or Discord with the Crius API, with real replies and credit costs.](https://docs.crius.sh/use-cases/telegram-and-discord-bots/)[**Robinhood Chain API for token screeners**Build a Robinhood Chain token screener with the Crius API: new, trending and graduating lists, batch profiles, candles and risk badges, with credit costs.](https://docs.crius.sh/use-cases/token-screeners/) ## Errors Errors come back as `{ "error": { "code", "message" } }` with the matching HTTP status: `400` bad parameter, `401` missing or invalid key, `403` endpoint above your plan, `404` unknown token or address, `429` rate limit or credits used up (with `Retry-After`). See [Errors](https://docs.crius.sh/errors/). ## More discovery & search endpoints [GET/tokensToken listsAnonymous · 1 cr](https://docs.crius.sh/reference/discovery/token-lists/) Request No key needed **cURL** ```bash curl "https://api.crius.sh/v1/robinhood/search?q=charge&limit=3" \ -H "x-api-key: $CRIUS_API_KEY" ``` **JavaScript** ```js const res = await fetch("https://api.crius.sh/v1/robinhood/search?q=charge&limit=3", { headers: { "x-api-key": process.env.CRIUS_API_KEY }, }); const { data, meta } = await res.json(); ``` **Python** ```python import os, requests r = requests.get( "https://api.crius.sh/v1/robinhood/search?q=charge&limit=3", headers={"x-api-key": os.environ["CRIUS_API_KEY"]}, ) body = r.json() print(body["data"]) ``` Response 200 · captured Oct 28, 2026 ```json { "data": [ { "address": "0x7b8892cea949bc60d494681d1bc3ea96071ab0b8", "label": null, "launchpad": "pons", "launchpad_name": "Pons", "links": { "discord": null, "farcaster": null, "github": null, "telegram": null, "twitter": "https://x.com/chargeairh", "website": "https://chargeai.bid/" }, "liquidity_usd": 5611.81, "logo": "https://api.crius.sh/v1/robinhood/logo/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8.png?size=128", "name": "Charge AI", "price_usd": 0.00000388948, "symbol": "CHARGE", "type": "token" }, { "address": "0x202e72dcbc815ca222f1a0674dd08755545b1329", "label": null, "launchpad": "pons", "launchpad_name": "Pons", "links": { "discord": null, "farcaster": null, "github": null, "telegram": null, "twitter": "https://x.com/chargeitdotfun", "website": "https://chargeit.fun/" }, "liquidity_usd": 4869.43, "logo": "https://api.crius.sh/v1/robinhood/logo/0x202e72dcbc815ca222f1a0674dd08755545b1329.png?size=128", "name": "CHARGE", "price_usd": 0.00000293605, "symbol": "CHARGE", "type": "token" }, { "address": "0xc15f9324d2742387f98e2dba6b3745e5390113ec", "label": null, "launchpad": "pons", "launchpad_name": "Pons", "links": { "discord": null, "farcaster": null, "github": null, "telegram": null, "twitter": "https://x.com/chargeitdotfun", "website": "https://chargeit.fun/" }, "liquidity_usd": 2490.27, "logo": "https://api.crius.sh/v1/robinhood/logo/0xc15f9324d2742387f98e2dba6b3745e5390113ec.png?size=128", "name": "CHARGE", "price_usd": 0.00000683926, "symbol": "CHARGE", "type": "token" } ], "meta": { "block": 100406952, "block_age_ms": 1260, "block_ts": 1793225093000, "chain": "robinhood", "finalized_block": 100397649, "lag_ms": 11, "safe_block": 100401329 } } ``` [Report an issue](mailto:support@crius.sh?subject=Docs%20issue%3A%20GET%20%2Fv1%2F%7Bchain%7D%2Fsearch&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Freference%2Fdiscovery%2Fsearch%2F%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)