Token lists API

GET/tokens

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 lists find tokens: by address, a search, a screener, a launchpad's or a creator's. A token's page gathers its metadata, price, stats, market cap, holders summary, creator and security checks; its pools and each pool's details are one call away.

Parameters

Response

Example

Captured 2026-09-28 18:03 UTC on a test instance, trimmed to 2 tokens.

curl -s -H 'Authorization: Bearer <key>' 'https://app.aurelia.build/api/tokens?chains=evm:56&minLiquidityUsd=1000&sort=volume24hUsd&limit=2'

{
  "tokens": [
    {
      "chain": "evm:56",
      "token": {
        "address": "0xa9fcda9bd321adeb7cbbbd30ef2dd0ed1d657777",
        "symbol": "TAX",
        "name": "Tax Token",
        "decimals": 18,
        "logo": null
      },
      "priceUsd": 0.006,
      "change": {
        "5m": 0,
        "1h": -0.019999999999999907,
        "6h": 0,
        "24h": null
      },
      "volume24hUsd": 1758,
      "trades24h": 105,
      "buys24h": 72,
      "sells24h": 33,
      "traders24h": 8,
      "marketCapUsd": 6000000,
      "fdvUsd": 6000000,
      "liquidityUsd": 4204200,
      "chartPool": "0x702e6533e0182381606adbe3ccbb77f682ccc58b",
      "createdAt": 1790546861920,
      "creator": {
        "address": "0x0f325bd174c70440fa62c31dce9f69d54baf717e",
        "labels": [
          "creator"
        ]
      },
      "launchpad": {
        "id": "fourmeme",
        "pool": "0xf39f85a07237050d069187679c621b9df1df8585b01d625ae22bc7cb99430013",
        "progress": 1,
        "complete": true,
        "graduatedAt": 1790549261920
      },
      "flags": [
        "buy_tax",
        "sell_tax"
      ]
    }
  ],
  "next": null,
  "total": 1,
  "updatedAt": 1790618550079
}

Notes

• The mode is set by the parameters: tokens= is the batch, q= a search, anything else the screener. A parameter of another mode, an unknown one or a repeated one is 400, and the error names it. minHolders is 400 too: holder counts are not known for many tokens at once (token holders answers them one token at a time).
• Batch: items in request order, an unknown token null in its place (<chain>:<address>, split on the last colon: evm:56:0xbb4c…). No paging.
• Search: an address is looked up first, on the chains it can belong to: a token with that address, then a pool, which stands for the token it trades against a stablecoin or the wrapped native token. Symbol and name matches follow, by kind and by activity: an exact match outranks a prefix match unless that one trades about 100 times as much, so the token that trades comes before the dozens that copy its symbol. Names and volumes are held in memory and read again every minute (in full every 5 minutes). A search pages through its 200 best matches.
• Screener: the candidates are every token with a USD price from a trade in the last 24 hours, and the launches of the last 24 hours without one yet; with creator, every token the wallet created. Filters and order apply to a snapshot rebuilt every 30 s, the rows are current: a value may have moved past a bound since, except feesPaidUsd, the snapshot's, so a list sorted or filtered by fees reads in order. A null value never matches a range. A page is kept 10 s.
• Every row is the same whatever the mode: a token has the same price, stats and flags here as in a batch or on its page, with two differences from the page: a token that is never the base (USDC) is priced here as the quote, where the page gives no price; and liquidityUsd is the price pool's alone, where the page sums its listed pools.

Try it in the interactive docsCreate a free account