dexdataSign in

Discovery and markets API

Which addresses belong to this known entity on this chain?

Every address attributed to one labelled entity (exchange, fund, protocol, ...) on one chain, each with its labels, such as hot wallet or cold wallet.

GET/api/external/discovery/entity-addresses/{chain}/{id}
Get a free API keyTry it in the API reference

What it returns

Every address attributed to one labelled entity (an exchange, a fund, a protocol, ...) on the chain asked, each with its labels, e.g. Binance: Hot Wallet. The id is the one entity-directory publishes. The list is complete, not a page: entity-directory counts the entity's addresses across every chain, so it can be larger than this chain's list. An entity with no address on the chain answers an empty addresses. An id no entity has returns 404.

Chains

  • BNB Chain BNB
  • Ethereum ETH
  • Base BASE
  • 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/entity-addresses/BNB/<id>"
Parameters
ParameterDescription
chain

path · string · required

The chain whose addresses of the entity are listed. ETH, BNB, BASE, ARB or OP; every other chain returns 400.
id

path · string · required

A labelled on-chain entity, by id (e.g. "binance", "uniswap") exactly as the entity directory publishes it, in any case — not its display name, and not a wallet or contract address.

Response fields

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

Response fields of Which addresses belong to this known entity on this chain?
FieldTypeDescription
entityobject
entity.idstringThe entity id, lowercase.
entity.namestringThe entity's name, e.g. Binance.
entity.typestring | nullThe kind of entity, e.g. Centralized Exchange. Null when none is published.
addressesobject[]One entry per address, in the order published. Empty when the entity has none on this chain.
addresses[].addressstringLowercase.
addresses[].labelsstring[]What the address is, main label first, e.g. Binance: Hot Wallet. Empty when it carries none.

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