> ## Documentation Index > Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt > Use this file to discover all available pages before exploring further. # Token - Stats > Get token statistics Get aggregated trading statistics for a token including volume, trade count, unique traders, and price changes over various time windows. **Related**: [GraphQL OHLC & Stats](/en/graphql/examples/ohlc-stats) | MCP: `token_get_stats` ## OpenAPI ````yaml /en/api-reference/openapi-data-en.yaml GET /v2/token/{chain}/{tokenAddress}/stats openapi: 3.1.0 info: title: Services API description: Services API contact: name: AI email: ai@sx.ai license: name: MIT version: '1.0' servers: - url: https://api.chainstream.io description: Production security: - bearer_auth: [] - api_key_auth: [] tags: - name: Blockchain description: Blockchain related operations - name: Token description: Token related operations - name: Trade description: Trade related operations - name: Wallet description: Wallet related operations - name: Dex description: Dex related operations - name: Ranking description: Ranking related operations - name: DexPool description: DexPool related operations - name: Watchlist description: Watchlist related operations - name: KYT description: Kyt related operations - name: Webhook description: Webhook related operations - name: RedPacket description: Redpacket related operations - name: IPFS description: Ipfs related operations - name: DexScreener description: DexScreener related operations paths: /v2/token/{chain}/{tokenAddress}/stats: get: tags: - Token summary: Token - Stats description: Get token statistics operationId: get.stats parameters: - name: chain in: path description: A chain name listed in supported networks required: true schema: $ref: '#/components/schemas/ChainSymbol' example: sol - name: tokenAddress in: path description: An address of a token required: true schema: type: string example: 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN responses: '200': description: Get Stats content: application/json: schema: $ref: '#/components/schemas/TokenStats' components: schemas: ChainSymbol: type: string description: Supported blockchain chains enum: - sol - eth - bsc TokenStats: type: object description: Token statistics with nested time period data required: - address - periods properties: address: type: string description: Token contract address example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v periods: type: object description: >- Trade statistics grouped by time period (1m, 5m, 15m, 30m, 1h, 4h, 6h, 24h). Each period contains full OHLCV data, trade counts, and previous-period comparisons. See `TokenTradeStatPeriod` schema for all fields. additionalProperties: $ref: '#/components/schemas/TokenTradeStatPeriod' propertyNames: type: string example: 6h: buyVolumeInUsd: '12000.00' buyers: '120' buys: '420' closeInUsd: '0.15600000' currentLiquidityInUsd: '250000.00' highInUsd: '0.15900000' lowInUsd: '0.15100000' openInUsd: '0.15200000' priceChangeRatioInUsd: '0.02631579' sellVolumeInUsd: '9800.00' sellers: '95' sells: '360' totalVolumeInUsd: '21800.00' traders: '215' trades: '780' TokenTradeStatPeriod: type: object description: Single time window trade statistics period properties: averagePriceInNative: type: string description: Average price in native token example: '0.00005100' averagePriceInUsd: type: string description: Average price in USD example: '0.15300000' buySellRatio: type: - string - 'null' description: Buy to sell ratio example: '1.5510' buyVolume: type: string description: Buy volume in token amount example: '15000000.12345678' buyVolumeInNative: type: string description: Buy volume in native token example: '750.50' buyVolumeInUsd: type: string description: Buy volume in USD example: '45000.00' buyers: type: string description: Number of unique buyers example: '320' buys: type: string description: Number of buy trades example: '1520' closeInNative: type: string description: Closing price in native token example: '0.00005200' closeInUsd: type: string description: Closing price in USD example: '0.15600000' currentLiquidityInUsd: type: string description: Current liquidity in USD example: '250000.00' dappProgramCount: type: string description: Number of DEX programs example: '8' highInNative: type: string description: Highest price in native token example: '0.00005300' highInUsd: type: string description: Highest price in USD example: '0.15900000' liquidityChangeRatio: type: - string - 'null' description: Liquidity change ratio vs previous period example: '0.0417' lowInNative: type: string description: Lowest price in native token example: '0.00005000' lowInUsd: type: string description: Lowest price in USD example: '0.15000000' openInNative: type: string description: Opening price in native token example: '0.00005000' openInUsd: type: string description: Opening price in USD example: '0.15000000' poolCount: type: string description: Number of liquidity pools example: '12' prevBuyVolume: type: string description: Previous period buy volume in token amount example: '14000000.00' prevBuyVolumeInNative: type: string description: Previous period buy volume in native token example: '700.00' prevBuyVolumeInUsd: type: string description: Previous period buy volume in USD example: '42000.00' prevBuyers: type: string description: Previous period unique buyer count example: '300' prevBuys: type: string description: Previous period buy count example: '1400' prevCloseInNative: type: string description: Previous period closing price in native token example: '0.00005100' prevCloseInUsd: type: string description: Previous period closing price in USD example: '0.15100000' prevDappProgramCount: type: string description: Previous period DEX program count example: '7' prevHighInNative: type: string description: Previous period highest price in native token example: '0.00005100' prevHighInUsd: type: string description: Previous period highest price in USD example: '0.15200000' prevLiquidityInUsd: type: string description: Previous period liquidity in USD example: '240000.00' prevLowInNative: type: string description: Previous period lowest price in native token example: '0.00004800' prevLowInUsd: type: string description: Previous period lowest price in USD example: '0.14500000' prevOpenInNative: type: string description: Previous period opening price in native token example: '0.00004900' prevOpenInUsd: type: string description: Previous period opening price in USD example: '0.14800000' prevPoolCount: type: string description: Previous period pool count example: '10' prevSellVolume: type: string description: Previous period sell volume in token amount example: '11000000.00' prevSellVolumeInNative: type: string description: Previous period sell volume in native token example: '550.00' prevSellVolumeInUsd: type: string description: Previous period sell volume in USD example: '33000.00' prevSellers: type: string description: Previous period unique seller count example: '200' prevSells: type: string description: Previous period sell count example: '900' prevTrades: type: string description: Previous period total trade count example: '2300' priceChangeRatioInUsd: type: string description: Price change ratio in USD example: '0.04000000' sellVolume: type: string description: Sell volume in token amount example: '12000000.98765432' sellVolumeInNative: type: string description: Sell volume in native token example: '600.40' sellVolumeInUsd: type: string description: Sell volume in USD example: '36000.00' sellers: type: string description: Number of unique sellers example: '210' sells: type: string description: Number of sell trades example: '980' totalVolumeInNative: type: string description: Total trading volume in native token example: '1350.90' totalVolumeInUsd: type: string description: Total trading volume in USD example: '81000.00' traders: type: string description: Number of unique traders example: '530' trades: type: string description: Total number of trades example: '2500' updatedAt: type: - string - 'null' description: Last updated timestamp example: '2026-02-09T08:05:12.345Z' volumeChangeRatio: type: - string - 'null' description: Volume change ratio vs previous period example: '0.25' securitySchemes: bearer_auth: type: http scheme: bearer bearerFormat: JWT api_key_auth: type: apiKey in: header name: X-API-KEY ````