Price stats (Multiple)

curl --request POST \
  --url https://public-api.birdeye.so/defi/v3/price/stats/multiple \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "list_address": "So11111111111111111111111111111111111111112,DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
}
'

import requests

url = "https://public-api.birdeye.so/defi/v3/price/stats/multiple"

payload = { "list_address": "So11111111111111111111111111111111111111112,DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" }
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    list_address: 'So11111111111111111111111111111111111111112,DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263'
  })
};

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

{
  "data": [
    {
      "address": "So11111111111111111111111111111111111111112",
      "is_scaled_ui_token": false,
      "data": [
        {
          "unix_time_update_price": 1751419434,
          "time_frame": "1m",
          "price": 147.37122560933628,
          "price_change_percent": -0.023923362896247174,
          "high": 147.48709093365915,
          "low": 147.31438207414254
        },
        {
          "unix_time_update_price": 1751419434,
          "time_frame": "5m",
          "price": 147.37122560933628,
          "price_change_percent": 0.8046203174783053,
          "high": 147.55458435764513,
          "low": 146.0332035916541
        }
      ]
    }
  ],
  "success": true
}

POST

defi

price

stats

multiple

Price stats (Multiple)

curl --request POST \
  --url https://public-api.birdeye.so/defi/v3/price/stats/multiple \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "list_address": "So11111111111111111111111111111111111111112,DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
}
'

import requests

url = "https://public-api.birdeye.so/defi/v3/price/stats/multiple"

payload = { "list_address": "So11111111111111111111111111111111111111112,DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" }
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    list_address: 'So11111111111111111111111111111111111111112,DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263'
  })
};

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

{
  "data": [
    {
      "address": "So11111111111111111111111111111111111111112",
      "is_scaled_ui_token": false,
      "data": [
        {
          "unix_time_update_price": 1751419434,
          "time_frame": "1m",
          "price": 147.37122560933628,
          "price_change_percent": -0.023923362896247174,
          "high": 147.48709093365915,
          "low": 147.31438207414254
        },
        {
          "unix_time_update_price": 1751419434,
          "time_frame": "5m",
          "price": 147.37122560933628,
          "price_change_percent": 0.8046203174783053,
          "high": 147.55458435764513,
          "low": 146.0332035916541
        }
      ]
    }
  ],
  "success": true
}

Usage Note
Accessibility
Chain Supported

Batch price stats for multiple tokens across selected timeframes.

Request body accepts token addresses through list_address.
Maximum batch size is 20 unique token addresses per request.
Returns current price, high, low, and price-change percent for each token and requested timeframe.
list_timeframe accepts comma-separated values such as 1m, 5m, 30m, 1h, 2h, 4h, 8h, 24h, 2d, 3d, and 7d.
Request up to 3 timeframes per call.
ui_amount_mode=scaled applies Solana Token-2022 scaled UI amount when tokens support scaled UI amount extension.

Compute Unit ⚙️

Batch CU is calculated as ceil(5 * count^0.8).

Use Cases 💡

Refresh price-stat tables for many tokens in one request.
Power screeners that rank multiple tokens by price change, high/low range, and current price.
Evaluate watchlists for momentum alerts across shared timeframes.
Build compact market boards without fetching full OHLCV series for every token.

How to Use 🛠️

Set x-chain for the target network.
Send token addresses in the request body and pass list_timeframe in the query.
Keep the timeframe list consistent across all tokens in the batch.
Set ui_amount_mode=raw or scaled consistently with your Token-2022 price handling.

Best Practices ✅

Use this endpoint for batch dashboards and alert scans where high/low and percentage change are enough.
Combine batch price stats with batch market data when ranking both momentum and market quality.
Deduplicate token addresses before requesting batch stats.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

A chain name listed in supported networks.

Available options:

solana,

ethereum,

bsc,

base,

robinhood,

sui,

mantle,

hyperevm,

arbitrum,

avalanche,

optimism,

polygon,

zksync,

monad,

aptos,

fogo,

megaeth

Query Parameters

list_timeframe

string

A list of time frames seprated by comma (,). List of supported time frames: 1m, 5m, 30m, 1h, 2h, 4h, 8h, 24h, 2d, 3d, 7d

ui_amount_mode

enum<string>

default:raw

Indicate whether to use the scaled amount for scaled ui amount tokens. Only support solana

Available options:

raw,

scaled,

both

Body

application/json

list_address

string

default:So11111111111111111111111111111111111111112,DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

required

Response

JSON object containing list of price stats of tokens

success

boolean

required

Whether the request completed successfully.

data

object[]

required

Array of price-stat rows for the requested token set and timeframes.

Show child attributes