Skip to main content
POST
/
api
/
v1
/
developer
/
prices
Get Latest Prices
curl --request POST \
  --url https://api.allium.so/api/v1/developer/prices \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '[
  {
    "chain": "string",
    "token_address": "string"
  }
]'
{
  "items": [
    {
      "timestamp": "2023-11-07T05:31:56Z",
      "chain": "<string>",
      "address": "<string>",
      "decimals": 123,
      "price": 123,
      "open": 123,
      "high": 123,
      "close": 123,
      "low": 123
    }
  ],
  "cursor": "<string>"
}
This endpoint returns the latest price and OHLC values for a list of tokens. Prices and OHLC values are aggregated from trades in the most recent completed minute interval. If no trades occurred in the last minute, the endpoint returns the most recent available data. For inactive tokens, the last known price is derived from the most recent on-chain trade. If no trade has occurred within the past 7 days, the endpoint will return no data for that token. We recommend checking the timestamp included in the response, which corresponds to the last trade time.

​
Pagination

This endpoint returns prices for up to 200 tokens in a single request.

​
Supported Chains

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
with_liquidity_info
boolean
default:false

If true, returns total_liquidity_usd as well. See this page for more details.

Body

application/json · PayloadTokenAddress · object[]
​
token_address
string
required
​
chain
string
required

Response

Successful Response

​
items
TokenPriceV2WithHiddenFields · object[]
required
​
cursor
string | null
⌘I