TypeScript shape
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.
Current token price from Mobula’s pricing engine.
Current liquidity for the selected/top market.
Largest-pool LP burn percentage when available.
Current circulating market cap in USD.
Current fully diluted market cap in USD.
dexScreener
MobulaTokenDexScreenerData
Dexscreener listing, boost, ad and social-payment data.
Whether the token has completed its bonding/launchpad phase.
Current bonding progress percentage when applicable.
Bonding curve pool/address when applicable.
Unix timestamp when the token bonded/migrated.
trending
MobulaTokenTrendingScores
Trending scores across windows from Mobula’s real-time ranking engine.
Mobula mode flags such as cashback, agent, OG and mayhem modes.
sourceMetadata
MobulaTokenSourceMetadata
Source protocol metadata for the market backing this token.
sourceFactoryMetadata
MobulaTokenSourceMetadata
Factory-level source metadata for the market backing this token.