Search tokens on a chain
Symbol, name or address. What it searches depends on chain:
- 4663 Robinhood Chain: the curated list (verified: true, stocks tagged stock) plus every token that traded in the last 24 hours and is not on it (verified: false, no logo; named on-chain when no list knows it).
- 5042 Arc: every token traded in the last 24 hours, the same index as /arc/tokens/search. verified is true for tokens on the curated Arc list.
- 43114 / 8453 / 56 / 42161 / 1: that chain's token list (verified: true) plus every token traded on it in the last 24 hours with at least $500 of volume, or any traded token by its address (verified: false, no logo; tokens the scam screen hides from boards are left out of a name search). A chain that is not public yet answers 404 CHAIN_NOT_PUBLIC unless the request carries an X-API-Key.
- no chain, or 143: Monad off-list discovery. Tokens found through DexScreener that are not on the curated Monad list, with a logo and on-chain decimals, all verified: false. This mode answers { tokens } only, returns up to 8 rows whatever limit says, and returns an empty list for a query under 2 characters.
- 143 (or no chain) with listed=1: Monad like the other chains, { chain, q, tokens }: the curated Monad list first (verified: true), then the off-list discovery rows (verified: false, after every listed match whatever their rank), limit honoured. The off-list half waits at most 3 seconds.
Ranking: the exact address, then the exact symbol, a symbol prefix, a name prefix, then any substring; verified rows first within a rank, one row per address. A leading $ is ignored. Treat verified: false as unvetted and check the address before trading it.
Arc: /arc/tokens/search returns full board rows (price, volume, pools, flags) for the same query.
Request
- Base URL: https://api.getchord.xyz/v1
- URL: https://api.getchord.xyz/v1/tokens/search
- Auth: none declared
Query parameters
Symbol, name or address fragment.
Chain id: 4663 Robinhood Chain · 5042 Arc · 43114 Avalanche C-Chain · 8453 Base · 56 BNB Chain · 42161 Arbitrum One · 1 Ethereum · 143 Monad. Omitted = 143. Pass the chain you want: the default is Monad off-list discovery.
Rows to return, clamped to 1–25. Ignored in Monad off-list mode.
Monad only: 1 = the curated list first, then the off-list tokens.
Response
Matches, best first. An empty tokens is a real answer.
Changes
No recorded changes to this operation across all 2 revisions of this API.