← THE CHARTSPOD LEDGEROPEN TERMINAL →
DATA · DEX POOL RESERVES

DEX Pool Reserve Data: Null vs Zero - Handle Missing Fields Correctly

Pool reserve values in USD depend on pricing both tokens. When one can't be priced, the USD reserve can be null even though the pool holds tokens.

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

Short answer

CoinGecko's onchain pool data includes reserve_in_usd, which can be null, while transaction counts and volume are always present (zero means no activity). DEX Screener's liquidity and liquidity.usd are also nullable. A null reserve means the USD value is unknown — often because a token in the pool has no reliable price — not that the pool is empty. Sorting pools by reserve with nulls as 0 hides them; flag them and check token amounts directly.

Fields and what missing values mean

FieldNull / absent meansZero / empty means
reserve_in_usd (CoinGecko)USD value unknown—
liquidity.usd (DEX Screener)USD value unknown—
transactions—0: no trades in window
volume—0: no volume
Pool missingNot indexed or wrong address—
Dex Pool Reserves: how to read each fieldDex Pool Reserves: how to read each field: reserve_in_usd (CoinGecko) — USD value unknown; liquidity.usd (DEX Screener) — USD value unknown; transactions — 0: no trades in window; volume — 0: no volume; Pool missing — Not indexed or wrong address.reserve_in_usd (CoinGecko)USD value unknownliquidity.usd (DEX Screener)USD value unknowntransactions0: no trades in windowvolume0: no volumePool missingNot indexed or wrong address
Dex Pool Reserves: missing vs zero, field by field. Original ChartsPod editorial graphic.

Check DEX Pool Reserve Data against a live market before relying on it.

Try it in ChartsPod

Handling policy

Policy for this sourcePolicy for this source: Never sort nulls as zero; Check raw token reserves; Flag unpriced tokens; Compare pools with known reserves; Record source and time.POLICY FOR THIS SOURCENever sort nulls as zeroCheck raw token reservesFlag unpriced tokensCompare pools with known reservesRecord source and time
Apply this policy to every dex pool reserves request. Original ChartsPod editorial graphic.

Illustrative: a pool with reserve_in_usd null holds 400 ETH against an unpriced token. Ranked last as '$0', it was actually the deepest pool for that pair.

Conclusion

Related: DEX Token Market-Cap Data: Null vs Zero - Handle Missing Fields Correctly, Multiple Pools for One Token: How to Read the Number Before a Swap.

Sorting pools by reserve with nulls as 0 hides them; flag them and check token amounts directly.

Compare DEX Pool Reserve Data across Binance, Bybit, OKX and Hyperliquid markets.

Open markets in ChartsPod

Questions readers ask

Does a null reserve mean an empty pool?

No; the USD value is unknown.

Are transactions ever null?

Not in the CoinGecko schema; 0 means none.

What should I check instead?

Raw token reserves.

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: 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.