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

# Retrieve historical network statistics

> Returns historical network statistics frames. Supports time-range queries, shard filtering, and pagination via cursor. Results are sorted by timestamp ascending. Use `nextFromMs` for cursor-based pagination when `truncated` is `true`.



## OpenAPI

````yaml /api-reference/relayer-openapi.json get /v1/network-stats/history
openapi: 3.1.0
info:
  title: XOXNO Relayer API
  version: 1.0.0
  description: >-
    High-performance transaction co-signing and broadcast service for
    MultiversX. Sign batches of transactions with shard-specific relayer keys,
    broadcast pre-signed transactions via P2P gossipsub, and query historical
    network statistics.
servers:
  - url: https://relayer.xoxno.com
security: []
paths:
  /v1/network-stats/history:
    get:
      tags:
        - Network Stats
      summary: Retrieve historical network statistics
      description: >-
        Returns historical network statistics frames. Supports time-range
        queries, shard filtering, and pagination via cursor. Results are sorted
        by timestamp ascending. Use `nextFromMs` for cursor-based pagination
        when `truncated` is `true`.
      operationId: getNetworkStatsHistory
      parameters:
        - name: fromMs
          in: query
          description: >-
            Start of time range in Unix milliseconds. Defaults to 72 hours
            before `toMs`.
          required: false
          schema:
            type: integer
            format: int64
        - name: toMs
          in: query
          description: >-
            End of time range in Unix milliseconds. Defaults to current server
            time.
          required: false
          schema:
            type: integer
            format: int64
        - name: shards
          in: query
          description: >-
            Comma-separated shard IDs to include (e.g., `0,1,2` or `meta`). Omit
            to include all shards.
          required: false
          schema:
            type: string
          example: 0,1,2
        - name: limit
          in: query
          description: >-
            Maximum number of frames to return. Server applies a default if
            omitted.
          required: false
          schema:
            type: integer
            minimum: 1
      responses:
        '200':
          description: Historical network statistics.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NetworkStatsHistoryResponse'
        '400':
          description: Invalid query parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: fromMs must be less than or equal to toMs
        '503':
          description: Network stats tracker is not yet available.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: network stats tracker is not available
components:
  schemas:
    NetworkStatsHistoryResponse:
      type: object
      properties:
        networkBlocks:
          type: array
          items:
            $ref: '#/components/schemas/NetworkBlockHistory'
          description: Metachain-level block history entries sorted by timestamp.
        shardBlocks:
          type: object
          additionalProperties:
            type: array
            items:
              $ref: '#/components/schemas/ShardBlockHistory'
          description: >-
            Per-shard block history keyed by shard ID string (`"0"`, `"1"`,
            `"2"`).
        nextFromMs:
          type:
            - integer
            - 'null'
          format: int64
          description: >-
            Cursor value. Pass as `fromMs` in the next request to continue
            pagination. `null` when there are no more results.
        truncated:
          type: boolean
          description: >-
            `true` when the result set was limited by `limit` and more data is
            available.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message.
    NetworkBlockHistory:
      type: object
      properties:
        timestampMs:
          type: integer
          format: int64
          description: Server timestamp in milliseconds (Unix epoch).
        nonce:
          type: integer
          format: uint64
          description: Metachain block nonce.
        round:
          type: integer
          format: uint64
          description: Consensus round number.
        epoch:
          type: integer
          format: uint32
          description: Epoch number.
        globalTxCount:
          type: integer
          format: uint32
          description: Total transactions across all shards in this metablock.
        notarizedTps:
          type: number
          format: double
          description: Notarized transactions per second.
        currentAps:
          type: number
          format: double
          description: Current accounts per second.
        shardTpsShare:
          type: object
          additionalProperties:
            type: number
            format: double
          description: Per-shard TPS share keyed by shard ID.
    ShardBlockHistory:
      type: object
      properties:
        shardId:
          type: integer
          format: uint32
          description: Shard identifier.
        nonce:
          type: integer
          format: uint64
          description: Block nonce (height).
        round:
          type: integer
          format: uint64
          description: Consensus round number.
        epoch:
          type: integer
          format: uint32
          description: Epoch number.
        timestampMs:
          type: integer
          format: uint64
          description: Block timestamp in milliseconds.
        txCount:
          type: integer
          format: uint32
          description: Total transactions included in the block.
        executedTxCount:
          type: integer
          format: uint64
          description: Transactions successfully executed.
        leaderBlsHex:
          type:
            - string
            - 'null'
          description: BLS public key of the block proposer in hex.
        nextLeaderBlsHex:
          type:
            - string
            - 'null'
          description: BLS public key of the next block proposer in hex.
        latestUniqueAccounts:
          type:
            - integer
            - 'null'
          format: uint64
          description: Number of unique accounts touched in this block.
        proposalToFinalityMs:
          type:
            - integer
            - 'null'
          format: uint64
          description: Time from block proposal to finality in milliseconds.
        aps:
          type: number
          format: double
          description: Accounts per second for this shard block.
        hashHex:
          type:
            - string
            - 'null'
          description: Block hash in hex format.

````