New APIs: Token Liquidity History – Track Solana Token Liquidity Over Time

Birdeye Data now provides 3 Solana token liquidity APIs for historical OHLC liquidity candles, historical liquidity snapshots, and latest liquidity lookup. Developers can use these endpoints to build liquidity charts, token monitoring dashboards, DeFi data products, and market analytics without running custom liquidity indexers.

What’s New?

The Token Liquidity History APIs give builders 3 liquidity views for different product needs: charting historical liquidity movement, reading point-in-time liquidity snapshots, and checking the latest liquidity state across token lists.

Liquidity OHLC – Token: GET /defi/v3/liquidity/ohlc/token

• address: Query historical liquidity candles for a specific Solana token.
• liquidity values: Return OHLC series for total liquidity, exit liquidity, and stable liquidity.
• resolution: Select 1m, 4h, or 1D candle resolution.
• time / direction / count: Navigate historical records with cursor-style pagination.
• record limit: Return up to 100 liquidity candles per request.
• use case: Build liquidity candlestick charts, liquidity volatility views, liquidity-based token screeners, and research tools that compare liquidity behavior around price movement.
• best practice: Use this endpoint when movement inside each interval matters. Choose 1m for short-window monitoring, 4h for intraday dashboards, and 1D for long-term trend analysis.

Liquidity History – Token: GET /defi/v3/liquidity/history/token

• address: Query historical liquidity snapshots for a specific Solana token.
• snapshot values: Return liquidity snapshots from the open value of each liquidity candle.
• metrics: Include total liquidity, exit liquidity, stable liquidity, and total pair count.
• resolution: Select 1m, 4h, or 1D intervals.
• record limit: Return up to 100 historical snapshots per request.
• use case: Build time-series dashboards, liquidity retention views, pair-count monitoring, liquidity expansion charts, and token health models that need stable point-in-time values.
• best practice: Use this endpoint when your product needs one liquidity value per interval instead of candle movement. It is a clean fit for line charts, data tables, alert backtesting, and models that compare liquidity state across time.

Liquidity Latest – Token: POST /defi/v3/liquidity/latest/token

• addresses: Retrieve latest liquidity data for unique Solana token addresses.
• latest values: Return total liquidity, exit liquidity, stable liquidity, and token price.
• batch lookup: Lite packages can request 1 address. Starter and higher packages can request up to 100 unique addresses.
• x-chain: Uses the Solana chain header. These endpoints currently support Solana only.
• use case: Build token list enrichment, portfolio risk checks, discovery feeds, watchlists, market scanners, and pre-trade liquidity checks.
• best practice: Batch addresses when enriching token lists or watchlists. Use the latest endpoint for current-state reads, then call the historical endpoints only when a user opens a token detail page or a system needs historical context.

Historical liquidity data is available from January 1, 2024.

Why Solana Token Liquidity History Matters

Liquidity is one of the core signals behind token markets. Price charts show where a token traded, but liquidity history shows how much depth supported that market over time.

The 3 endpoints are designed to work together. A token terminal can use Liquidity Latest – Token to enrich a token list, Liquidity History – Token to draw a clean liquidity line chart, and Liquidity OHLC – Token to inspect how liquidity opened, moved, and closed inside each interval.

This helps developers move beyond static liquidity numbers. Applications can track liquidity expansion, analyze market depth around volatility, compare stable liquidity versus exit liquidity, monitor pair-count changes, and surface tokens whose liquidity profile is changing before price alone tells the full story.

Solana Liquidity API Use Cases and Best Practices

• Use the latest endpoint for scanning: Query POST /defi/v3/liquidity/latest/token when you need current liquidity across many tokens. This keeps token lists, watchlists, and scanners focused on current state.
• Use history for stable time-series views: Query GET /defi/v3/liquidity/history/token when each interval needs one clean value. This works well for line charts, daily reports, and alert logic.
• Use OHLC for liquidity movement: Query GET /defi/v3/liquidity/ohlc/token when liquidity movement inside each interval matters. This works well for candlestick-style liquidity charts and volatility analysis.
• Choose resolution by product context: Use 1m for active monitoring, 4h for intraday analysis, and 1D for longer-term liquidity trends.
• Cache historical pages: Historical endpoints return up to 100 records per request. Cache completed backfill windows and only refresh the latest window for production dashboards.
• Respect the package limit: Lite plans support 1 address for the latest endpoint. Starter and higher packages support up to 100 unique addresses per request.

Common Builder Questions

What is the best API for a Solana token liquidity chart?

Use Liquidity History – Token for line charts that need one liquidity value per interval. Use Liquidity OHLC – Token when the chart needs open, high, low, and close liquidity values for each interval.

What is the best API for scanning current token liquidity?

Use Liquidity Latest – Token when your application needs the latest total liquidity, exit liquidity, stable liquidity, and token price across token addresses. Starter and higher packages support up to 100 unique addresses per request.

What liquidity history is available?

The historical liquidity endpoints support 1m, 4h, and 1D resolutions, return up to 100 records per request, and provide Solana token liquidity history from January 1, 2024.

Start Building

Build Solana liquidity charts, token monitoring systems, and market analytics with Birdeye Data today.

To get started, visit the Birdeye Data Dashboard or explore the Token Liquidity History APIs.

About Birdeye Data 

Birdeye Data is a high-performance data provider that delivers real-time, accurate, and comprehensive on-chain data across tokens, wallets, trades, and protocols on Solana, Sui and major EVM chains. From fast-moving startups to global leaders like Phantom, Raydium, Coinbase, and Bybit, Birdeye Data powers teams of all sizes with the data they need to build and scale confidently.

Stay connected with us: Website | X | Docs | Blog | Telegram