Price Volume - Multi tokens
*API Endpoint:** /defi/price_volume/multi
Description: This endpoint retrieves the current price and volume data for multiple specified tokens 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. Note: A maximum of 50 addresses can be requested at once.
Request
Request Method: POST
Data Coverage: Multi-chain
Request URL:
https://beta-public-api.birdeye.so/defi/price_volume/multi
Request Headers:
accept: application/json
x-chain: any chains that Birdeye supports. Example: solana, ethereum
X-API-KEY: YOUR_API_KEY
Parameters:
Key | Data Type | Details | Example |
---|---|---|---|
list_address | string | A comma-separated list of token addresses to retrieve historical prices for. | So11111111111111111111111111111111111111112,DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 |
type | string | The 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 tokens over the given period, along with the percentage changes and the time of the last update.
Example Request:
curl --request POST \
--url https://beta-public-api.birdeye.so/defi/price_volume/multi \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'content-type: application/json' \
--data '
{
"list_address": "So11111111111111111111111111111111111111112,DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"type": "24h"
}
Example Response:
{
"success": true,
"data": [
{
"address": "So11111111111111111111111111111111111111112",
"price": 146.97843882208798,
"updateUnixTime": 1719905910,
"updateHumanTime": "2024-07-02T07:38:30",
"volumeUSD": 1012968266.6856732,
"volumeChangePercent": 4.602474543711091,
"priceChangePercent": -0.6528161755948374
},
{
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"price": 320.451239234234,
"updateUnixTime": 1719905915,
"updateHumanTime": "2024-07-02T07:38:35",
"volumeUSD": 2045892345.23454,
"volumeChangePercent": 2.3456234534,
"priceChangePercent": 1.234234345
}
]
}
Response Parameters:
Key | Data Type | Details | Example |
---|---|---|---|
price | number | The current price of the token. | 146.97843882208798 |
updateUnixTime | integer | The Unix timestamp | 1719905910 |
updateHumanTime | string | The human-readable time of the most recent update. | "2024-07-02T07:38:30" |
volumeUSD | number | The trading volume in USD of the token over the specified period. | 1012968266.6856732 |
volumeChangePercent | number | The percentage change in volume over the specified period. | 4.602474543711091 |
priceChangePercent | number | The percentage change in price over the specified period. | '-0.6528161755948374 |
Note
- 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.
Updated 4 months ago