Skip to main content
POST
/
api
/
v1
/
developer
/
prices
Latest Token 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 '
[
  {
    "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "chain": "ethereum"
  },
  {
    "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "chain": "solana"
  }
]
'
{
  "items": [
    {
      "timestamp": "2023-11-07T05:31:56Z",
      "chain": "<string>",
      "address": "<string>",
      "price": 123,
      "open": 123,
      "high": 123,
      "close": 123,
      "low": 123,
      "decimals": 123
    }
  ],
  "cursor": "<string>",
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.allium.so/llms.txt

Use this file to discover all available pages before exploring further.

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
Required array length: 1 - 200 elements
​
token_address
string
required

Token contract address

​
chain
string
required

Lowercase chain name

Response

Successful Response

​
items
TokenPriceV2WithHiddenFields · object[]
required

Response items

​
cursor
string | null

Pagination cursor for next page

​
message
string | null

Informational message (e.g. partial results)