Price Volume - Single

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

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

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

{
  "success": true,
  "data": {
    "isScaledUiToken": false,
    "price": 128.70426432642992,
    "updateUnixTime": 1726678569,
    "updateHumanTime": "2024-09-18T16:56:09",
    "volumeUSD": 755004403.5277437,
    "volumeChangePercent": -6.0377419970263055,
    "priceChangePercent": -2.6091746792986936
  }
}

GET

defi

price_volume

single

Price Volume - Single

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

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

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

{
  "success": true,
  "data": {
    "isScaledUiToken": false,
    "price": 128.70426432642992,
    "updateUnixTime": 1726678569,
    "updateHumanTime": "2024-09-18T16:56:09",
    "volumeUSD": 755004403.5277437,
    "volumeChangePercent": -6.0377419970263055,
    "priceChangePercent": -2.6091746792986936
  }
}

Usage Note
Accessibility
Chain Supported

Compact price-plus-volume snapshot for one token.

This endpoint returns current price plus rolling volume metrics without the heavier payload of OHLCV or full market data.
type defaults to 24h and also supports shorter windows such as 1h, 2h, 4h, and 8h.
Use this endpoint when you need a market snapshot card, not a full candle series.

Compute Unit ⚙️

This endpoint consumes 5 CU per request.

Use Cases 💡

Populate token cards with live price and rolling-volume context.
Power lightweight dashboards, watchlists, and mobile summary views.
Rank assets by recent activity without loading full OHLCV history.
Trigger alerts when price moves and volume expansion happen together.

How to Use 🛠️

Set x-chain for the target network.
Pass one token address in address.
Choose type for the rolling window you want summarized.
Move to OHLCV or historical-price endpoints if you need per-bucket detail.

Best Practices ✅

Use shorter windows for scanners and alerts, and longer windows for summary cards.
Keep the chosen timeframe visible in UI so users do not confuse 1h and 24h metrics.
Pair this endpoint with metadata and latest price for fast-loading token rows.

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

address

string

required

The address of the token contract.

type

enum<string>

default:24h

required

Time frame/interval.

Available options:

1h,

2h,

4h,

8h,

24h

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 price and volume with changes data of a token

success

boolean

required

Whether the request completed successfully.

data

object

required

Show child attributes