Discovery and markets API
Every address carrying one public label
All the addresses on one chain carrying a public label (an exchange, a protocol, a fund), paged 50 at a time.
/api/external/discovery/label-addresses/{chain}What it returns
All the addresses on this chain that carry one public label, found with label-search: pass its slug as label and its kind as kind. 50 addresses per page, in ascending order; pass nextCursor back as cursor until it is null. An unknown label, or one with no address on this chain, answers an empty list.
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-addresses/ETH?label=<label>&kind=name"
| Parameter | Description |
|---|---|
labelquery · string · required | The label id — a slug from label-search. |
kindquery · string · required | The label kind, as label-search answered it for this label.namegenericprotocolclassifiernote |
cursorquery · string · optional | An opaque cursor from a previous response's nextCursor, for the next page. It only pages the chain, label and kind it was issued for; anything else is a 400. |
chainpath · 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.
| Field | Type | Description |
|---|---|---|
label | string | The label asked about. |
kind | string | Its kind. |
addresses | string[] | Lower-cased, ascending. A real empty array when no address carries the label here. |
nextCursor | string | null | Pass back as cursor for the next page. null on the last page. |
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