# Aurelia > Aurelia indexes every swap on BSC, Solana, Base, Robinhood Chain and Ethereum itself and serves token lists (batch, search, screener, dev history), prices (now or at a time), candles, one trade feed, token details with security checks and holders, token traders, wallet portfolios (with liquidity positions, labels and first funding), positions, value history, activity and PnL, wallet discovery by label, and one WebSocket with channels for trades, candles, token and pool pages, holders, balances, positions and Pulse lists. Every endpoint is a GET under https://app.aurelia.build/api. Every request needs an account (a free one is enough): sign in at https://app.aurelia.build/#/login, create a key at https://app.aurelia.build/#/account and send `Authorization: Bearer `. Without one the API answers 401. An account gets 10,000 free credits once, to spend on anything; they do not renew and there is no daily allowance. Most requests cost 1 credit and a WebSocket message 0.3; then 1,000 credits cost $0.28, or $0.224 on a single deposit of $280 or more, paid in USDC with no subscription. Every answer reports the credits left in `X-Aurelia-Credits`. Out of credits the API answers 402 (a socket closes with 4402). Over the burst limit it answers 429 with `retryAfter` seconds; wait that long. GET /plans states every limit, the WebSocket caps included. - Base URL: https://app.aurelia.build/api. The console at https://app.aurelia.build forwards /api to the API, which listens on http://localhost:7070 locally and on its own domain in production. - Chains: `evm:56` (BSC: 0x addresses, lowercase in answers), `solana` (base58 addresses, case-sensitive), `evm:8453` (Base: 0x addresses, lowercase in answers), `evm:4663` (Robinhood Chain: 0x addresses, lowercase in answers) and `evm:1` (Ethereum: 0x addresses, lowercase in answers). `chains=` defaults to these. Native BNB, ETH or SOL is the token address `native`. - Amounts are decimal strings with decimals applied; USD values are numbers; times are unix ms, but candles use unix seconds. - A price is the base token's. A trade row is told from one token's side (the token asked for, else the swap's base): `buy` means the trader received it. - Lists take `limit` and `cursor`: pass the answer's `next` back as `cursor`; `null` is the end. A filtered page can be short before the end: follow `next`. - Every row that names a wallet carries its `labels` (creator, insider, sniper, smart_money, bot, fresh), each derived from indexed data by a stated rule. - Wallet figures cover only swaps indexed since the answer's `indexedSince`; PnL is by weighted average cost, and a null PnL is unknown, never 0. The portfolio reads balances from the chain. - Answers state what they cover (`coverage`, `complete`, `exactSince`, `unknown`): Solana wallet activity and history are read from the chain, bounded per request; BSC value history leaves out native BNB; holders are complete only where they can be; a security check that could not run is null with its reason in `unknown`. - Batch lists (`tokens=` on /tokens and /prices, `wallets=` on /wallets) are `:
` items, split on the last colon; an unknown token is null in its place. - WebSocket: one socket, `/live`; send `{"op":"subscribe","id","channel","chain",…}`; messages carry the id; an `error` ends that subscription only. Each subscribe is metered as one request; subscriptions per socket are capped by plan. - Errors are JSON `{"error": "…"}`: 400 for a bad parameter, 404 for an unknown token or pool, 422 when an answer could not be exact, 502 when the chain cannot be read, 503 (with Retry-After) while a chain's read budget is spent. An unknown route answers plain `NOT_FOUND`. ## Start - [Basics](https://app.aurelia.build/llms-full.txt): Base URL, chains and addresses, units, base and quote, pagination, errors. - [Data and coverage](https://app.aurelia.build/llms-full.txt): Where the data comes from, how fresh each kind is, and what each part of the API covers on BSC and Solana. ## Prices - [Prices: GET /prices](https://app.aurelia.build/api/prices?tokens=solana%3ASo11111111111111111111111111111111111111112%2Csolana%3AGLWR3sVCSMuL7ffjCnpjkgC862TV5R5b8ofr3i8bjjhM%2Cevm%3A56%3A0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c): 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. ## Charts - [Token candles: GET /tokens/:chain/:address/candles](https://app.aurelia.build/api/tokens/solana/So11111111111111111111111111111111111111112/candles?res=1h¤cy=usd): 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: GET /pools/:chain/:address/candles](https://app.aurelia.build/api/pools/solana/Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE/candles?res=1h¤cy=usd): OHLC bars of a pool's base token, in USD or in the quote token. ## Trades - [Trades: GET /trades](https://app.aurelia.build/api/trades?chain=solana&token=So11111111111111111111111111111111111111112&limit=10): 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. One row shape everywhere, with the trader's labels. - [Token traders: GET /tokens/:chain/:address/traders](https://app.aurelia.build/api/tokens/solana/So11111111111111111111111111111111111111112/traders?sort=pnl&window=all&limit=10): 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. ## Tokens - [Token lists: GET /tokens](https://app.aurelia.build/api/tokens?chains=solana&limit=10): One list of tokens for every purpose, one row shape in every mode: up to 100 tokens by address (`tokens=`), a search by address, symbol or name (`q=`), or a screener over chains with range filters and sorts, a launchpad's tokens, or a creator's (`creator=`, dev history). - [Token: GET /tokens/:chain/:address](https://app.aurelia.build/api/tokens/solana/So11111111111111111111111111111111111111112): Everything about one token: metadata, logo and socials, creation and creator, supply, price, stats and fees paid per window, ATH and ATL, bonding curve, market cap and FDV, holders summary, security checks, and its pools with the chart pool first. - [Security](https://app.aurelia.build/llms-full.txt): A token's risk checks on BSC and Solana, each saying how it was established, the flags they raise, and what unknown means. - [Token pools: GET /tokens/:chain/:address/pools](https://app.aurelia.build/api/tokens/solana/So11111111111111111111111111111111111111112/pools?sort=volume&limit=5): Every pool of a token, busiest or deepest first, each with its state, price, liquidity and stats over 5m to 24h. - [Pool: GET /pools/:chain/:address](https://app.aurelia.build/api/pools/solana/Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE): A pool's metadata, both tokens, its live state, and its market: price, liquidity, and stats over 5m to 24h. - [Token logo: GET /logos/:chain/:address](https://app.aurelia.build/api/logos/solana/So11111111111111111111111111111111111111112): 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`. ## Holders - [Token holders: GET /tokens/:chain/:address/holders](https://app.aurelia.build/api/tokens/evm:56/0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82/holders?limit=10): Who holds a token now: its largest holders with their balance, share, USD value, labels and position (PnL), the holder count where it can be known, and how complete the list is. ## Wallets - [Wallets and PnL](https://app.aurelia.build/llms-full.txt): Who a wallet is, what its figures cover, and how PnL, the current price and quote tokens are defined. - [Labels](https://app.aurelia.build/llms-full.txt): 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: GET /wallets/:chain/:address](https://app.aurelia.build/api/wallets/solana/Fm1Nzv3EcgGMW2MFHHGKjdVDbvHsMMtoRdoBDmUmsFFE?limit=10): A wallet's holdings now, read from the chain and valued in USD, its liquidity positions in the pools Aurelia indexes, each token with the wallet's position in it; and who the wallet is: its labels and its first funding. - [Wallets: GET /wallets](https://app.aurelia.build/api/wallets?wallets=Fm1Nzv3EcgGMW2MFHHGKjdVDbvHsMMtoRdoBDmUmsFFE&chains=solana&limit=5): Several wallets' portfolios with totals, on every listed chain each address fits (`wallets=`); or wallet discovery: the top wallets by PnL, volume or win rate, by label. - [Wallet analysis: GET /wallets/:chain/:address/analysis](https://app.aurelia.build/api/wallets/solana/Fm1Nzv3EcgGMW2MFHHGKjdVDbvHsMMtoRdoBDmUmsFFE/analysis?window=1d): A wallet's PnL, win rate, volume, return distribution and PnL timeline over a window, with its labels. - [Wallet positions: GET /wallets/:chain/:address/positions](https://app.aurelia.build/api/wallets/solana/Fm1Nzv3EcgGMW2MFHHGKjdVDbvHsMMtoRdoBDmUmsFFE/positions?sort=pnl&limit=5): Every token the wallet traded since indexing began, open, closed or all: amounts, average prices, realized and unrealized PnL. With `token=`, one position. - [Value history: GET /wallets/:chain/:address/history](https://app.aurelia.build/api/wallets/evm:56/0x8f8763e650c0b6b15b2ded94868f2355a8d868e7/history?window=1d): 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: GET /wallets/:chain/:address/activity](https://app.aurelia.build/api/wallets/evm:56/0x8f8763e650c0b6b15b2ded94868f2355a8d868e7/activity?limit=10): Every transaction of a wallet, newest first, with what it did: swaps, liquidity adds and removes, and transfers; on Solana complete, read from the chain. ## Pulse - [Pulse](https://app.aurelia.build/llms-full.txt): Fresh launches, curves close to graduating and fresh graduations: views, filters, naming, and what is not provided. - [Pulse board: GET /chains/:chain/pulse](https://app.aurelia.build/api/chains/solana/pulse?view=new&limit=10): The chain's board of launches: fresh launches, bonding curves close to graduating, and fresh graduations, filtered and sorted. A snapshot at most a few seconds old; follow it with [the pulse channel](#/docs/live-pulse). ## Live data: Connecting - [The socket](https://app.aurelia.build/llms-full.txt): WS /live: one socket, many subscriptions (trades, candles, token, pool, holders, balances, positions, pulse), its messages, metering, caps and errors. ## Live data: Tokens and prices - [Token and pool pages](https://app.aurelia.build/llms-full.txt): 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 data: Charts - [Candles](https://app.aurelia.build/llms-full.txt): 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 data: Trades - [Trades](https://app.aurelia.build/llms-full.txt): 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 data: Holders - [Holders](https://app.aurelia.build/llms-full.txt): The holders channel: a token's largest 100 holders, the token holders answer, sent again each time it changes. ## Live data: Wallets - [Balances and positions](https://app.aurelia.build/llms-full.txt): The balances and positions channels: a wallet's portfolio, its positions, or one position, sent again whenever they change. ## Live data: Pulse - [Pulse lists](https://app.aurelia.build/llms-full.txt): The pulse channel: a Pulse list, the whole list first, then only the rows that changed. ## Account - [Authentication and limits](https://app.aurelia.build/llms-full.txt): API keys, plans and credits, paying, rate limits and their errors, the WebSocket's caps, and the headers that report what is left. - [Plans: GET /plans](https://app.aurelia.build/api/plans): The plans and their limits, the WebSocket caps included, as the API enforces them, so a client never hardcodes them. - [Health: GET /health](https://app.aurelia.build/api/health): Whether the API can reach each of its three stores. Use it for uptime checks. - [Chains: GET /chains](https://app.aurelia.build/api/chains): 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. ## Docs - [Full reference](https://app.aurelia.build/llms-full.txt): every endpoint with parameters, response fields, a captured example and notes, plus the WebSocket protocol, authentication, limits and errors - [Docs for people](https://app.aurelia.build/#/docs): the same reference with live previews and a request tester