Aurelia
DocsSign in

Ethereum token API

Prices, charts, trades, holders, wallets and new launches on Ethereum, over REST or one live WebSocket.

Aurelia reads every block of Ethereum itself, decodes the swaps of the protocols below and serves them through one API. Name the chain as evm:1. The same endpoints answer on every listed chain, so your code stays the same when you add another.

What is indexed

KindNames
DEXesUniswap V2, V3 and V4, PancakeSwap V2 and V3, SushiSwap V2 and V3, Curve, Fluid DEX, Maverick V2, DODO V2, Ekubo, Metric, Ring Swap, Aerodrome Slipstream
LaunchpadsClanker (clanker), Stockereum (stockereum)

Trades, candles, stats, positions and PnL cover every swap of these since indexedSince, and each answer states what it covers. How far behind the tip indexing is, is always public: GET /chains.

Addresses

Addresses are 0x and lowercase in answers. Native ETH has the address native wherever a token object names it, and prices as the wrapped token.

First requests

Everything about one token:

curl -s -H 'Authorization: Bearer <key>' 'https://app.aurelia.build/api/tokens/evm:1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'

Its hourly candles:

curl -s -H 'Authorization: Bearer <key>' 'https://app.aurelia.build/api/tokens/evm:1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2/candles?res=1h&currency=usd'

Its newest trades:

curl -s -H 'Authorization: Bearer <key>' 'https://app.aurelia.build/api/trades?chain=evm:1&token=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&limit=10'

New launches:

curl -s -H 'Authorization: Bearer <key>' 'https://app.aurelia.build/api/chains/evm:1/pulse?view=new&limit=10'

Live data

Open one socket at wss://app.aurelia.build/api/live?apiKey=<key> and subscribe to as many tokens as you need. Every swap is pushed as its block is indexed.

Subscribe to a token's trades:

{"op":"subscribe","id":"t","channel":"trades","chain":"evm:1","token":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"}

What is specific to Ethereum

  • Holders: complete, with a count, for a token whose whole history the index holds. Otherwise the balances of the addresses that moved it, with no count.
  • Wallet activity: from the index. Swaps, liquidity, every ERC-20 transfer and ETH sent as a transaction's value, but not internal transfers or gas. Transfers are kept 30 days.
  • Security: owner, proxy, dangerous functions, measured taxes, a honeypot signal and burned liquidity.

Reference

Create a free accountRead the API reference