Price stats (Single)

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

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

fetch('https://public-api.birdeye.so/defi/v3/price/stats/single', 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
}

GET

defi

price

stats

single

Price stats (Single)

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

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

fetch('https://public-api.birdeye.so/defi/v3/price/stats/single', 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

Price stats for one token across selected timeframes.

Returns current price, high, low, and price-change percent for each 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 the token supports scaled UI amount extension.

Reading the numbers. price_change_percent compares the current price with the selected timeframe window. high and low are the highest and lowest prices inside that timeframe.

Compute Unit ⚙️

This endpoint consumes 5 CU per request.

Use Cases 💡

Build compact price-stat cards with current price, high, low, and percentage change.
Power alert thresholds across short and medium timeframes without fetching full candles.
Rank tokens by price momentum across the exact windows your product cares about.
Add high/low context to watchlists, token profile headers, and trading widgets.

How to Use 🛠️

Provide address as the token address and set x-chain.
Pass list_timeframe=1m,1h,24h or another set of up to 3 supported timeframes.
Set ui_amount_mode=raw or scaled consistently with your Token-2022 price handling.
Use OHLCV endpoints when you need full candle series instead of summary stats.

Best Practices ✅

Use price stats for lightweight momentum widgets and alerts.
Keep timeframe sets consistent across tokens when ranking or comparing performance.
Combine price stats with volume and liquidity data before treating price movement as meaningful.

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

address

string

required

The address of the token contract.

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

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