Liquidity History - Pair

curl --request GET \
  --url https://public-api.birdeye.so/defi/v3/liquidity/history/pair \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/defi/v3/liquidity/history/pair', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "items": [
      {
        "unix_time": 1707348246,
        "block_number": 123456,
        "input_unix_time": 1707348245,
        "liquidity_usd": 101.21,
        "exit_liquidity_usd": 90.5,
        "base_amount": 966354838.709678,
        "quote_amount": 1.00123192,
        "base_price": 0,
        "quote_price": 101.08562267000286
      }
    ],
    "direction": "next",
    "limit": 10,
    "next_cursor": 1707348247,
    "prev_cursor": 1707348246,
    "has_more": true
  }
}

GET

defi

liquidity

history

pair

Liquidity History - Pair

curl --request GET \
  --url https://public-api.birdeye.so/defi/v3/liquidity/history/pair \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/defi/v3/liquidity/history/pair', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "items": [
      {
        "unix_time": 1707348246,
        "block_number": 123456,
        "input_unix_time": 1707348245,
        "liquidity_usd": 101.21,
        "exit_liquidity_usd": 90.5,
        "base_amount": 966354838.709678,
        "quote_amount": 1.00123192,
        "base_price": 0,
        "quote_price": 101.08562267000286
      }
    ],
    "direction": "next",
    "limit": 10,
    "next_cursor": 1707348247,
    "prev_cursor": 1707348246,
    "has_more": true
  }
}

Usage Note
Accessibility
Chain Supported

Historical pair liquidity snapshots on Solana.

Returns point-in-time liquidity snapshots for a trading pair.
Use either unix_time or block_number as the cursor; they are mutually exclusive.
Use step for sampled points and skip_empty to control repeated snapshots.
The endpoint returns up to 100 records per request.

Compute Unit ⚙️

This endpoint consumes 5 CU per request.
When count is provided, batch CU is calculated as ceil(5 × count^0.5).

Use Cases 💡

Track historical liquidity changes for a trading pair.
Build execution-quality, depth, and market-health dashboards.
Join pair liquidity history with price, trades, and OHLCV data.

How to Use 🛠️

Set x-chain=solana and pass the pair address.
Choose either a Unix timestamp or Solana slot as the cursor.
Use direction, step, and count to page or sample the history.

Best Practices ✅

Use block_number when the consumer is indexed by Solana slots.
Use unix_time for time-series charts and external market-data joins.
Keep count and step aligned with the chart resolution to avoid redundant points.

Limitations ⚠️

Solana only.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

Solana network only.

Available options:

solana

Query Parameters

address

string

required

The address of a pair contract

unix_time

integer

Unix timestamp in seconds. Mutually exclusive with block_number. Defaults to the latest available data when neither unix_time nor block_number is provided.

Required range: 0 <= x <= 10000000000

block_number

integer

Solana slot (block number) used as the cursor. Mutually exclusive with unix_time. Pagination cursors use slots when this parameter is supplied.

Required range: 0 <= x <= 9007199254740991

step

integer

Optional sampling interval in slots for a block_number cursor or seconds for a unix_time cursor. When omitted, returns actual historical snapshots without regular sampling. With skip_empty=false, each sampling point uses the latest snapshot at or before it. With skip_empty=true, repeated snapshots are skipped.

Required range: 1 <= x <= 9007199254740991

skip_empty

boolean

default:false

For step sampling, false fills each requested point with the latest snapshot at or before it. True skips repeated snapshots using the existing skip/dedup behavior.

direction

enum<string>

default:back

Direction to query liquidity records from the anchor time. Use back for older records and forward for newer records.

Available options:

back,

forward

count

integer

default:1

Maximum number of historical points returned. Defaults to 1 and is capped at 100. Batch CU is ceil(5 × count^0.5).

Required range: 1 <= x <= 100

Response

JSON object containing historical liquidity snapshots of a pair

success

boolean

required

Whether the request completed successfully.

data

object

required

Historical liquidity snapshots for the requested trading pair.

Show child attributes