> ## Documentation Index
> Fetch the complete documentation index at: https://data.birdeye.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Pair - Pair Overview (Multiple)
> Retrieve stats of multiple pairs. Maximum 20 addresses.
Batch market snapshots for multiple liquidity pairs.
Pass pair addresses as a comma-separated list in list\_address.
Maximum batch size is 20 pair addresses per request.
Returns pair-level stats for indexed pairs on the selected SVM chain.
Use this endpoint when comparing or monitoring a set of known pairs.
Business
Enterprise
Solana, Fogo
Batch CU is calculated as ceil(15 \* pair\_count^0.8).
Compare liquidity, volume, and wallet activity across multiple pairs.
Build pool watchlists and DEX analytics dashboards.
Monitor candidate pools for listing, routing, or risk decisions.
Score several pools for the same token to find where real activity is concentrated.
Set x-chain to a supported SVM chain.
Pass list\_address as comma-separated pair addresses.
Use the single endpoint for pair detail pages and the multiple endpoint for dashboards or screeners.
Batch known pairs together when refreshing pool tables.
Deduplicate pair addresses and keep chain selection consistent.
Join pair overviews with token metadata to render readable base/quote context.
## OpenAPI
````yaml openapi/data/openapi_docs.json GET /defi/v3/pair/overview/multiple
openapi: 3.1.0
info:
version: 1.1.0
title: Birdeye Data API
description: >-
Birdeye Data API is a full-spectrum blockchain and DEX data platform for
teams that need production-grade crypto market intelligence across tokens,
pairs, wallets, traders, protocols, and chains.
From real-time prices, OHLCV, liquidity, and transaction flow to holder
analytics, token and pair overviews, wallet portfolio and PnL, smart money,
discovery, security, and blockchain-level utilities, Birdeye gives you a
unified data layer for building serious crypto products at scale.
Use it to power exchange interfaces, trading terminals, bots, market-making
systems, quant research, alpha screeners, portfolio apps, wallet
intelligence tools, alerting systems, analytics dashboards, and back-office
data pipelines. Whether your users are retail traders, pro desks, analysts,
or infrastructure teams, Birdeye helps you ship faster with broad market
coverage and API surfaces that support both lightweight integrations and
data-heavy workflows.
To start, create an account at [bds.birdeye.so](https://bds.birdeye.so),
generate an API key from the `Security` tab, and send it in the `X-API-KEY`
header on every request.
servers:
- url: https://public-api.birdeye.so
security:
- apiKeyAuth: []
tags:
- name: Price & OHLCV
- name: Stats
- name: Token/Market List
- name: Transactions
- name: Wallet, Networth & PnL
- name: Balance & Transfer
- name: Holder
- name: Alltime & History
- name: Blockchain
- name: Account
- name: Token
- name: Transaction
- name: Creation & Trending
- name: Meme
- name: Security
- name: Search & Utils
- name: Smart Money
- name: Global Fees Paid
- name: DEX & Protocol
- name: Wallet Identity
paths:
/defi/v3/pair/overview/multiple:
get:
tags:
- Stats
summary: Pair - Pair Overview (Multiple)
description: Retrieve stats of multiple pairs. Maximum 20 addresses.
operationId: get-defi-v3-pair-overview-multiple
parameters:
- $ref: '#/components/parameters/xSVMChainParam'
- $ref: '#/components/parameters/listPairAddressParam'
- $ref: '#/components/parameters/uiAmountModeSplitParam'
responses:
'200':
$ref: '#/components/responses/PairOverviewMultiple'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'429':
$ref: '#/components/responses/429'
'500':
$ref: '#/components/responses/500'
components:
parameters:
xSVMChainParam:
name: x-chain
description: SVM networks only.
in: header
required: false
schema:
type: string
enum:
- solana
- fogo
default: solana
listPairAddressParam:
name: list_address
description: A list of pair contract addresses in string separated by commas (,)
in: query
required: true
schema:
type: string
examples:
solana:
value: >-
4DoNfFBfF7UokCC2FQzriy7yHK6DY6NVdYpuekQ5pRgg,D3gZwng2MgZGjktYcKpbR8Bz8653i4qCgzHCf5E4TcZb
ethereum:
value: >-
0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640,0x4f493B7dE8aAC7d55F71853688b1F7C8F0243C85
uiAmountModeSplitParam:
name: ui_amount_mode
description: >-
Indicate whether to use the scaled amount for scaled ui amount tokens.
Only support solana
in: query
required: false
schema:
type: string
enum:
- raw
- scaled
default: scaled
responses:
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
message: Bad request
'401':
description: Unauthorized. API key is missing or invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
message: Unauthorized
'403':
description: Forbidden. Request is blacklisted or not whitelisted
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
message: Access Denied
'429':
description: Too Many Requests. Rate limit reached
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
message: Too many requests
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
message: Internal Server Error
PairOverviewMultiple:
description: JSON object containing overview of multiple markets
content:
application/json:
schema:
$ref: '#/components/schemas/PairOverviewMultipleResponse'
examples:
SolanaScaledUIAmount:
value:
success: true
data:
4DoNfFBfF7UokCC2FQzriy7yHK6DY6NVdYpuekQ5pRgg:
address: 4DoNfFBfF7UokCC2FQzriy7yHK6DY6NVdYpuekQ5pRgg
base:
address: So11111111111111111111111111111111111111112
decimals: 9
icon: >-
https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png
symbol: SOL
is_scaled_ui_token: false
multiplier: 1
created_at: '2023-02-28T03:00:02.253Z'
name: SOL-USDC
quote:
address: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
decimals: 6
icon: >-
https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png
symbol: USDC
is_scaled_ui_token: false
multiplier: 1
source: Phoenix
liquidity: 2798754.646440928
liquidity_change_percentage_24h: null
price: 185.2259461756374
trade_24h: 1088
trade_24h_change_percent: -16.628352490421456
trade_history_24h: 1305
unique_wallet_24h: 183
unique_wallet_24h_change_percent: -39.40397350993378
volume_24h: 3960934.260889339
volume_24h_base: 21735.928
volume_24h_change_percentage_24h: null
volume_24h_quote: 3961073.7718080003
volume_12h: 2371020.4454601924
volume_12h_base: 12961.386
volume_12h_quote: 2371101.2224080004
volume_1h: 167126.90920284906
volume_1h_base: 902.8530000000001
volume_1h_quote: 167127.603103
volume_2h: 528203.5824244855
volume_2h_base: 2859.9010000000003
volume_2h_quote: 528219.775809
volume_30m: 111882.67078251604
volume_30m_base: 604.808
volume_30m_quote: 111883.36210299999
volume_4h: 848002.9830474032
volume_4h_base: 4613.238
volume_4h_quote: 848022.866258
volume_8h: 2042469.7997546664
volume_8h_base: 11160.507
volume_8h_quote: 2042534.6387080003
trade_12h: 531
trade_12h_change_percent: -4.838709677419355
trade_1h: 33
trade_1h_change_percent: -62.06896551724138
trade_2h: 120
trade_2h_change_percent: 118.18181818181819
trade_30m: 9
trade_30m_change_percent: -60.86956521739131
trade_4h: 175
trade_4h_change_percent: -16.666666666666664
trade_8h: 385
trade_8h_change_percent: 41.02564102564102
trade_history_12h: 558
trade_history_1h: 87
trade_history_2h: 55
trade_history_30m: 23
trade_history_4h: 210
trade_history_8h: 273
unique_wallet_12h: 112
unique_wallet_12h_change_percent: 19.148936170212767
unique_wallet_1h: 14
unique_wallet_1h_change_percent: -44
unique_wallet_2h: 30
unique_wallet_2h_change_percent: 57.89473684210527
unique_wallet_30m: 4
unique_wallet_30m_change_percent: -66.66666666666666
unique_wallet_4h: 39
unique_wallet_4h_change_percent: -29.09090909090909
unique_wallet_8h: 83
unique_wallet_8h_change_percent: 29.6875
D3gZwng2MgZGjktYcKpbR8Bz8653i4qCgzHCf5E4TcZb:
address: D3gZwng2MgZGjktYcKpbR8Bz8653i4qCgzHCf5E4TcZb
base:
address: DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
decimals: 5
icon: >-
https://arweave.net/hQiPZOsRZXGXBJd_82PhVdlM_hACsT_q6wqwf5cSY7I
symbol: Bonk
is_scaled_ui_token: false
multiplier: 1
created_at: '2024-07-12T14:46:26.639Z'
name: Bonk-USDC
quote:
address: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
decimals: 6
icon: >-
https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png
symbol: USDC
is_scaled_ui_token: false
multiplier: 1
source: Openbook V2
liquidity: 1558.0205178030249
price: 0.00004579600000000001
trade_24h: 5
trade_24h_change_percent: null
unique_wallet_24h: 1
unique_wallet_24h_change_percent: null
volume_24h: 0.29397628302
PairOverviewMultiple:
value:
data:
4DoNfFBfF7UokCC2FQzriy7yHK6DY6NVdYpuekQ5pRgg:
address: 4DoNfFBfF7UokCC2FQzriy7yHK6DY6NVdYpuekQ5pRgg
base:
address: So11111111111111111111111111111111111111112
decimals: 9
icon: >-
https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png
symbol: SOL
created_at: '2023-02-28T03:00:02.253Z'
name: SOL-USDC
quote:
address: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
decimals: 6
icon: >-
https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png
symbol: USDC
source: Phoenix
liquidity: 2919768.9610976744
liquidity_change_percentage_24h: null
price: 151.71133645655877
trade_24h: 16140
trade_24h_change_percent: 0.09302325581395349
trade_history_24h: 16125
unique_wallet_24h: 714
unique_wallet_24h_change_percent: -6.052631578947368
volume_24h: 19515805.77115872
volume_24h_base: 151900.454
volume_24h_change_percentage_24h: null
volume_24h_quote: 19516364.993035
volume_12h: 14684617.063818816
volume_12h_base: 113438.48700000001
volume_12h_quote: 14684998.902693
volume_1h: 1356675.6066384057
volume_1h_base: 10327.071000000004
volume_1h_quote: 1356683.9284229998
volume_2h: 2232212.0021702545
volume_2h_base: 16991.945000000003
volume_2h_quote: 2232241.2586139995
volume_30m: 523655.0599800013
volume_30m_base: 3981.183
volume_30m_quote: 523662.4028330001
volume_4h: 3075106.4318026183
volume_4h_base: 23345.053
volume_4h_quote: 3075154.5230179993
volume_8h: 11272364.380447734
volume_8h_base: 86701.32800000001
volume_8h_quote: 11272703.083117
trade_12h: 9371
trade_12h_change_percent: 38.37861783815712
trade_1h: 539
trade_1h_change_percent: -11.639344262295081
trade_2h: 1149
trade_2h_change_percent: 7.887323943661972
trade_30m: 190
trade_30m_change_percent: -45.24495677233429
trade_4h: 2217
trade_4h_change_percent: -46.01899196493791
trade_8h: 6305
trade_8h_change_percent: 25.273196900456984
trade_history_12h: 6772
trade_history_1h: 610
trade_history_2h: 1065
trade_history_30m: 347
trade_history_4h: 4107
trade_history_8h: 5033
unique_wallet_12h: 446
unique_wallet_12h_change_percent: 20.54054054054054
unique_wallet_1h: 38
unique_wallet_1h_change_percent: -47.94520547945205
unique_wallet_2h: 94
unique_wallet_2h_change_percent: -21.666666666666668
unique_wallet_30m: 15
unique_wallet_30m_change_percent: -54.54545454545454
unique_wallet_4h: 180
unique_wallet_4h_change_percent: -38.56655290102389
unique_wallet_8h: 386
unique_wallet_8h_change_percent: 83.80952380952381
C1MgLojNLWBKADvu9BHdtgzz1oZX4dZ5zGdGcgvvW8Wz:
address: C1MgLojNLWBKADvu9BHdtgzz1oZX4dZ5zGdGcgvvW8Wz
base:
address: JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN
decimals: 6
symbol: JUP
icon: https://static.jup.ag/jup/icon.png
created_at: '2024-01-31T14:08:39.146Z'
liquidity: 1291402.3208083548
name: JUP-SOL
price: 0.0030215825258950056
quote:
address: So11111111111111111111111111111111111111112
decimals: 9
icon: >-
https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png
symbol: SOL
source: Orca
trade_24h: 16976
trade_24h_change_percent: 22.367188063144237
trade_history_24h: 13873
unique_wallet_24h: 1868
unique_wallet_24h_change_percent: 5.4771315640880855
volume_24h: 2998320.1367637445
volume_24h_base: 8307023.787845001
volume_24h_quote: 23477.901777949002
volume_12h: 1582243.1498670643
volume_12h_base: 4375292.048774
volume_12h_quote: 12227.167014845001
volume_1h: 75628.73530529441
volume_1h_base: 208052.02779800005
volume_1h_quote: 575.6791885270002
volume_2h: 172632.39615841256
volume_2h_base: 475513.942617
volume_2h_quote: 1313.769798941
volume_30m: 34617.09208651915
volume_30m_base: 95027.32648300001
volume_30m_quote: 263.11625854299996
volume_4h: 386622.7153731848
volume_4h_base: 1056502.127324
volume_4h_quote: 2928.0495685820006
volume_8h: 1089995.4976091573
volume_8h_base: 3005766.9040460004
volume_8h_quote: 8368.885435305001
trade_12h: 9354
trade_12h_change_percent: 22.836506894287588
trade_1h: 417
trade_1h_change_percent: -31.862745098039213
trade_2h: 1029
trade_2h_change_percent: -9.973753280839896
trade_30m: 158
trade_30m_change_percent: -38.996138996138995
trade_4h: 2170
trade_4h_change_percent: -45.271122320302645
trade_8h: 6122
trade_8h_change_percent: 18.00308404009252
trade_history_12h: 7615
trade_history_1h: 612
trade_history_2h: 1143
trade_history_30m: 259
trade_history_4h: 3965
trade_history_8h: 5188
unique_wallet_12h: 1145
unique_wallet_12h_change_percent: 15.539858728557013
unique_wallet_1h: 118
unique_wallet_1h_change_percent: -41.29353233830846
unique_wallet_2h: 275
unique_wallet_2h_change_percent: 11.788617886178862
unique_wallet_30m: 53
unique_wallet_30m_change_percent: -36.904761904761905
unique_wallet_4h: 445
unique_wallet_4h_change_percent: -16.195856873822976
unique_wallet_8h: 826
unique_wallet_8h_change_percent: 6.033376123234917
success: true
schemas:
PairOverviewMultipleResponse:
type: object
required:
- success
- data
properties:
success:
type: boolean
description: Whether the request completed successfully.
data:
type: object
description: >-
Map keyed by pair address. Each value is the overview object for
that pair, or `null` when pair data is unavailable.
additionalProperties:
$ref: '#/components/schemas/PairOverviewObject'
ErrorResponse:
type: object
properties:
success:
type: boolean
message:
type: string
PairOverviewObject:
type: object
description: Overview metrics for one trading pair or market.
properties:
address:
type: string
description: Pair or market address.
base:
type: object
description: Metadata for one side of the pair.
properties:
address:
type: string
description: Token mint or contract address for this side of the pair.
decimals:
type: integer
description: Number of decimal places used by this token.
icon:
type: string
description: Logo image URL for this token.
symbol:
type: string
description: Ticker symbol for this token.
is_scaled_ui_token:
type: boolean
description: True when this token uses Solana Token-2022 scaled UI amounts.
multiplier:
type: number
description: >-
Scaled UI multiplier for this token when scaled UI metadata is
available.
additionalProperties: true
quote:
type: object
description: Metadata for one side of the pair.
properties:
address:
type: string
description: Token mint or contract address for this side of the pair.
decimals:
type: integer
description: Number of decimal places used by this token.
icon:
type: string
description: Logo image URL for this token.
symbol:
type: string
description: Ticker symbol for this token.
is_scaled_ui_token:
type: boolean
description: True when this token uses Solana Token-2022 scaled UI amounts.
multiplier:
type: number
description: >-
Scaled UI multiplier for this token when scaled UI metadata is
available.
additionalProperties: true
created_at:
type: string
format: date-time
description: Timestamp when the pair or market was first created or indexed.
name:
type: string
description: Display name of the pair, typically `BASE-QUOTE`.
source:
type: string
description: DEX, AMM, or venue that powers this pair.
liquidity:
type: number
description: Current pair liquidity in USD.
liquidity_change_percentage_24h:
type: number
nullable: true
description: Percentage change in pair liquidity versus 24 hours earlier.
price:
type: number
description: Latest pair price, typically quoted as base priced in quote.
trade_30m:
type: number
description: Total trade count during the latest 30m window.
trade_history_30m:
type: number
description: >-
Total trade count during the previous 30m window used for
comparison.
trade_30m_change_percent:
type: number
nullable: true
description: Percentage change in trade count versus the previous 30m window.
unique_wallet_30m:
type: number
description: >-
Number of distinct wallets that traded this pair during the latest
30m window.
unique_wallet_30m_change_percent:
type: number
nullable: true
description: >-
Percentage change in distinct trading wallets versus the previous
30m window.
volume_30m:
type: number
description: >-
Total traded volume in USD for the pair during the latest 30m
window.
volume_30m_base:
type: number
description: Base-token volume traded during the latest 30m window.
volume_30m_quote:
type: number
description: Quote-token volume traded during the latest 30m window.
trade_1h:
type: number
description: Total trade count during the latest 1h window.
trade_history_1h:
type: number
description: Total trade count during the previous 1h window used for comparison.
trade_1h_change_percent:
type: number
nullable: true
description: Percentage change in trade count versus the previous 1h window.
unique_wallet_1h:
type: number
description: >-
Number of distinct wallets that traded this pair during the latest
1h window.
unique_wallet_1h_change_percent:
type: number
nullable: true
description: >-
Percentage change in distinct trading wallets versus the previous 1h
window.
volume_1h:
type: number
description: Total traded volume in USD for the pair during the latest 1h window.
volume_1h_base:
type: number
description: Base-token volume traded during the latest 1h window.
volume_1h_quote:
type: number
description: Quote-token volume traded during the latest 1h window.
trade_2h:
type: number
description: Total trade count during the latest 2h window.
trade_history_2h:
type: number
description: Total trade count during the previous 2h window used for comparison.
trade_2h_change_percent:
type: number
nullable: true
description: Percentage change in trade count versus the previous 2h window.
unique_wallet_2h:
type: number
description: >-
Number of distinct wallets that traded this pair during the latest
2h window.
unique_wallet_2h_change_percent:
type: number
nullable: true
description: >-
Percentage change in distinct trading wallets versus the previous 2h
window.
volume_2h:
type: number
description: Total traded volume in USD for the pair during the latest 2h window.
volume_2h_base:
type: number
description: Base-token volume traded during the latest 2h window.
volume_2h_quote:
type: number
description: Quote-token volume traded during the latest 2h window.
trade_4h:
type: number
description: Total trade count during the latest 4h window.
trade_history_4h:
type: number
description: Total trade count during the previous 4h window used for comparison.
trade_4h_change_percent:
type: number
nullable: true
description: Percentage change in trade count versus the previous 4h window.
unique_wallet_4h:
type: number
description: >-
Number of distinct wallets that traded this pair during the latest
4h window.
unique_wallet_4h_change_percent:
type: number
nullable: true
description: >-
Percentage change in distinct trading wallets versus the previous 4h
window.
volume_4h:
type: number
description: Total traded volume in USD for the pair during the latest 4h window.
volume_4h_base:
type: number
description: Base-token volume traded during the latest 4h window.
volume_4h_quote:
type: number
description: Quote-token volume traded during the latest 4h window.
trade_8h:
type: number
description: Total trade count during the latest 8h window.
trade_history_8h:
type: number
description: Total trade count during the previous 8h window used for comparison.
trade_8h_change_percent:
type: number
nullable: true
description: Percentage change in trade count versus the previous 8h window.
unique_wallet_8h:
type: number
description: >-
Number of distinct wallets that traded this pair during the latest
8h window.
unique_wallet_8h_change_percent:
type: number
nullable: true
description: >-
Percentage change in distinct trading wallets versus the previous 8h
window.
volume_8h:
type: number
description: Total traded volume in USD for the pair during the latest 8h window.
volume_8h_base:
type: number
description: Base-token volume traded during the latest 8h window.
volume_8h_quote:
type: number
description: Quote-token volume traded during the latest 8h window.
trade_12h:
type: number
description: Total trade count during the latest 12h window.
trade_history_12h:
type: number
description: >-
Total trade count during the previous 12h window used for
comparison.
trade_12h_change_percent:
type: number
nullable: true
description: Percentage change in trade count versus the previous 12h window.
unique_wallet_12h:
type: number
description: >-
Number of distinct wallets that traded this pair during the latest
12h window.
unique_wallet_12h_change_percent:
type: number
nullable: true
description: >-
Percentage change in distinct trading wallets versus the previous
12h window.
volume_12h:
type: number
description: >-
Total traded volume in USD for the pair during the latest 12h
window.
volume_12h_base:
type: number
description: Base-token volume traded during the latest 12h window.
volume_12h_quote:
type: number
description: Quote-token volume traded during the latest 12h window.
trade_24h:
type: number
description: Total trade count during the latest 24h window.
trade_history_24h:
type: number
description: >-
Total trade count during the previous 24h window used for
comparison.
trade_24h_change_percent:
type: number
nullable: true
description: Percentage change in trade count versus the previous 24h window.
unique_wallet_24h:
type: number
description: >-
Number of distinct wallets that traded this pair during the latest
24h window.
unique_wallet_24h_change_percent:
type: number
nullable: true
description: >-
Percentage change in distinct trading wallets versus the previous
24h window.
volume_24h:
type: number
description: >-
Total traded volume in USD for the pair during the latest 24h
window.
volume_24h_base:
type: number
description: Base-token volume traded during the latest 24h window.
volume_24h_quote:
type: number
description: Quote-token volume traded during the latest 24h window.
volume_24h_change_percentage_24h:
type: number
nullable: true
description: >-
Percentage change in 24-hour USD volume versus the previous 24-hour
window.
additionalProperties: true
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: X-API-KEY
description: API key for authentication
````