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.

GET/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"
Parameters
ParameterDescription
label

query · string · required

The label id — a slug from label-search.
kind

query · string · required

The label kind, as label-search answered it for this label.namegenericprotocolclassifiernote
cursor

query · 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.
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 Every address carrying one public label
FieldTypeDescription
labelstringThe label asked about.
kindstringIts kind.
addressesstring[]Lower-cased, ascending. A real empty array when no address carries the label here.
nextCursorstring | nullPass 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