Detailed Token Page

In this recipe we’ll walk through building a token detail page — the kind of page your users land on after clicking a token from a discovery feed. We’ll combine multiple Codex endpoints to populate every section: metadata, price, holders, top traders, safety signals, trade history, and real-time updates. This data powers the token pages on Defined.fi:

Step 1: Token Metadata & Safety

Start by fetching the token’s core info — name, symbol, images, social links, and safety signals. This single query gives you everything for the header of your token page.

Token metadata with safety fields

Test this query in the Explorer →

query TokenMetadata {
  token(
    input: {
      address: "9wK8yN6iz1ie5kEJkvZCTxyN1x5sTdNfx8yeMY8Ebonk"
      networkId: 1399811149
    }
  ) {
    name
    symbol
    decimals
    address
    networkId
    isScam
    creatorAddress
    creator {
      address
      displayName
      category
      identityLabels
      tokensCreatedCount
      tokensMigratedCount
    }
    createdAt
    mintable
    freezable
    socialLinks {
      twitter
      telegram
      discord
      website
    }
    top10HoldersPercent
    info {
      circulatingSupply
      totalSupply
      imageSmallUrl
      imageLargeUrl
      description
    }
    launchpad {
      launchpadName
      graduationPercent
      poolAddress
      completed
      migrated
      migratedAt
      migratedPoolAddress
    }
  }
}

Token verification: Codex uses isScam rather than isVerified for token safety. isScam: false is the equivalent of a token being “verified.” For Solana tokens, also check mintable and freezable — if these return an address, the token’s supply can be increased or holdings can be frozen.

Screen for suspicious-wallet concentration. Alongside isScam, Codex reports how much of a token’s supply sits in risky wallet cohorts. filterTokens exposes suspiciousHeldPercentage and suspiciousCount — the deduplicated union of snipers, bundlers, and insiders — plus the per-cohort sniperHeldPercentage, bundlerHeldPercentage, insiderHeldPercentage, and devHeldPercentage. These are available as result fields, filter inputs, and ranking attributes, so you can both display them and screen risky tokens out at discovery time. For launchpad tokens, the same breakdown is available inline on pairMetadata via walletActivity (shown in Step 2).

Resolve the creator inline. Alongside the raw creatorAddress, EnhancedToken exposes creator, a fully resolved Wallet. Select it to pull the creator’s display name, identity labels, category, and tokensCreatedCount / tokensMigratedCount in the same call — a useful trust signal (e.g. a serial deployer) without a follow-up query.

Step 2: Price & Pair Data

Fetch the token’s current price, volume, and liquidity from its top trading pair using pairMetadata. This gives you the price stats panel for your dashboard.

Price and volume from pairMetadata

Test this query in the Explorer →

query TokenPrice {
  pairMetadata(
    pairId: "7GtLUbEStB1xjqVcGHqpAo4hW8uFNbLKDMcoHb7QSEXY:1399811149"
  ) {
    price
    liquidity
    volume5m
    volume1
    volume4
    volume12
    volume24
    priceChange5m
    priceChange1
    priceChange4
    priceChange12
    priceChange24
    highPrice24
    lowPrice24
    enhancedToken0 {
      name
      symbol
      isScam
    }
    enhancedToken1 {
      name
      symbol
      isScam
    }
    walletActivity {
      suspiciousCount
      suspiciousHeldPercentage
      sniperHeldPercentage
      bundlerHeldPercentage
      insiderHeldPercentage
    }
  }
}

Finding the pair ID with listPairsWithMetadataForToken

If you don’t already have the pair ID, use listPairsWithMetadataForToken to find it. Results are sorted by liquidity so the first result is the most active pair.Test this query in the Explorer →

query FindPair {
  listPairsWithMetadataForToken(
    tokenAddress: "9wK8yN6iz1ie5kEJkvZCTxyN1x5sTdNfx8yeMY8Ebonk"
    networkId: 1399811149
    limit: 5
  ) {
    results {
      pair {
        address
        id
        token0
        token1
        fee
        protocol
      }
      backingToken {
        address
        symbol
      }
      volume
      liquidity
    }
  }
}

