Aurelia API reference

An API for onchain tokens. GET prices, charts, trades and holders, or stream them live as each new block arrives.

Start

API basics: Base URL, chains and addresses, units, base and quote, pagination, errors.
Data and coverage: Where the data comes from, how fresh each kind is, and what each part of the API covers.

Prices API: The USD price of up to 100 tokens on any chains, now or at a past moment, and the swap each comes from. The cheapest read the API has.

Token candles API: OHLC bars of a token, in USD or in its quote token, from the pool that charts it. The answer names that pool. A price history is the bars' closes.
Pool candles API: OHLC bars of a pool's base token, in USD or in the quote token.

Trades API: One trade feed, newest first: a token's trades in all its pools, a pool's, a wallet's, or a transaction's, filtered by side, USD size, trader or label.
Token traders API: A token's traders ranked by PnL, realized PnL or volume, over a window or all time, or its first buyers; each with its position, labels and first buy.

Token lists API: One list of tokens for every purpose: up to 100 by address, a search by address, symbol or name, a screener, a launchpad's tokens or a creator's.
Token API: Everything about one token in one answer: metadata, logo and socials, creator, supply, price, stats, fees paid, ATH and ATL, bonding curve and more.
Token security checks: A token's risk checks, each saying how it was established, and what the API answers when a check cannot be made.
Token pools API: Every pool of a token, busiest or deepest first, each with its state, price, liquidity and stats over 5m to 24h.
Pool API: A pool's metadata, both tokens, its live state, and its market: price, liquidity, and stats over 5m to 24h.
Token logo API: A token's logo as a small WebP, re-hosted by Aurelia so pages never load a deployer's server or an IPFS gateway. Use the URL the token endpoints give in logo.

Token holders API: Who holds a token now: its largest holders with balance, share, USD value, labels and position PnL, and the holder count where it can be known.

Wallets and PnL: Who a wallet is, what its figures cover, and how PnL, the current price and quote tokens are defined.
Wallet labels: What a wallet is known to be (creator, insider, sniper, smart money, bot, fresh), the rule behind each label, and where labels appear.
Wallet portfolio API: A wallet's holdings now, read from the chain and valued in USD, with its liquidity positions and its position in each token.
Wallets API: Several wallets' portfolios with totals in one request, or wallet discovery: the top wallets by PnL, volume or win rate.
Wallet analysis API: A wallet's PnL, win rate, volume, return distribution and PnL timeline over a window, with its labels.
Wallet positions API: Every token the wallet traded since indexing began, open, closed or all: amounts, average prices, realized and unrealized PnL. With token=, one position.
Wallet value history API: What a wallet's holdings were worth over the last day, week or month; with token=, one position's balance, value and PnL over time.
Wallet activity API: Every transaction of a wallet, newest first, with what it did: swaps, liquidity adds and removes, and transfers.

Pulse: new token launches: Fresh launches, curves close to graduating and fresh graduations: views, filters, naming, and what is not provided.
Pulse board API: The chain's board of launches: fresh launches, bonding curves close to graduating, and fresh graduations, filtered and sorted.

WebSocket API: WS /live: one socket, many subscriptions (trades, candles, token, pool, holders, balances, positions, pulse), its messages, metering, caps and errors.

Live token and pool data: The token and pool channels: the /tokens/:chain/:address or /pools/:chain/:address body, then the price as each trade lands, and the body again as it changes.

Live candles over WebSocket: The candles channel: a pool's or a token's bar in progress, at any resolution, in USD or the quote token, and each bar as it closes.

Live trades over WebSocket: The trades channel: every swap of a token, a pool or a wallet, pushed as blocks are indexed, in GET /trades's row shape.

Live token holders over WebSocket: The holders channel: a token's largest 100 holders, the token holders answer, sent again each time it changes.

Live wallet balances and positions: The balances and positions channels: a wallet's portfolio, its positions, or one position, sent again whenever they change.

Live new token launches over WebSocket: The pulse channel: a Pulse list, the whole list first, then only the rows that changed.

API authentication and limits: API keys, plans and credits, paying, rate limits and their errors, the WebSocket's caps, and the headers that report what is left.
Plans API: The plans and their limits, the WebSocket caps included, as the API enforces them, so a client never hardcodes them.
Health API: Whether the API can reach each of its three stores. Use it for uptime checks.
Chains API: Every listed chain: how far indexing has got and how far behind the tip it is, and the chain's last 24 hours: volume, trades, traders, new tokens and pools.

BSC token API: BSC token data over REST and WebSocket: prices, candles, trades, holders, wallets and new launches from PancakeSwap, Uniswap, four.meme and flap.sh.
Solana token API: Solana token data over REST and WebSocket: prices, candles, trades, holders, wallets and new launches from pump.fun, Raydium, Orca and Meteora.
Base token API: Base token data over REST and WebSocket: prices, candles, trades, holders, wallets and new launches from Aerodrome, Uniswap, Clanker, Zora and Virtuals.
Robinhood Chain token API: Robinhood Chain token data over REST and WebSocket: prices, candles, trades, holders, wallets and new launches from Uniswap, Ramses, up and flap.sh.
Ethereum token API: Ethereum token data over REST and WebSocket: prices, candles, trades, holders, wallets and new launches from Uniswap, Curve, SushiSwap and Fluid.

pump.fun API: Follow pump.fun tokens over REST and WebSocket: new launches, bonding curve progress, graduations, trades, holders and snipers.
four.meme API: Follow four.meme tokens on BSC over REST and WebSocket: new launches, bonding curve progress, graduations, trades, taxes and snipers.

Aurelia vs Mobula: Aurelia and Mobula compared on price per credit, free credits, rate limits and WebSockets, and when Mobula is still the better fit.
Aurelia vs Codex: Aurelia and Codex compared on cost per request, plans, rate limits and API style, and when Codex's 80+ networks make it the better fit.
Aurelia vs Birdeye: How Aurelia and Birdeye differ as onchain token data APIs: how you name a chain, how live data arrives, and which suits what.