← THE CHARTSPOD LEDGEROPEN TERMINAL →
DATA · DEX SCREENER TOKEN-POOLS

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

The token-pairs endpoint returns every pool for a token. Some pools come back with partial data; how you treat the gaps changes which pool looks like the main market.

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

Short answer

DEX Screener's token-pairs endpoint returns a list of pair objects for a chain and token address. In the published Pair schema, txns and volume are always present (zero means no activity in that window), while priceUsd, liquidity (and liquidity.usd), fdv, marketCap and pairCreatedAt can be null (unknown). An empty list means no pools were found for that address on that chain. When choosing the main pool, rank only pools with known liquidity and flag the rest for checking rather than placing them last.

Fields and what missing values mean

FieldNull / absent meansZero / empty means
liquidity.usdLiquidity unknown (e.g. no USD pricing)—
priceUsdNo USD price available—
txns.h24.buys—No buys in 24h
volume.h24—No volume in 24h
Response list—Empty: no pools for address
Dex Screener Token-Pools: how to read each fieldDex Screener Token-Pools: how to read each field: liquidity.usd — Liquidity unknown (e.g. no USD pricing); priceUsd — No USD price available; txns.h24.buys — No buys in 24h; volume.h24 — No volume in 24h; Response list — Empty: no pools for address.liquidity.usdLiquidity unknown (e.g. no USD pricing)priceUsdNo USD price availabletxns.h24.buysNo buys in 24hvolume.h24No volume in 24hResponse listEmpty: no pools for address
Dex Screener Token-Pools: missing vs zero, field by field. Original ChartsPod editorial graphic.

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

Open a ChartsPod workspace

Handling policy

Policy for this sourcePolicy for this source: Rank pools by known liquidity only; Flag null-liquidity pools for manual check; Treat zero txns as inactive, not unknown; Empty list: verify chain and address; Store pairAddress with every row.POLICY FOR THIS SOURCERank pools by known liquidity onlyFlag null-liquidity pools for manual checkTreat zero txns as inactive, not unknownEmpty list: verify chain and addressStore pairAddress with every row
Apply this policy to every dex screener token-pools request. Original ChartsPod editorial graphic.

Illustrative: of 6 pools returned, one has liquidity.usd null but 900 transactions in 24h. Ranking it last as '$0 liquidity' would hide what may be an active pool quoted in a token without USD pricing.

Conclusion

Related: DEX Screener API: Find Token Pools by Chain and Contract Address, DEX Screener Pair Data: Null vs Zero - Handle Missing Fields Correctly.

When choosing the main pool, rank only pools with known liquidity and flag the rest for checking rather than placing them last.

Review DEX Screener Token-Pool Data with bar replay before using it live.

Open ChartsPod replay

Questions readers ask

What does null liquidity mean on a pool?

Unknown, often because USD pricing is unavailable.

What does an empty token-pairs response mean?

No pools found for that address on that chain.

Are txns ever null?

Not in the published Pair schema.

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