Price - Historical by unix time

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

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

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

{
  "success": true,
  "data": {
    "isScaledUiToken": false,
    "value": 128.09276765626564,
    "updateUnixTime": 1726675897,
    "priceChange24h": -4.924324221890145
  }
}

GET

defi

historical_price_unix

Price - Historical by unix time

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

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

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

{
  "success": true,
  "data": {
    "isScaledUiToken": false,
    "value": 128.09276765626564,
    "updateUnixTime": 1726675897,
    "priceChange24h": -4.924324221890145
  }
}

Usage Note
Accessibility
Chain Supported

Exact historical price checkpoint.

Pass one token address plus a required unixtime in seconds.
Use this endpoint when you need the price at one exact moment, not a full time series.
This is useful for PnL checkpoints, valuation snapshots, and event-based lookups where a single timestamp matters more than a chart.

Compute Unit ⚙️

This endpoint consumes 5 CU per request.

Use Cases 💡

Returns historical USD prices for a token at a certain timestamp.
Perfect for portfolio time series reconstruction or backtesting strategies.
Great for generating custom charts, price annotations, and historical comparisons.
Value a wallet or portfolio at a specific historical checkpoint.
Measure slippage, entry quality, or event impact at a known timestamp.
Backfill price annotations for trades, transfers, or on-chain alerts.
Support ROI and tax-style workflows that require point-in-time pricing.

How to Use 🛠️

Set x-chain=solana.
Pass the token mint in address.
Provide unixtime in seconds for the checkpoint you want to price.
Use Price - Historical instead when you need a continuous series around the same event.

Best Practices ✅

Normalize all event timestamps to seconds before calling this endpoint.
Reuse the same checkpoint price across related calculations so PnL and valuation stay consistent.
Batch many checkpoints asynchronously in your backend rather than blocking a user flow one request at a time.

Limitations ⚠️

Solana only.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

Solana network only.

Available options:

solana

Query Parameters

address

string

required

The address of the token contract.

unixtime

integer

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 the historical price of a token resolved near the requested unix timestamp

success

boolean

required

Whether the request completed successfully.

data

object

required

Historical token price resolved near the requested unix timestamp.

Show child attributes