← THE CHARTSPOD LEDGEROPEN TERMINAL →
DATA · DEX MARKET CAP

DEX Token Market-Cap Data: Null vs Zero - Handle Missing Fields Correctly

DEX market-cap fields depend on circulating supply that may be self-reported or unverified. A null market cap is often deliberate.

By ChartsPod Editorial Team · Reviewed by ChartsPod Research
Published · Updated · 5 min read

Short answer

CoinGecko's onchain API returns market_cap_usd as null for unverified tokens, and fdv_usd can also be null. DEX Screener's marketCap and fdv are nullable; when no circulating supply is supplied, its market cap equals FDV. So a null market cap usually means the provider declined to compute one without verified supply — not zero value. Don't backfill nulls with FDV silently; label which figure you are using and where its supply came from.

Fields and what missing values mean

FieldNull / absent meansZero / empty means
market_cap_usd (CoinGecko)Null for unverified tokens—
fdv_usdCan be null—
marketCap (DEX Screener)Nullable—
marketCap = fdvNo circulating supply supplied—
Supply sourceSelf-reported or provider—
Dex Market Cap: how to read each fieldDex Market Cap: how to read each field: market_cap_usd (CoinGecko) — Null for unverified tokens; fdv_usd — Can be null; marketCap (DEX Screener) — Nullable; marketCap = fdv — No circulating supply supplied; Supply source — Self-reported or provider.market_cap_usd (CoinGecko)Null for unverified tokensfdv_usdCan be nullmarketCap (DEX Screener)NullablemarketCap = fdvNo circulating supply suppliedSupply sourceSelf-reported or provider
Dex Market Cap: missing vs zero, field by field. Original ChartsPod editorial graphic.

Put DEX Token Market-Cap Data next to price, flow and positioning in one workspace.

Open a ChartsPod workspace

Handling policy

Policy for this sourcePolicy for this source: Keep null as null; Label FDV substitutions; Record supply source; Compare with liquidity; Note verification status.POLICY FOR THIS SOURCEKeep null as nullLabel FDV substitutionsRecord supply sourceCompare with liquidityNote verification status
Apply this policy to every dex market cap request. Original ChartsPod editorial graphic.

Illustrative: a dashboard shows a market cap for every token by filling nulls with FDV. A token with 90% of supply locked appears ten times larger than its circulating value.

Conclusion

Related: DEX Pool Reserve Data: Null vs Zero - Handle Missing Fields Correctly, Self-Reported Circulating Supply: How to Read the Number Before a Swap.

Don't backfill nulls with FDV silently; label which figure you are using and where its supply came from.

Review DEX Token Market-Cap Data with bar replay before using it live.

Open ChartsPod replay

Questions readers ask

Why is CoinGecko's market cap null?

It returns null for unverified tokens.

Why does DEX Screener market cap equal FDV?

No separate circulating supply was supplied.

Should I fill null market cap with FDV?

Only with a clear label.

Sources and methodology

Field definitions come from DEX Screener's API reference, CoinGecko's onchain API documentation and Binance's Spot API documentation, read 17 October 2026. Where a schema was not visible in the documentation, this guide says so and describes defensive handling rather than asserting field behaviour.

  1. CoinGecko onchain API: Top pools by token address (pool schema) — pool fields and nullability (fdv_usd, market_cap_usd, reserve_in_usd).
  2. DEX Screener: Token listing — listing after first liquidity and trade; supply inputs.
  3. DEX Screener: API reference — token and pair endpoints, nullable fields, rate limits.

This article explains research tools and workflows. It is not financial advice, does not recommend buying or selling any asset and does not predict prices. Crypto derivatives carry a risk of rapid and total loss of margin.

CHARTSPOD EDITORIAL EDITION · RESEARCH AND EDUCATION ONLY · NOT FINANCIAL ADVICE.