Skip to main content

List Tokens

Returns all tokens that have been created on the Launchpad or indexed from AMM trading. Each token includes its current price, XYZ reserves, 24-hour volume, and graduation status.

Endpoint

GET /api/tokens

Request

No parameters required.
curl http://67.205.164.156:3001/api/tokens

Response

{
  "tokens": [
    {
      "address": "xyz1cw20contractaddress...",
      "name": "Example Token",
      "symbol": "EXT",
      "image": "https://...",
      "description": "An example token launched on XYZ",
      "creator": "xyz1creatoraddress...",
      "source": "launchpad",
      "graduated": true,
      "xyz_reserves": "5200000000000",
      "current_price": "52000",
      "volume_24h": "1500000000000",
      "trade_count_24h": 342,
      "created_at": "2026-02-10T08:00:00.000Z",
      "first_seen_at": "2026-02-10T08:00:15.000Z"
    },
    {
      "address": "xyz1anothertoken...",
      "name": "Meme Coin",
      "symbol": "MEME",
      "image": null,
      "description": null,
      "creator": "xyz1someuser...",
      "source": "launchpad",
      "graduated": false,
      "xyz_reserves": "320000000000",
      "current_price": "3200",
      "volume_24h": "50000000000",
      "trade_count_24h": 18,
      "created_at": "2026-02-18T14:00:00.000Z",
      "first_seen_at": "2026-02-18T14:00:10.000Z"
    }
  ]
}

Response Fields

FieldTypeDescription
addressstringCW20 contract address of the token
namestring | nullToken name (set at creation)
symbolstring | nullToken ticker symbol
imagestring | nullToken image URL
descriptionstring | nullToken description
creatorstring | nullAddress that created the token
sourcestringWhere the token originated: "launchpad" or "amm"
graduatedbooleantrue if the token has graduated from bonding curve to AMM
xyz_reservesstringCurrent XYZ reserves in uxyz. For bonding curve tokens, this is the curve’s reserve. For graduated tokens, this reflects the last known AMM pool reserve.
current_pricestringLatest trade price in uxyz per token, scaled by 10^6. Divide by 10^6 to get price in uxyz.
volume_24hstringTotal trading volume in uxyz over the last 24 hours
trade_count_24hnumberNumber of trades in the last 24 hours
created_atstring | nullToken creation timestamp (from on-chain event)
first_seen_atstringWhen the indexer first observed this token

Understanding Prices

Prices are stored as integers scaled by 10^6 to avoid floating-point precision issues:
current_price = "52000"  →  52000 / 10^6 = 0.052 uxyz per micro-token
                         →  0.052 XYZ per token (since both have 6 decimals)

Understanding Reserves

For tokens still on the bonding curve, xyz_reserves indicates how close the token is to graduation:
Graduation threshold is dynamic per token (computed from oracle XYZ/USD price).
Query the launchpad contract's "progress" endpoint for exact threshold.
Current reserves:  3200000000000 uxyz
Progress: reserves / threshold = percentage toward graduation

Ordering

Tokens are returned ordered by first_seen_at descending (newest first).