Use enhancedToken0 and enhancedToken1 to get enriched token metadata directly from the pair query — this saves you an extra call to token. The walletActivity block returns suspicious-wallet concentration (snipers, bundlers, insiders) and is populated for launchpad tokens — it’s null for others, where you should read these stats from filterTokens instead.

Step 3: Holders & Top Traders

Build the holders tab. Use holders for the top holder list and tokenTopTraders for the most active traders with PnL data.

Top holders

Test this query in the Explorer →

query TopHolders {
  holders(
    input: {
      tokenId: "9wK8yN6iz1ie5kEJkvZCTxyN1x5sTdNfx8yeMY8Ebonk:1399811149"
    }
  ) {
    count
    top10HoldersPercent
    items {
      address
      balance
      shiftedBalance
      balanceUsd
      tokenPriceUsd
    }
  }
}

Top traders with PnL

Test this query in the Explorer →

query TopTraders {
  tokenTopTraders(
    input: {
      tokenAddress: "9wK8yN6iz1ie5kEJkvZCTxyN1x5sTdNfx8yeMY8Ebonk"
      networkId: 1399811149
      tradingPeriod: WEEK
      limit: 20
    }
  ) {
    items {
      walletAddress
      realizedProfitUsd
      realizedProfitPercentage
      amountBoughtUsd
      amountSoldUsd
      volumeUsd
      buys
      sells
      tokenBalance
      lastTransactionAt
    }
  }
}

Step 4: Trade History

Show recent buys and sells. Use getTokenEvents for the initial load and paginate with cursor for older trades.

Recent trades

Test this query in the Explorer →

query RecentTrades {
  getTokenEvents(
    query: {
      address: "9wK8yN6iz1ie5kEJkvZCTxyN1x5sTdNfx8yeMY8Ebonk"
      networkId: 1399811149
    }
    limit: 25
  ) {
    cursor
    items {
      eventDisplayType
      timestamp
      maker
      token0SwapValueUsd
      token1SwapValueUsd
      token0Address
      token1Address
      transactionHash
      blockNumber
      walletAge
      walletLabels
    }
  }
}

Filtered by buys only with minimum size

Test this query in the Explorer →

query LargeBuys {
  getTokenEvents(
    query: {
      address: "9wK8yN6iz1ie5kEJkvZCTxyN1x5sTdNfx8yeMY8Ebonk"
      networkId: 1399811149
      eventDisplayType: [Buy]
      priceUsdTotal: { gt: 1000 }
    }
    limit: 25
  ) {
    cursor
    items {
      eventDisplayType
      timestamp
      maker
      token0SwapValueUsd
      token1SwapValueUsd
      transactionHash
      walletLabels
    }
  }
}

Step 5: Chart Data

Fetch OHLCV bars for rendering a price chart. See the Charts recipe for full details on rendering with TradingView.

OHLCV bars for chart

Test this query in the Explorer →

query TokenChart {
  getTokenBars(
    symbol: "9wK8yN6iz1ie5kEJkvZCTxyN1x5sTdNfx8yeMY8Ebonk:1399811149"
    from: 1740000000
    to: 1740604800
    resolution: "60"
  ) {
    o
    h
    l
    c
    t
    volume
  }
}

Step 6: Real-Time Updates

Once the page is loaded, open subscriptions to keep it live. Here are the key subscriptions for a token dashboard:

Live price & volume updates

Subscribe to onPairMetadataUpdated to keep price, volume, and liquidity current without polling.Test this query in the Explorer →

subscription LivePrice {
  onPairMetadataUpdated(
    id: "7GtLUbEStB1xjqVcGHqpAo4hW8uFNbLKDMcoHb7QSEXY:1399811149"
  ) {
    price
    liquidity
    volume5m
    volume1
    volume24
    priceChange5m
    priceChange1
    priceChange24
  }
}

