API Endpoints

Liquidity History - Pair

get
https://public-api.birdeye.so/defi/v3/liquidity/history/pair

Retrieve point-in-time historical liquidity snapshots for a Solana trading pair. Maximum 100 records.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

The address of a pair contract

integer
0 to 10000000000

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

integer
0 to 9007199254740991

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

integer
1 to 9007199254740991

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.

boolean
Defaults to 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.

string
enum
Defaults to back

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

Allowed:
integer
1 to 100
Defaults to 1

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

Headers
string
enum
Defaults to solana

Solana network only.

Allowed:
Responses

Updated about 1 month ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago

Did this page help you?