Discovery and markets API
Which tokenized real-world assets lead by market cap and volume right now?
Tokenized stocks, ETFs, gold and silver ranked by their tokens' market cap or 24h volume in USD, with price and 24h and 7d change.
/api/external/discovery/rwasWhat it returns
Tokenized real-world assets — stocks, ETFs and two commodities, gold and silver — ranked by the market cap or the 24h volume of their tokens on chain, in USD, up to 250. Every figure is the tokens' own market, not the underlying asset's: a tokenized stock's market cap is the value of its tokens, not of the company. About a quarter of the assets are not updated every day: updatedAt says how old each row is, and its 24h change is null when it is over a day old.
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/rwas"
| Parameter | Description |
|---|---|
sortquery · string · optional | What to rank by: the tokens' market-cap or 24h volume, largest first. Defaults to market-cap.market-capvolume |
typequery · string · optional | Only one asset type: stock, etf or commodity (gold and silver). Defaults to all.allstocketfcommodity |
limitquery · integer · optional | How many assets to return, 1-250. Defaults to 50. limit ≤ 80 keeps the answer under 32 KB. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
sort | string | The ranking answered. |
type | string | The asset type answered. |
assets | object[] | Largest first; assets without the ranked figure last. |
assets[].id | string | The asset's id, e.g. nvidia or gold. Case matters. |
assets[].symbol | string | null | Ticker of the underlying, lowercase, e.g. nvda, xau. |
assets[].name | string | null | Display name. |
assets[].type | string | null | stock, etf or commodity. |
assets[].imageUrl | string | null | Logo URL. |
assets[].priceUsd | number | null | Price of the tokens, in USD. |
assets[].marketCapUsd | number | null | Market cap of the asset's tokens on chain, in USD: what is tokenized, not the company or the commodity. Null when unknown. |
assets[].volumeUsd24h | number | null | 24h volume of the asset's tokens, in USD. 0 is a real idle day. |
assets[].priceChangePercent24h | number | null | Price change over 24h, in percent (1.5 = +1.5%). Null when the asset was not updated in the last 24h. |
assets[].priceChangePercent7d | number | null | Price change over 7 days, in percent. |
assets[].updatedAt | integer | null | When the figures were last updated, unix seconds. Can be days old. |
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