Discovery and markets API

Which known on-chain entities belong to this category?

The labelled entities of one category (exchanges, funds, bridges, market makers, ...) with website, X profile, logo and how many addresses each controls.

GET/api/external/discovery/entity-directory

Get a free API key Try it in the API reference

What it returns

The labelled entities of one category — exchanges, funds, protocols, bridges, market makers and more — each with its website, X profile, logo and the number of on-chain addresses attributed to it. The category is its id (centralized_exchange, decentralized_exchange, fund, bridge, mev, stablecoin, ...) or its display name, in any case. category.total is how many entities the category holds; at most 100 come back in one answer, and truncated is true when the rest were left out. A category no directory knows returns 404; a real but empty category returns an empty list.

Chains

This endpoint is not tied to a chain: it takes no chain in its request.

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-directory"

Parameters
Parameter	Description
`category` query · string · optional	The category, by id or display name, e.g. `fund` or `Fund`. Defaults to centralized_exchange.

Response fields

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

Response fields of Which known on-chain entities belong to this category?
Field	Type	Description
`category`	object
`category.id`	string	The category id answered.
`category.name`	string	Its display name, e.g. `Centralized Exchange`.
`category.total`	integer	Entities in the category, including any left out of this answer.
`truncated`	boolean	True when the category holds more than the 100 entities this answer can carry.
`entities`	object[]	The entities, by id. Can be empty.
`entities[].id`	string	The entity id, e.g. `binance`, `uniswap`.
`entities[].name`	string	The entity's name, e.g. `Binance`.
`entities[].description`	string \| null	One line on what the entity does. Null when none is published.
`entities[].websiteUrl`	string \| null	The entity's website.
`entities[].twitterUrl`	string \| null	The entity's X (Twitter) profile.
`entities[].logoUrl`	string \| null	The entity's logo. Null for most entities.
`entities[].addresses`	integer \| null	On-chain addresses attributed to the entity. `0` means none is attributed yet, not unknown; null only when the figure is missing.

Price per call

Every call: 50 credits

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

Which public companies or governments hold this coin, and how much?
The other directory of named holders: the public companies and governments holding a coin.
Which addresses belong to this known entity on this chain?
The directory names the entity and its id; this lists that entity's addresses on one chain.
Is each liquid-staking ETH token trading at, above or below its redemption rate?
Every liquid-staking ETH token: the ETH its contract redeems it for, the ETH the market pays, the gap in percent and the protocol fee. No chain, no input.
What is this tokenized stock, ETF or commodity worth, and where does it trade?
One tokenized real-world asset by id, ticker or name: its tokens with market caps, and every venue quoting them with price, 24 h volume and spread.
How has this tokenized stock, ETF or commodity moved over time?
One tokenized real-world asset's price, market cap and 24 h volume over 1 to 365 days, oldest first, in USD. The window sets the spacing.
Tokenized asset history brief: the trend in a few points
At most 60 points of price, market cap and volume over 1 to 365 days, plus the price change, high and low.

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