Token API

GET/tokens/:chain/:address

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.

Parameters

Response

Example

Captured 2026-09-28 18:03 UTC on a test instance, trimmed to 1 pool and the 5m, 1h and 24h windows.

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

{
  "token": {
    "address": "0xa9fcda9bd321adeb7cbbbd30ef2dd0ed1d657777",
    "decimals": 18,
    "symbol": "TAX",
    "name": "Tax Token",
    "firstSeenBlock": 1000002,
    "totalSupply": "1000000000",
    "circulatingSupply": "1000000000",
    "supplyAt": 1790618262558,
    "firstSeenAt": 1790546861920,
    "createdAt": 1790546861920,
    "createdTx": "0x4517764dd3b9782c02c5a640714b20335ea2585b394946c4b0f5f44bc1a7bf12",
    "creator": "0x0f325bd174c70440fa62c31dce9f69d54baf717e",
    "logo": null,
    "description": null,
    "socials": {
      "website": null,
      "twitter": null,
      "telegram": null,
      "discord": null,
      "others": {}
    },
    "uri": null,
    "security": {
      "checkedAt": 1790618614169,
      "flags": [
        "buy_tax",
        "sell_tax"
      ],
      "honeypot": {
        "likely": false,
        "buyers": 8,
        "sellers": 7,
        "window": "24h",
        "how": "Distinct wallets that bought, and that sold, in the last 24h (the transaction's sender), leaving out the token's creator and its pools' creators where Aurelia saw them. Likely a honeypot when 10+ wallets bought and none of them sold; not one once any sold"
      },
      "lp": {
        "pool": "0x702e6533e0182381606adbe3ccbb77f682ccc58b",
        "lockedShare": null,
        "burnedShare": 1,
        "how": "The pool is its own LP token: totalSupply() and balanceOf() of the zero and dead addresses at block 124557783. Locked LP is not counted: Aurelia has no trustworthy list of lockers"
      },
      "top10Share": 0.30010822,
      "logoReuses": null,
      "unknown": {
        "logoReuses": "the token has no logo"
      },
      "contract": {
        "block": 124557783,
        "owner": "0x0000000000000000000000000000000000000000",
        "renounced": true,
        "proxy": {
          "kind": "minimal",
          "implementation": "0x024f18294970b5c76c0691b87f138a0317156422",
          "admin": null,
          "upgradeable": false
        },
        "functions": {
          "mint": {
            "present": false,
            "signatures": [],
            "nonOwnerCall": null
          },
          "pause": {
            "present": false,
            "signatures": [],
            "nonOwnerCall": null
          },
          "blacklist": {
            "present": false,
            "signatures": [],
            "nonOwnerCall": null
          },
          "tradingToggle": {
            "present": false,
            "signatures": [],
            "nonOwnerCall": null
          }
        },
        "how": "At block 124557783: owner() or getOwner(); the EIP-1967, OpenZeppelin and EIP-1822 proxy slots and EIP-1167 code; the known mint, pause, blacklist and trading-toggle signatures the implementation's bytecode dispatches, each present one called once through Multicall3 (eth_call from a caller that is not the owner)"
      },
      "taxes": {
        "buy": 0.02,
        "sell": 0.02,
        "buys": 69,
        "sells": 33,
        "window": "24h",
        "how": "Median over the swaps of the last 24h in transactions with one swap of the token: what the pool's Transfer logs delivered to the recipient against what the pool sent (buys), what the pool received against what its sender sent in all (sells)"
      }
    }
  },
  "holders": {
    "count": 13,
    "top10Share": 0.30010822
  },
  "creator": {
    "address": "0x0f325bd174c70440fa62c31dce9f69d54baf717e",
    "labels": [
      "creator"
    ],
    "tokensCreated": 3,
    "graduated": 1
  },
  "stats24h": {
    "volumeUsd": 1758,
    "buyVolumeUsd": 1560,
    "sellVolumeUsd": 198,
    "trades": 105,
    "buys": 72,
    "sells": 33,
    "traders": 8,
    "buyers": 8,
    "sellers": 7,
    "feesPaidUsd": null
  },
  "chartPool": "0x702e6533e0182381606adbe3ccbb77f682ccc58b",
  "price": {
    "usd": 0.006,
    "quote": 0.00001,
    "quoteToken": {
      "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
      "symbol": "WBNB"
    },
    "pool": "0x702e6533e0182381606adbe3ccbb77f682ccc58b",
    "time": 1790618578665
  },
  "windows": {
    "5m": {
      "priceChange": 0,
      "volumeUsd": 600,
      "buyVolumeUsd": 600,
      "sellVolumeUsd": 0,
      "trades": 2,
      "buys": 2,
      "sells": 0,
      "traders": 1,
      "buyers": 1,
      "sellers": 0,
      "feesPaidUsd": null
    },
    "1h": {
      "priceChange": -0.019999999999999907,
      "volumeUsd": 618,
      "buyVolumeUsd": 612,
      "sellVolumeUsd": 6,
      "trades": 5,
      "buys": 4,
      "sells": 1,
      "traders": 4,
      "buyers": 3,
      "sellers": 1,
      "feesPaidUsd": null
    },
    "24h": {
      "priceChange": null,
      "volumeUsd": 1758,
      "buyVolumeUsd": 1560,
      "sellVolumeUsd": 198,
      "trades": 105,
      "buys": 72,
      "sells": 33,
      "traders": 8,
      "buyers": 8,
      "sellers": 7,
      "feesPaidUsd": null
    }
  },
  "poolCount": 2,
  "liquidityUsd": 4204200,
  "marketCapUsd": 6000000,
  "fdvUsd": 6000000,
  "pools": [
    {
      "address": "0x702e6533e0182381606adbe3ccbb77f682ccc58b",
      "protocol": "pancakeswap-v2",
      "token0": "0xa9fcda9bd321adeb7cbbbd30ef2dd0ed1d657777",
      "token1": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
      "volume24hUsd": 1368,
      "reserve": "700000000",
      "based": true,
      "counter": {
        "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
        "symbol": "WBNB"
      },
      "trades24h": 102,
      "priceUsd": 0.006,
      "counterReserve": "7",
      "liquidityUsd": 4204200
    }
  ],
  "feesPaidUsd": null,
  "ath": {
    "usd": 0.006122448979591836,
    "at": 1790549820000
  },
  "atl": {
    "usd": 0.000012,
    "at": 1790546820000
  },
  "bonding": {
    "pool": "0xf39f85a07237050d069187679c621b9df1df8585b01d625ae22bc7cb99430013",
    "progress": 1,
    "complete": true
  },
  "latestTradeAt": 1790618578665
}

