Price - Historical

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

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

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

{
  "success": true,
  "data": {
    "isScaledUiToken": false,
    "items": [
      {
        "unixTime": 1726670700,
        "value": 127.97284640184616
      },
      {
        "unixTime": 1726671600,
        "value": 128.04188346328968
      },
      {
        "unixTime": 1726672500,
        "value": 127.40223856228901
      }
    ]
  }
}

GET

defi

history_price

Price - Historical

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

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

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

{
  "success": true,
  "data": {
    "isScaledUiToken": false,
    "items": [
      {
        "unixTime": 1726670700,
        "value": 127.97284640184616
      },
      {
        "unixTime": 1726671600,
        "value": 128.04188346328968
      },
      {
        "unixTime": 1726672500,
        "value": 127.40223856228901
      }
    ]
  }
}

Usage Note
Accessibility
Chain Supported

Historical price series for one token or pair.

Set address_type to token or pair depending on what the address represents.
Use time_from, time_to, and type together to request a bounded series at the granularity you need.
Returned prices are best suited for line charts, checkpoint analysis, and broad time-series workflows rather than candle-level OHLC studies.
Choose OHLCV endpoints instead when you need open/high/low/close/volume per bucket.

Compute Unit ⚙️

This endpoint consumes 35 CU per request.

Use Cases 💡

Retrieves historical USD price series for a token or pair across a selected time window.
Great for charting, research, and reconstructing token or pair price behavior across a past period.
Can be used to track performance before and after events such as listings, unlocks, liquidity changes, or major announcements.
Helpful for portfolio reconstruction, ROI calculators, trade-performance tools, and benchmark studies.
Add historical context to trade, holder, and smart-money analysis.

How to Use 🛠️

Set x-chain for the target network.
Pass the target address and choose address_type=token or address_type=pair.
Define the time window with time_from and time_to.
Choose type based on the granularity needed for your chart or analysis window.

Best Practices ✅

Use wider intervals for long backfills and finer intervals only when the question really needs them.
Align chart labels and downstream joins to the same bucket size you requested here.
When you need an exact checkpoint instead of a series, switch to Price - Historical by unix time.

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.

address_type

enum<string>

required

Available options:

token,

pair

type

enum<string>

required

OHLCV time frame.

Available options:

1m,

3m,

5m,

15m,

30m,

1H,

2H,

4H,

6H,

8H,

12H,

1D,

3D,

1W,

1M

time_from

integer

required

Specify the start time using unix timestamps in seconds

Required range: 0 <= x <= 10000000000

time_to

integer

required

Specify the end time using unix timestamps in seconds

Required range: 0 <= x <= 10000000000

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 values and unix timestamps of a token or pair

success

boolean

required

Whether the request completed successfully.

data

object

required

Historical price series for the requested token or pair.

Show child attributes