price history

API Endpoint: /defi/history_price

Description: This endpoint enables fetching historical token prices for a specific token address within a specified time range and interval. By providing the token address, address type (e.g., token), OHLCV interval type (e.g., 15 minutes), and desired time range using Unix timestamps, you can access a historical record of token prices at different time intervals for analysis and visualization.

Request

Request Method: GET

Data Coverage: Multi-chain

Request URL:

https://public-api.birdeye.so/defi/history_price?address=So11111111111111111111111111111111111111112&address_type=token&type=15m&time_from=1691997839&time_to=1692266639

Request Headers:

accept: application/json
x-chain: any chains that Birdeye supports. Example: solana, ethereum
X-API-KEY: YOUR_API_KEY

Parameters:

KeyData TypeDetailsExample
addressstringThe Solana token address to retrieve historical prices for.So11111111111111111111111111111111111111112
address_typestringThe type of address providedtoken
typestringThe OHLCV interval type15m
time_fromintThe Unix timestamp representing the start of the desired time range.1691997839
time_tointThe Unix timestamp representing the end of the desired time range.1692266639

Response

The response provides an array of historical token prices for the specified token address, each including the token address, Unix timestamp, and price value.

Example Request:

curl -X 'GET' \
  'https://public-api.birdeye.so/defi/history_price?address=So11111111111111111111111111111111111111112&address_type=token&type=15m&time_from=1691997839&time_to=1692266639' \
  -H 'accept: application/json' \
  -H 'x-chain: solana' \
  -H 'X-API-KEY: YOUR-API-KEY'

Example Response:

{
  "data": {
    "items": [
      {
        "address": "So11111111111111111111111111111111111111112",
        "unixTime": 1691998200,
        "value": 24.417357853450138
      },
      {
        "address": "So11111111111111111111111111111111111111112",
        "unixTime": 1691999100,
        "value": 24.396416819129854
      },
      // More historical token price data points...
    ]
  },
  "success": true
}

Response Parameters:

KeyData TypeDetailsExample
addressstringThe Solana token address to retrieve historical prices for.So11111111111111111111111111111111111111112
unixTimestringThe Unix timestamp1691998200
valuestringThe price of the token at the Unix timestamp24.417357853450138

Note: Replace the address in the request URL with the actual token address you wish to inquire about. The x-chain header specifies the blockchain network, and the X-API-KEY header provides authentication for the premium API.