Price - Birdeye Data

Price

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

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

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

{
  "data": {
    "isScaledUiToken": false,
    "value": 0.38622452197470425,
    "updateUnixTime": 1745058945,
    "updateHumanTime": "2025-04-19T10:35:45",
    "priceChange24h": 1.933391934259418,
    "priceInNative": 0.0027761598581298626,
    "liquidity": 10854103.37938592
  },
  "success": true
}

GET

defi

price

Price

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

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

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

{
  "data": {
    "isScaledUiToken": false,
    "value": 0.38622452197470425,
    "updateUnixTime": 1745058945,
    "updateHumanTime": "2025-04-19T10:35:45",
    "priceChange24h": 1.933391934259418,
    "priceInNative": 0.0027761598581298626,
    "liquidity": 10854103.37938592
  },
  "success": true
}

Usage Note
Accessibility
Chain Supported

Single-token spot price lookup.

Always use the checksum contract address on EVM chains and the canonical token mint address on Solana-like chains.
include_liquidity=true adds liquidity context to the latest price snapshot when available.
Response may be null or omit fields if the token is unknown, unsupported, or not yet indexed on the selected chain.
Solana and EVM responses can differ slightly because token metadata and liquidity sources differ by chain.
Cache or poll this endpoint conservatively when rendering dashboards, bots, or watchlists.

Compute Unit ⚙️

This endpoint consumes 3 CU per request.

Use Cases 💡

Fetch the latest token price for portfolio rows, token details, and watchlist cards.
Power alerts, bots, and automations that react to live price movement.
Enrich trade, liquidity, and holder dashboards with a current spot-price anchor.
Provide quick price checks before deeper calls such as OHLCV, price stats, or market-data lookups.

How to Use 🛠️

Set x-chain for the target network.
Pass one token address in address.
Enable include_liquidity=true when you want price plus nearby liquidity context in the same call.
Handle null price payloads gracefully for newly listed or unsupported tokens.

Best Practices ✅

Reuse cached token metadata and decimals so this endpoint only needs to answer price, not identity.
Pair the latest price with historical or OHLCV endpoints when you need context, not just the current mark.
For large token sets, move to Price - Multiple instead of looping single-token requests.

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

check_liquidity

number

Specify the liquidity value to check.

include_liquidity

enum<boolean>

Specify whether to include liquidity in the response.

Available options:

true,

false

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 price value and update time of a token

success

boolean

required

Whether the request completed successfully.

data

object

required

Show child attributes