> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MobulaTokenData

> Mobula-native token enrichment exposed in addition to Codex-compatible fields.

### TypeScript shape

```ts theme={null}
interface MobulaTokenData {
  chainId: string | null;
  blockchain: string | null;
  tokenType: string | null;
  type: string | null;
  rank: number | null;
  cexs: string[];
  priceUSD: number | null;
  priceToken: number | null;
  priceTokenString: string | null;
  approximateReserveUSD: number | null;
  approximateReserveTokenRaw: string | null;
  approximateReserveToken: number | null;
  liquidityUSD: number | null;
  liquidityMaxUSD: number | null;
  liquidityBurnPercentage: number | null;
  marketCapUSD: number | null;
  marketCapDilutedUSD: number | null;
  totalSupply: string | null;
  circulatingSupply: string | null;
  exchange: MobulaTokenSourceMetadata | null;
  sourceMetadata: MobulaTokenSourceMetadata | null;
  sourceFactoryMetadata: MobulaTokenSourceMetadata | null;
  factory: string | null;
  source: string | null;
  sourceFactory: string | null;
  poolAddress: string | null;
  bonded: boolean | null;
  bondingPercentage: number | null;
  bondingCurveAddress: string | null;
  preBondingFactory: string | null;
  bondedAt: number | null;
  athUSD: number | null;
  athDate: number | null;
  atlUSD: number | null;
  atlDate: number | null;
  totalFeesPaidUSD: number | null;
  totalFeesPaidNativeRaw: string | null;
  feesToVolumeRatio24h: number | null;
  stats: MobulaTokenWindowedStats | null;
  holders: MobulaTokenHolderStats | null;
  security: MobulaTokenSecurity | null;
  socialAudit: MobulaTokenSocialAudit | null;
  deployer: MobulaTokenDeployerStats | null;
  dexScreener: MobulaTokenDexScreenerData | null;
  live: MobulaTokenLiveData | null;
  modes: MobulaTokenModeFlags | null;
  trending: MobulaTokenTrendingScores | null;
  surgeScore: number | null;
}
```

`MobulaTokenData` is an additive Mobula extension. Existing Codex-compatible queries keep working unchanged; clients that want more Mobula data can select this nested object from `EnhancedToken.mobula`, `TokenInfo.mobula`, or `StreamTokenDetailsItem.mobula`.

<ResponseField name="priceUSD" type="Float">
  Current token price from Mobula's pricing engine.
</ResponseField>

<ResponseField name="liquidityUSD" type="Float">
  Current liquidity for the selected/top market.
</ResponseField>

<ResponseField name="liquidityBurnPercentage" type="Float">
  Largest-pool LP burn percentage when available.
</ResponseField>

<ResponseField name="marketCapUSD" type="Float">
  Current circulating market cap in USD.
</ResponseField>

<ResponseField name="marketCapDilutedUSD" type="Float">
  Current fully diluted market cap in USD.
</ResponseField>

<ResponseField name="stats" type="MobulaTokenWindowedStats">
  Real-time windowed stats for `1min`, `5min`, `15min`, `1h`, `4h`, `6h`, `12h`, and `24h`. See [MobulaTokenWindowedStats](/api-reference/graphql/types/MobulaTokenWindowedStats).
</ResponseField>

<ResponseField name="holders" type="MobulaTokenHolderStats">
  Holder concentration and wallet cohort stats. See [MobulaTokenHolderStats](/api-reference/graphql/types/MobulaTokenHolderStats).
</ResponseField>

<ResponseField name="security" type="MobulaTokenSecurity">
  Security score and raw security flags. See [MobulaTokenSecurity](/api-reference/graphql/types/MobulaTokenSecurity).
</ResponseField>

<ResponseField name="dexScreener" type="MobulaTokenDexScreenerData">
  Dexscreener listing, boost, ad and social-payment data.
</ResponseField>

<ResponseField name="bonded" type="Boolean">
  Whether the token has completed its bonding/launchpad phase.
</ResponseField>

<ResponseField name="bondingPercentage" type="Float">
  Current bonding progress percentage when applicable.
</ResponseField>

<ResponseField name="bondingCurveAddress" type="String">
  Bonding curve pool/address when applicable.
</ResponseField>

<ResponseField name="bondedAt" type="Int">
  Unix timestamp when the token bonded/migrated.
</ResponseField>

<ResponseField name="trending" type="MobulaTokenTrendingScores">
  Trending scores across windows from Mobula's real-time ranking engine.
</ResponseField>

<ResponseField name="modes" type="MobulaTokenModeFlags">
  Mobula mode flags such as cashback, agent, OG and mayhem modes.
</ResponseField>

<ResponseField name="sourceMetadata" type="MobulaTokenSourceMetadata">
  Source protocol metadata for the market backing this token.
</ResponseField>

<ResponseField name="sourceFactoryMetadata" type="MobulaTokenSourceMetadata">
  Factory-level source metadata for the market backing this token.
</ResponseField>