Notes

• Cached 5 s. 404 {"error":"unknown token"} for a token Aurelia has never stored. The token channel sends this answer again as it changes, and the price after each trade.
• price and the window stats count swaps where the token was the base. A stablecoin is always the quote, so USDC answers price: null and zero stats: it is priced at $1 when it quotes other tokens.
• marketCapUsd and fdvUsd are null when the price or the supply is unknown, when the supply is 0, above $2T, or above $100M while the token's known liquidity is under $1k (a price printed in a pool nobody can exit). WBNB has no supply here, since its wrapped supply is not BNB's.
• security waits at most 1.5 s for a chain read on a miss; a slower one finishes in the background and the block says so in unknown ("the chain is being read"): ask again in a few seconds.
• A token seen for the first time can have null symbol, name and supplies for a short while; logo, description and socials follow once its metadata document is fetched, which can take minutes or never happen.
• Window stats are built from 5-minute buckets, the newest one still filling: 5m is the current bucket only. priceChange is null without a priced trade that long ago (the look-back is 48 h).
• Fees paid are the transaction fees traders paid to get their swaps included: on Solana the base and priority fee plus any Jito tip, on BSC the gas, in USD at the native price of the moment. Trading-bot fees and the pool's own swap fee are not included.
• ath and atl come from the pools where the token was the base with at least 5% of the chart pool's 24 h volume, plus its bonding curve. When set, they hold the current price: ath.usd ≥ price.usd ≥ atl.usd.

Try it in the interactive docsCreate a free account