Price Volume - Single token

*API Endpoint:** /defi/price_volume/single

Description: This endpoint retrieves the current price and volume data for a specified token over a given time period. It provides additional details such as the most recent update time, price change percentage, and volume change percentage over the specified period. The default period is 24 hours.

Request

Request Method: GET

Data Coverage: Multi-chain

Request URL:

https://beta-public-api.birdeye.so/defi/price_volume/single?address=So11111111111111111111111111111111111111112&type=24h

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
typestringThe time period for the data. Supported values: 1h, 2h, 4h, 8h, 24h. Default is 24h.24h

Response

The response provides the current price and volume data for the specified token over the given period, along with the percentage changes and the time of the last update.

Example Request:

curl -X 'GET' \
  'https://beta-public-api.birdeye.so/defi/price_volume/single?address=So11111111111111111111111111111111111111112&type=24h' \
  -H 'accept: application/json' \
  -H 'x-chain: solana' \
  -H 'X-API-KEY: YOUR-API-KEY'

Example Response:

{
    "success": true,
    "data": {
        "price": 146.97843882208798,
        "updateUnixTime": 1719905910,
        "updateHumanTime": "2024-07-02T07:38:30",
        "volumeUSD": 1012968266.6856732,
        "volumeChangePercent": 4.602474543711091,
        "priceChangePercent": -0.6528161755948374
    }
}

Response Parameters:

KeyData TypeDetailsExample
pricefloatThe current price of the token.146.97843882208798
updateUnixTimeintegerThe Unix timestamp1719905910
updateHumanTimestringThe human-readable time of the most recent update."2024-07-02T07:38:30"
volumeUSDfloatThe trading volume in USD of the token over the specified period.1012968266.6856732
volumeChangePercentfloatThe percentage change in volume over the specified period.4.602474543711091
priceChangePercentfloatThe percentage change in price over the specified period.-0.6528161755948374

Note: This endpoint provides real-time data on the token's price and trading volume, along with percentage changes over a specified period, allowing users to monitor the token's performance effectively. If data for the full 24-hour period (or other type) is unavailable, the calculation will be based on the interval of available data from the specified timestamp to the oldest available price.