DEX token info
GET
https://open-api.coinworldcap.com/openapi/v1/dex/tokens/info
One DEX token in full: its price, liquidity, market cap and figures by window, holder count, links, risk level and the asset we match it to.
Query parameters
chain_slugstringDefaultrequiredSee naming a tokenaddressstringDefaultrequired
Response
The token is looked up in Trending, then New, then Gainers, then the shorter-window lists; the
first list holding it supplies its figures and data_time. A token no list holds any more is
served from the last copy we kept of it: lists is [], stale is false however old it is,
and data_time is when it was last listed.
| Field | Type | Notes |
|---|---|---|
data_time |
string | When the list that supplied the token was built, or when a token no list holds was last listed |
stale |
boolean | That list is more than two hours old |
id, chain_slug, address, symbol, name, logo |
string | As on /dex/tokens |
lists |
array | Every list holding the token now, in the order trending, new, gainers |
asset_id |
number or null |
The id of the asset we match the token to, the id of /assets and /quotes; null when there is none |
price, liquidity, market_cap, fdv |
string or null |
USD, as on /dex/tokens |
percent_change, windows, last_trade_time, inactive, risk_level |
As on /dex/tokens. The 24-hour volume is windows["24h"].volume |
|
holders_count |
number or null |
Holders of the token |
links |
object | website, x, telegram: each a URL, or "" when there is none |
Examples
bash
curl -H "X-Api-Key: <your-api-key>" \
"https://open-api.coinworldcap.com/openapi/v1/dex/tokens/info?chain_slug=base&address=0x07b3d902783c3c12b077508c3b5c00113d1291d0"
| HTTP status | code |
When |
|---|---|---|
| 400 | 40000 | chain_slug or address missing |
| 404 | 40400 | No list holds the token and we kept no copy of it, or the chain does not exist — check chain_slug's case. Almost always permanent: a failed read of the kept copy (other than a timeout) also answers 404 |
| 503 | 50300 | No Trending list younger than three hours; or reading the copy of a token no list holds timed out (retryable) |
The other errors are in Errors.