Live trades

Subscribe to onTokenEventsCreated to stream new trades as they happen.Test this query in the Explorer →

subscription LiveTrades {
  onTokenEventsCreated(
    input: {
      tokenAddress: "9wK8yN6iz1ie5kEJkvZCTxyN1x5sTdNfx8yeMY8Ebonk"
      networkId: 1399811149
    }
  ) {
    events {
      eventDisplayType
      timestamp
      maker
      token0SwapValueUsd
      token1SwapValueUsd
      transactionHash
      walletLabels
    }
  }
}

Live chart bars

Subscribe to onTokenBarsUpdated to keep the chart updating in real time.Test this query in the Explorer →

subscription LiveChart {
  onTokenBarsUpdated(
    tokenId: "9wK8yN6iz1ie5kEJkvZCTxyN1x5sTdNfx8yeMY8Ebonk:1399811149"
  ) {
    aggregates {
      r1 {
        usd {
          o
          h
          l
          c
          t
          volume
        }
      }
    }
  }
}

Live holder updates

Subscribe to onHoldersUpdated to keep the holders list current.Test this query in the Explorer →

subscription LiveHolders {
  onHoldersUpdated(
    tokenId: "9wK8yN6iz1ie5kEJkvZCTxyN1x5sTdNfx8yeMY8Ebonk:1399811149"
  ) {
    holders
    balances {
      address
      balance
      shiftedBalance
      balanceUsd
    }
  }
}

Each subscription uses one connection toward your plan’s limit (300 for Growth plans). A single token dashboard page with all four subscriptions above uses 4 connections. Share connections across subscriptions where possible — see Subscriptions › Multiple Subscriptions for guidance on how to size each connection.

Putting It All Together

Here’s the recommended data flow for a token dashboard: On page load (queries):

token — metadata, safety, social links
pairMetadata — price, volume, liquidity
holders + tokenTopTraders — holder and trader tabs
getTokenEvents — recent trade history
getTokenBars — chart OHLCV data

After load (subscriptions):

onPairMetadataUpdated — live price and volume
onTokenEventsCreated — live trade feed
onTokenBarsUpdated — live chart updates
onHoldersUpdated — live holder changes

Optimizing calls: You can reduce initial load by running queries 1-5 in parallel — they’re all independent. For the subscriptions, open them on a single WebSocket connection to minimize connection usage.

Subscriptions vs Queries Quick Reference

Data	Query (historical)	Subscription (real-time)
Price & volume	`pairMetadata`	`onPairMetadataUpdated`
Trades	`getTokenEvents`	`onTokenEventsCreated`
Chart bars	`getBars` / `getTokenBars`	`onBarsUpdated` / `onTokenBarsUpdated`
Holders	`holders`	`onHoldersUpdated`
Token prices	`getTokenPrices`	`onPricesUpdated`

Check out the related endpoints in their respective pages:

First steps

Codex for Agents

Concepts

Recipes

Migration Guides

Resources

Detailed Token Page

Step 1: Token Metadata & Safety

Step 2: Price & Pair Data

Step 3: Holders & Top Traders

Step 4: Trade History

Step 5: Chart Data

Step 6: Real-Time Updates

Putting It All Together

Subscriptions vs Queries Quick Reference

​Step 1: Token Metadata & Safety

​Step 2: Price & Pair Data

​Step 3: Holders & Top Traders

​Step 4: Trade History

​Step 5: Chart Data

​Step 6: Real-Time Updates

​Putting It All Together

​Subscriptions vs Queries Quick Reference

Step 1: Token Metadata & Safety

Step 2: Price & Pair Data

Step 3: Holders & Top Traders

Step 4: Trade History

Step 5: Chart Data

Step 6: Real-Time Updates

Putting It All Together

Subscriptions vs Queries Quick Reference