Discovery and markets API

Find public address labels by name

Search the public address labels (exchanges, bridges, protocols, deposit wallets) by name on one chain, each with a few of the addresses carrying it.

GET/api/external/discovery/label-search/{chain}

Get a free API key Try it in the API reference

What it returns

The public labels — exchanges, bridges, protocols, funds, known deposit wallets — whose name has a word starting with q, case-insensitively, among the labels present on this chain. Each comes with up to five of the addresses carrying it here; label-addresses lists them all. At most one page of matches exists: when truncated is true, a longer q reaches the rest. No match answers an empty list. For the labels of one known address, see wallet-labels.

Chains

Ethereum ETH
Base BASE
Celo CELO
Arbitrum ARB
Optimism OP

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -H "x-dex-data-key: $DEXDATA_API_KEY" \
  "https://api.dexdata.io/api/external/discovery/label-search/ETH?q=<q>"

Parameters
Parameter	Description
`q` query · string · required	The text to find, 2-64 characters besides leading and trailing spaces. Each word matches the start of a word in a label: `binan` finds "Binance", `inance` finds nothing.
`kinds` query · string · optional	Comma-separated label kinds to search, any of `name`, `generic`, `protocol`, `classifier`, `note`; all of them when absent. `name` is an entity's own name, `generic` a category such as "exchange", `protocol` a protocol it belongs to, `classifier` a behaviour class, `note` a remark.
`chain` path · string · required	ETH, BASE, ARB, OP or CELO; every other chain returns 400.

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of Find public address labels by name
Field	Type	Description
`labels`	object[]	Highest-ranked first. A real empty array when nothing matched on this chain.
`labels[].slug`	string	The label's id; pass it to `label-addresses` as `label`.
`labels[].name`	string	The display name.
`labels[].kind`	string	The label kind; pass it to `label-addresses` as `kind`.
`labels[].ordinal`	integer	The rank labels are listed by; higher first.
`labels[].sampleAddresses`	string[]	Up to five of the addresses carrying this label on this chain, lower-cased; the full list when there are fewer than five.
`truncated`	boolean	More labels matched than are listed; search with a longer `q` to reach them.

Price per call

Ethereum, Base, Celo, Arbitrum, Optimism: 1 credit

Charged only when the call succeeds. Prices as of 2026-10-30; the current ones are always in the API reference.

Find a token by name, symbol or address
Same inputs: chain, q.
Find an NFT collection by name
Same inputs: chain, q.
Every address carrying one public label
Every address carrying a label this search found.
Who a wallet is
The labels of one address already known, rather than a search by name.
Which tokens is smart money trading on this chain?
Tokens smart wallets traded over 1d/7d/30d on one chain: smart-wallet count per risk cohort, net USD flow (buys minus sells), buy and sell volume, price, liquidity, cap.
Which recurring-order (DCA) programs run on this chain?
The dollar-cost-averaging programs on Solana whose orders the DCA endpoints report, each with its on-chain program address.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key