Discovery and markets API
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.
/api/external/discovery/rwaWhat it returns
One tokenized real-world asset by id, ticker or name (nvidia, NVDA, NVIDIA): the tokens that represent it with their market caps, and every venue quoting them with price, 24 h volume and bid-ask spread, plus the totals. Figures are USD. A venue that publishes no spread or no trade stamp answers null, never 0, and each quote carries the flags for an outlier or a stale price. A ticker or name shared by more than one asset resolves to none: pass the id. An asset the source does not list returns 404.
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/rwa"
| Parameter | Description |
|---|---|
assetquery · string · optional | The asset, by id, ticker or name, e.g. nvidia, NVDA, gold. Defaults to nvidia. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
id | string | The asset answered, by id, lowercase. |
symbol | string | The asset's ticker, e.g. nvda. |
name | string | The asset's name, e.g. NVIDIA. |
assetType | string | What the asset is. |
imageUrl | string | null | Link to the asset's logo. |
lastUpdated | integer | null | Unix seconds the asset was last refreshed upstream. |
marketCapUsd | number | null | What every token of this asset is worth together, in USD. |
volume24hUsd | number | null | What traded across every venue in the last 24 h, in USD. |
tokens | object[] | Each token representing the asset, largest market cap first. Can be empty. |
tokens[].id | string | The token, by coin id, e.g. nvidia-xstock. |
tokens[].marketCapUsd | number | null | The token's market capitalisation, in USD. |
venues | object[] | Each venue quoting a token. Can be empty. |
venues[].market | string | The venue quoting the pair, e.g. Kraken. |
venues[].tokenId | string | null | The token quoted here, by coin id. Null when the venue names none. |
venues[].base | string | Base asset of the pair as the venue writes it. |
venues[].target | string | Quote asset of the pair as the venue writes it. |
venues[].priceUsd | number | null | Last price here, converted to USD. |
venues[].volumeUsd | number | null | Volume here over the last 24 h, converted to USD. |
venues[].spreadPercent | number | null | Bid-ask spread here, in percent (0.1 = 0.1%). |
venues[].isAnomaly | boolean | Whether this quote is flagged an outlier. |
venues[].isStale | boolean | Whether this quote is flagged stale. |
venues[].lastTradedAt | integer | null | Unix seconds of the last trade seen here. |
venues[].tradeUrl | string | null | Link to the pair on the venue. |
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