StatusTerminal
APIUse casesOracleMCP & AgentsSDKsSkillsChangelog

Typeahead across tokens and pairs

GET
/search

Matches token symbols and pair tickers. Address lookups are exact.

Query Parameters

q*string

symbol, ticker or address

Length1 <= length <= 128
chains?array<>

comma-separated chain slugs or ids; omit for every live chain

Itemsitems <= 32
limit?integer

maximum hits per kind

Formatint32
Range1 <= value <= 50
Default8

Header Parameters

Accept-Payment?string

payment methods the client can use, comma-separated, case-insensitive. With x402 in the list, a spent keyless budget answers 402 with the x402 challenge instead of 429.

PAYMENT-SIGNATURE?string

base64 x402 v2 payment payload for this request. A paid request skips the keyless budget and is settled only when it answers 2xx. The v1 header X-PAYMENT is accepted too.

Response Body

application/json

application/problem+json

application/problem+json

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/search?q=string"
{  "tokens": [    {      "address": "string",      "network": "hyperliquid",      "symbol": "string",      "name": "string",      "price_usd": 0.1,      "price_change_24h": 0.1,      "logo_url": "string"    }  ],  "pairs": [    {      "pair_address": "string",      "network": "hyperliquid",      "ticker": "string",      "base_symbol": "string",      "quote_symbol": "string",      "dex_name": "string",      "liquidity_usd": 0.1,      "price_usd": 0.1,      "price_change_24h": 0.1    }  ]}

Chains served right now GET

Only chains that produced a block within the last 24 hours. A chain missing here is not indexed at the moment; do not hardcode this list.

Liquidity pair screener GET

The screener. Filters compose with AND. Sorting by a metric reads the window given by `timeframe`; the composite boards (`popular`, `hottest`, `trending`) define their own and ignore it.