Token price API
Up to 100 tokens' USD prices in one request, on any mix of chains, now or at a past moment.
A price here comes from a real swap in a real pool. Every answer names the pool and the time, so you can check it yourself.
Get prices now
GET /prices takes up to 100 <chain>:<address> items, comma-separated. One request can mix chains. A request costs 1 credit per 25 items, which makes it the cheapest read the API has.
Wrapped SOL and WBNB:
curl -s -H 'Authorization: Bearer <key>' 'https://app.aurelia.build/api/prices?tokens=solana:So11111111111111111111111111111111111111112,evm:56:0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c'
| Field | What it is |
|---|---|
priceUsd | The USD price. null when the token was not priced, or had no priced swap in the last 24 h |
time, pool | When and where that swap happened: unix ms, and the token's chart pool |
at, tx | With at=: the time you asked for, and the swap's transaction |
The answer holds one entry per item, in the order you asked, or null for a token Aurelia has never stored.
Get a price at a past moment
Add at, in unix milliseconds, for the price at that moment.
Wrapped SOL at a past moment:
curl -s -H 'Authorization: Bearer <key>' 'https://app.aurelia.build/api/prices?tokens=solana:So11111111111111111111111111111111111111112&at=1793800000000'
Poll from your code
Prices for a watchlist:
const tokens = ["solana:So11111111111111111111111111111111111111112", "evm:56:0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c"];
const res = await fetch(`https://app.aurelia.build/api/prices?tokens=${tokens.join(",")}`, {
headers: { Authorization: "Bearer <key>" },
});
const { prices } = await res.json();
for (const p of prices) if (p) console.log(p.address, p.priceUsd);
Follow one price live
For one token, subscribe to the token channel and read each tick, at most 4 a second. For many tokens, poll GET /prices instead of subscribing to each.
Related
- Prices reference: every parameter and field.
- OHLCV candles: a price history.
- Token screener: prices with volume, fees and market cap.
Free to start: 10,000 credits, with no card and no subscription.