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

# Token statistics

> Subscribe to token stats (multi-timeframe statistics)



## AsyncAPI

````yaml datastream/asyncapi.json tokenStatistics
id: tokenStatistics
title: Token statistics
description: Subscribe to token stats (multi-timeframe statistics)
servers:
  - id: production
    protocol: wss
    host: datastream.solanatracker.io
    bindings: []
    variables:
      - id: apiKey
        description: Your unique API key from Data API subscription
        allowedValues: []
        examples: []
address: /
parameters: []
bindings: []
operations:
  - &ref_2
    id: subscribeToTokenStats
    title: Subscribe to token stats
    description: Subscribe to token statistics
    type: receive
    messages:
      - &ref_6
        id: joinTokenStats
        payload:
          - name: joinTokenStats
            description: Subscribe to token statistics
            type: object
            properties:
              - name: type
                type: string
                description: join
                required: true
              - name: room
                type: string
                description: Stats room (stats:token:{tokenAddress})
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          required:
            - type
            - room
          properties:
            type:
              type: string
              const: join
              default: join
              x-parser-schema-id: <anonymous-schema-553>
            room:
              type: string
              pattern: ^stats:token:[A-Za-z0-9]{32,44}$
              description: Stats room (stats:token:{tokenAddress})
              default: stats:token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
              x-parser-schema-id: <anonymous-schema-554>
          examples:
            - type: join
              room: stats:token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
          x-parser-schema-id: <anonymous-schema-552>
        title: Join token stats
        description: Subscribe to token statistics
        example: |-
          {
            "type": "join",
            "room": "stats:token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: joinTokenStats
          - id: x-parser-message-name
            value: joinTokenStats
    bindings: []
    extensions: &ref_0
      - id: x-parser-unique-object-id
        value: tokenStatistics
  - &ref_4
    id: receiveTokenStatsConfirmation
    title: Receive token stats confirmation
    description: Receive stats confirmation
    type: send
    messages:
      - &ref_8
        id: tokenStatsJoined
        payload:
          - name: tokenStatsJoined
            description: Token stats subscription confirmed
            type: object
            properties:
              - name: type
                type: string
                description: joined
                required: false
              - name: room
                type: string
                required: false
        headers: []
        jsonPayloadSchema:
          type: object
          properties:
            type:
              type: string
              const: joined
              x-parser-schema-id: <anonymous-schema-556>
            room:
              type: string
              x-parser-schema-id: <anonymous-schema-557>
          examples:
            - type: joined
              room: stats:token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
          x-parser-schema-id: <anonymous-schema-555>
        title: Token stats joined
        description: Token stats subscription confirmed
        example: |-
          {
            "type": "joined",
            "room": "stats:token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: tokenStatsJoined
          - id: x-parser-message-name
            value: tokenStatsJoined
    bindings: []
    extensions: *ref_0
  - &ref_5
    id: receiveTokenStatsData
    title: Receive token stats data
    description: Receive statistics
    type: send
    messages:
      - &ref_9
        id: tokenStatsMessage
        payload:
          - name: tokenStatsMessage
            description: Token statistics notification
            type: object
            properties:
              - name: type
                type: string
                description: message
                required: false
              - name: room
                type: string
                required: false
              - name: data
                type: object
                required: false
                properties:
                  - name: 1m
                    type: object
                    required: false
                    properties:
                      - name: buyers
                        type: integer
                        required: false
                      - name: sellers
                        type: integer
                        required: false
                      - name: volume
                        type: object
                        required: false
                        properties:
                          - name: buys
                            type: number
                            required: false
                          - name: sells
                            type: number
                            required: false
                          - name: total
                            type: number
                            required: false
                      - name: transactions
                        type: integer
                        required: false
                      - name: buys
                        type: integer
                        required: false
                      - name: sells
                        type: integer
                        required: false
                      - name: wallets
                        type: integer
                        required: false
                      - name: price
                        type: number
                        required: false
                      - name: priceChangePercentage
                        type: number
                        required: false
                  - name: 5m
                    type: object
                    required: false
                    properties:
                      - name: buyers
                        type: integer
                        required: false
                      - name: sellers
                        type: integer
                        required: false
                      - name: volume
                        type: object
                        required: false
                        properties:
                          - name: buys
                            type: number
                            required: false
                          - name: sells
                            type: number
                            required: false
                          - name: total
                            type: number
                            required: false
                      - name: transactions
                        type: integer
                        required: false
                      - name: buys
                        type: integer
                        required: false
                      - name: sells
                        type: integer
                        required: false
                      - name: wallets
                        type: integer
                        required: false
                      - name: price
                        type: number
                        required: false
                      - name: priceChangePercentage
                        type: number
                        required: false
                  - name: 15m
                    type: object
                    required: false
                    properties:
                      - name: buyers
                        type: integer
                        required: false
                      - name: sellers
                        type: integer
                        required: false
                      - name: volume
                        type: object
                        required: false
                        properties:
                          - name: buys
                            type: number
                            required: false
                          - name: sells
                            type: number
                            required: false
                          - name: total
                            type: number
                            required: false
                      - name: transactions
                        type: integer
                        required: false
                      - name: buys
                        type: integer
                        required: false
                      - name: sells
                        type: integer
                        required: false
                      - name: wallets
                        type: integer
                        required: false
                      - name: price
                        type: number
                        required: false
                      - name: priceChangePercentage
                        type: number
                        required: false
                  - name: 30m
                    type: object
                    required: false
                    properties:
                      - name: buyers
                        type: integer
                        required: false
                      - name: sellers
                        type: integer
                        required: false
                      - name: volume
                        type: object
                        required: false
                        properties:
                          - name: buys
                            type: number
                            required: false
                          - name: sells
                            type: number
                            required: false
                          - name: total
                            type: number
                            required: false
                      - name: transactions
                        type: integer
                        required: false
                      - name: buys
                        type: integer
                        required: false
                      - name: sells
                        type: integer
                        required: false
                      - name: wallets
                        type: integer
                        required: false
                      - name: price
                        type: number
                        required: false
                      - name: priceChangePercentage
                        type: number
                        required: false
                  - name: 1h
                    type: object
                    required: false
                    properties:
                      - name: buyers
                        type: integer
                        required: false
                      - name: sellers
                        type: integer
                        required: false
                      - name: volume
                        type: object
                        required: false
                        properties:
                          - name: buys
                            type: number
                            required: false
                          - name: sells
                            type: number
                            required: false
                          - name: total
                            type: number
                            required: false
                      - name: transactions
                        type: integer
                        required: false
                      - name: buys
                        type: integer
                        required: false
                      - name: sells
                        type: integer
                        required: false
                      - name: wallets
                        type: integer
                        required: false
                      - name: price
                        type: number
                        required: false
                      - name: priceChangePercentage
                        type: number
                        required: false
                  - name: 2h
                    type: object
                    required: false
                    properties:
                      - name: buyers
                        type: integer
                        required: false
                      - name: sellers
                        type: integer
                        required: false
                      - name: volume
                        type: object
                        required: false
                        properties:
                          - name: buys
                            type: number
                            required: false
                          - name: sells
                            type: number
                            required: false
                          - name: total
                            type: number
                            required: false
                      - name: transactions
                        type: integer
                        required: false
                      - name: buys
                        type: integer
                        required: false
                      - name: sells
                        type: integer
                        required: false
                      - name: wallets
                        type: integer
                        required: false
                      - name: price
                        type: number
                        required: false
                      - name: priceChangePercentage
                        type: number
                        required: false
                  - name: 3h
                    type: object
                    required: false
                    properties:
                      - name: buyers
                        type: integer
                        required: false
                      - name: sellers
                        type: integer
                        required: false
                      - name: volume
                        type: object
                        required: false
                        properties:
                          - name: buys
                            type: number
                            required: false
                          - name: sells
                            type: number
                            required: false
                          - name: total
                            type: number
                            required: false
                      - name: transactions
                        type: integer
                        required: false
                      - name: buys
                        type: integer
                        required: false
                      - name: sells
                        type: integer
                        required: false
                      - name: wallets
                        type: integer
                        required: false
                      - name: price
                        type: number
                        required: false
                      - name: priceChangePercentage
                        type: number
                        required: false
                  - name: 4h
                    type: object
                    required: false
                    properties:
                      - name: buyers
                        type: integer
                        required: false
                      - name: sellers
                        type: integer
                        required: false
                      - name: volume
                        type: object
                        required: false
                        properties:
                          - name: buys
                            type: number
                            required: false
                          - name: sells
                            type: number
                            required: false
                          - name: total
                            type: number
                            required: false
                      - name: transactions
                        type: integer
                        required: false
                      - name: buys
                        type: integer
                        required: false
                      - name: sells
                        type: integer
                        required: false
                      - name: wallets
                        type: integer
                        required: false
                      - name: price
                        type: number
                        required: false
                      - name: priceChangePercentage
                        type: number
                        required: false
                  - name: 5h
                    type: object
                    required: false
                    properties:
                      - name: buyers
                        type: integer
                        required: false
                      - name: sellers
                        type: integer
                        required: false
                      - name: volume
                        type: object
                        required: false
                        properties:
                          - name: buys
                            type: number
                            required: false
                          - name: sells
                            type: number
                            required: false
                          - name: total
                            type: number
                            required: false
                      - name: transactions
                        type: integer
                        required: false
                      - name: buys
                        type: integer
                        required: false
                      - name: sells
                        type: integer
                        required: false
                      - name: wallets
                        type: integer
                        required: false
                      - name: price
                        type: number
                        required: false
                      - name: priceChangePercentage
                        type: number
                        required: false
                  - name: 6h
                    type: object
                    required: false
                    properties:
                      - name: buyers
                        type: integer
                        required: false
                      - name: sellers
                        type: integer
                        required: false
                      - name: volume
                        type: object
                        required: false
                        properties:
                          - name: buys
                            type: number
                            required: false
                          - name: sells
                            type: number
                            required: false
                          - name: total
                            type: number
                            required: false
                      - name: transactions
                        type: integer
                        required: false
                      - name: buys
                        type: integer
                        required: false
                      - name: sells
                        type: integer
                        required: false
                      - name: wallets
                        type: integer
                        required: false
                      - name: price
                        type: number
                        required: false
                      - name: priceChangePercentage
                        type: number
                        required: false
                  - name: 12h
                    type: object
                    required: false
                    properties:
                      - name: buyers
                        type: integer
                        required: false
                      - name: sellers
                        type: integer
                        required: false
                      - name: volume
                        type: object
                        required: false
                        properties:
                          - name: buys
                            type: number
                            required: false
                          - name: sells
                            type: number
                            required: false
                          - name: total
                            type: number
                            required: false
                      - name: transactions
                        type: integer
                        required: false
                      - name: buys
                        type: integer
                        required: false
                      - name: sells
                        type: integer
                        required: false
                      - name: wallets
                        type: integer
                        required: false
                      - name: price
                        type: number
                        required: false
                      - name: priceChangePercentage
                        type: number
                        required: false
                  - name: 24h
                    type: object
                    required: false
                    properties:
                      - name: buyers
                        type: integer
                        required: false
                      - name: sellers
                        type: integer
                        required: false
                      - name: volume
                        type: object
                        required: false
                        properties:
                          - name: buys
                            type: number
                            required: false
                          - name: sells
                            type: number
                            required: false
                          - name: total
                            type: number
                            required: false
                      - name: transactions
                        type: integer
                        required: false
                      - name: buys
                        type: integer
                        required: false
                      - name: sells
                        type: integer
                        required: false
                      - name: wallets
                        type: integer
                        required: false
                      - name: price
                        type: number
                        required: false
                      - name: priceChangePercentage
                        type: number
                        required: false
        headers: []
        jsonPayloadSchema:
          type: object
          properties:
            type:
              type: string
              const: message
              x-parser-schema-id: <anonymous-schema-559>
            room:
              type: string
              x-parser-schema-id: <anonymous-schema-560>
            data:
              type: object
              properties:
                1m: &ref_1
                  type: object
                  properties:
                    buyers:
                      type: integer
                      x-parser-schema-id: <anonymous-schema-561>
                    sellers:
                      type: integer
                      x-parser-schema-id: <anonymous-schema-562>
                    volume:
                      type: object
                      properties:
                        buys:
                          type: number
                          x-parser-schema-id: <anonymous-schema-564>
                        sells:
                          type: number
                          x-parser-schema-id: <anonymous-schema-565>
                        total:
                          type: number
                          x-parser-schema-id: <anonymous-schema-566>
                      x-parser-schema-id: <anonymous-schema-563>
                    transactions:
                      type: integer
                      x-parser-schema-id: <anonymous-schema-567>
                    buys:
                      type: integer
                      x-parser-schema-id: <anonymous-schema-568>
                    sells:
                      type: integer
                      x-parser-schema-id: <anonymous-schema-569>
                    wallets:
                      type: integer
                      x-parser-schema-id: <anonymous-schema-570>
                    price:
                      type: number
                      x-parser-schema-id: <anonymous-schema-571>
                    priceChangePercentage:
                      type: number
                      x-parser-schema-id: <anonymous-schema-572>
                  x-parser-schema-id: TimeframeStats
                5m: *ref_1
                15m: *ref_1
                30m: *ref_1
                1h: *ref_1
                2h: *ref_1
                3h: *ref_1
                4h: *ref_1
                5h: *ref_1
                6h: *ref_1
                12h: *ref_1
                24h: *ref_1
              x-parser-schema-id: TokenStats
          examples:
            - type: message
              room: stats:token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
              data:
                1m:
                  buyers: 5
                  sellers: 3
                  volume:
                    buys: 729.54
                    sells: 1710.84
                    total: 2440.38
                  transactions: 15
                  buys: 10
                  sells: 5
                  wallets: 8
                  price: 3.3549
                  priceChangePercentage: 1.67
                5m:
                  buyers: 11
                  sellers: 6
                  volume:
                    buys: 11607.66
                    sells: 21107.35
                    total: 32715.01
                  transactions: 106
                  buys: 76
                  sells: 30
                  wallets: 15
                  price: 3.3553
                  priceChangePercentage: 1.66
                1h:
                  buyers: 51
                  sellers: 62
                  volume:
                    buys: 392340.86
                    sells: 188623.75
                    total: 580964.61
                  transactions: 1436
                  buys: 1063
                  sells: 373
                  wallets: 99
                  price: 3.374
                  priceChangePercentage: 1.1
                24h:
                  buyers: 705
                  sellers: 775
                  volume:
                    buys: 6979036.54
                    sells: 8441032.82
                    total: 15420069.36
                  transactions: 36467
                  buys: 21456
                  sells: 15011
                  wallets: 1216
                  price: 3.7107
                  priceChangePercentage: -8.08
          x-parser-schema-id: <anonymous-schema-558>
        title: Token stats message
        description: Token statistics notification
        example: |-
          {
            "type": "message",
            "room": "stats:token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
            "data": {
              "1m": {
                "buyers": 5,
                "sellers": 3,
                "volume": {
                  "buys": 729.54,
                  "sells": 1710.84,
                  "total": 2440.38
                },
                "transactions": 15,
                "buys": 10,
                "sells": 5,
                "wallets": 8,
                "price": 3.3549,
                "priceChangePercentage": 1.67
              },
              "5m": {
                "buyers": 11,
                "sellers": 6,
                "volume": {
                  "buys": 11607.66,
                  "sells": 21107.35,
                  "total": 32715.01
                },
                "transactions": 106,
                "buys": 76,
                "sells": 30,
                "wallets": 15,
                "price": 3.3553,
                "priceChangePercentage": 1.66
              },
              "1h": {
                "buyers": 51,
                "sellers": 62,
                "volume": {
                  "buys": 392340.86,
                  "sells": 188623.75,
                  "total": 580964.61
                },
                "transactions": 1436,
                "buys": 1063,
                "sells": 373,
                "wallets": 99,
                "price": 3.374,
                "priceChangePercentage": 1.1
              },
              "24h": {
                "buyers": 705,
                "sellers": 775,
                "volume": {
                  "buys": 6979036.54,
                  "sells": 8441032.82,
                  "total": 15420069.36
                },
                "transactions": 36467,
                "buys": 21456,
                "sells": 15011,
                "wallets": 1216,
                "price": 3.7107,
                "priceChangePercentage": -8.08
              }
            }
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: tokenStatsMessage
          - id: x-parser-message-name
            value: tokenStatsMessage
    bindings: []
    extensions: *ref_0
  - &ref_3
    id: unsubscribeFromTokenStats
    title: Unsubscribe from token stats
    description: Unsubscribe from stats
    type: receive
    messages:
      - &ref_7
        id: leaveTokenStats
        payload:
          - name: leaveTokenStats
            description: Unsubscribe from token statistics
            type: object
            properties:
              - name: type
                type: string
                description: leave
                required: true
              - name: room
                type: string
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          required:
            - type
            - room
          properties:
            type:
              type: string
              const: leave
              default: leave
              x-parser-schema-id: <anonymous-schema-574>
            room:
              type: string
              default: stats:token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
              x-parser-schema-id: <anonymous-schema-575>
          examples:
            - type: leave
              room: stats:token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
          x-parser-schema-id: <anonymous-schema-573>
        title: Leave token stats
        description: Unsubscribe from token statistics
        example: |-
          {
            "type": "leave",
            "room": "stats:token:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: leaveTokenStats
          - id: x-parser-message-name
            value: leaveTokenStats
    bindings: []
    extensions: *ref_0
sendOperations:
  - *ref_2
  - *ref_3
receiveOperations:
  - *ref_4
  - *ref_5
sendMessages:
  - *ref_6
  - *ref_7
receiveMessages:
  - *ref_8
  - *ref_9
extensions:
  - id: x-parser-unique-object-id
    value: tokenStatistics
securitySchemes:
  - id: apiKeyAuth
    name: apiKey
    type: httpApiKey
    description: >-
      API key for authentication. Include your Datastream key in the connection
      URL: wss://datastream.solanatracker.io/{DATASTREAM_KEY}
    in: header
    extensions: []

````