Token Detail

Get full details for a single token by contract address

Token Detail

Retrieve detailed information for a single token, including its current price, reserves, and 24-hour trading statistics.

Endpoint

GET /api/tokens/:address

Path Parameters

Parameter	Type	Description
address	string	CW20 contract address of the token (e.g., xyz1cw20contract...)

Request

curl http://67.205.164.156:3001/api/tokens/xyz1cw20contractaddress...

Response

{
  "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"
}

See List Tokens for a full description of each field.

Errors

Status	Condition
404	Token not found — either the address is wrong or the token hasn’t been indexed yet
500	Internal server error

404 Response

{
  "error": "Token not found"
}

Tokens appear in the index within ~5 seconds of their first on-chain trade or creation event. If you’ve just created a token and get a 404, wait a few seconds and retry.

Using Token Detail for Trading UI

A typical trading UI needs to display:

1. Token identity — name, symbol, image
2. Current price — current_price (divide by 10^6 for human-readable)
3. Graduation status — graduated determines whether to route trades to the Launchpad (bonding curve) or AMM
4. Liquidity depth — xyz_reserves indicates how much XYZ is backing this token
5. Activity — volume_24h and trade_count_24h show how actively it’s being traded

Example: Display Price in XYZ

const token = await fetch('http://67.205.164.156:3001/api/tokens/xyz1...')
  .then(r => r.json());

const priceInXyz = Number(token.current_price) / 1e6;
console.log(`${token.symbol}: ${priceInXyz} XYZ`);
// "EXT: 0.052 XYZ"