Quick start
The API base URL is https://api.coinverum.com. Endpoints use HTTPS and return JSON. No API key is currently required for reasonable read-only use.
Use the OpenAPI 3.1 document for agent and client discovery. Metric meaning and limitations are documented in the methodology.
Endpoints
GET /tokens
Token ranking with price, liquidity, volume and update time. Optional: ?category=stablecoin.
GET /tokens/{address}
Market record for an Ethereum token contract.
GET /tokens/{address}/pools
Qualifying pools containing a token.
GET /tokens/{address}/candles
OHLC candles. Queries: resolution=1m|5m|1h|1d and limit.
GET /tokens/{address}/depth
Estimated V2 constant-product depth and price impact.
GET /search?q={query}
Token search by symbol, name or contract address.
GET /pools?limit=100
Pools ranked by TVL. Optional DEX implementation filter.
GET /dexes
DEX comparison and aggregate Ethereum totals.
GET /dexes/{dex}?days=30
Venue metrics, daily series, versions and top pools.
GET /health
API status, server timestamp and uptime.
Interpretation rules
- Ethereum addresses are lowercase contract addresses unless stated otherwise.
- USD fields are numeric estimates based on the current indexed market state.
- DEX TVL responses expose tvl_source, tvl_block and tvl_updated_at provenance.
- Rolling metrics should be cited with the response timestamp or updated_at value.
- Null change values mean a valid historical baseline is unavailable, not zero change.
- Active addresses are observed senders, not verified human users.
Usage and attribution
Cache responses where practical and avoid aggressive polling. When publishing a live metric, link to the most specific CoinVerum page or endpoint and identify it as Ethereum mainnet on-chain data with the observation time.
The service is provided without a guarantee of completeness or uninterrupted availability. Review the Terms of Service before building a dependency on the API.
Need execution and event intelligence?
Premium liquidity shocks, whale flow, execution analysis and liquidation context are available per request through the x402 USDC data API.