CoinWorldCap Developer Support Request a key

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

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.