Tokens

Token Detail

GET

/api/v1/tokens/{address}

Get full details for a single token, including prediction options if applicable.

Auth: API Key required

Response

{
  "data": {
    "id": 1,
    "address": "0x...",
    "name": "Will BTC hit 200k?",
    "symbol": "BTC200K",
    "description": "...",
    "dev": "0x...",
    "image": "https://...",
    "multiplier": 50,
    "isPrediction": true,
    "predictionType": "public",
    "predictionStatus": "active",
    "endTime": "2026-06-01T00:00:00.000Z",
    "eventType": "public",
    "website": null,
    "telegram": null,
    "twitterx": null,
    "createdAt": "2026-01-01T00:00:00.000Z",
    "lastActivityAt": "2026-03-15T00:00:00.000Z",
    "predictionOptions": [
      { "index": 0, "name": "Yes" },
      { "index": 1, "name": "No" }
    ],
    "liquidityUSD": 25000.50,
    "startingLiquidityUSD": 1200.00
  }
}

200 OK404 Token not found

Prediction market fields

Field	Meaning
predictionType	public markets live on the MarketTrading contract; private markets on MarketPrivate. On-chain calls must target the matching contract: reading a private market through MarketTrading returns a zeroed struct, and buys revert.
endTime	null means open-ended (endTime = 0 on-chain): the market has no close time and stays bettable until it resolves. Otherwise the ISO time the market closes.
predictionStatus	Indexed lifecycle: active → awaiting_proposal → proposed → proposed_closed → voting → veto_window → resolved \| invalidated \| vetoed \| disputed. Only bet on active markets.

Example Code

// Get single token with prediction options
const res = await fetch(
  "https://launchonbasis.com/api/v1/tokens/0xTokenAddress",
  { headers: { "X-API-Key": "bsk_your_key" } }
);
const { data } = await res.json();