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

> Get Bitcoin blockchain general information including network stats, block height, difficulty, and node status.

# Blockchain Info



## OpenAPI

````yaml bitcoin/node-rpc-api/openapi.json get /general/info
openapi: 3.1.0
info:
  description: >-
    This API offers direct, low-latency access to Bitcoin full nodes via API
    (JSON-RPC protocol), giving developers reliable mempool visibility,
    transaction relay capabilities, and chain data without the hassle of running
    their own infrastructure.


    #### Key Features:

    - **Full JSON-RPC Support:** Access core Bitcoin functionality through RPC
    calls like `getblock`, `getrawtransaction`, `sendrawtransaction`, etc.

    - **Blockchain Data Retrieval:** Developers can fetch detailed information
    about blocks, transactions, and addresses.

    - **Mempool Insight:** Query unconfirmed transactions for faster, more
    responsive, real-time data access.

    - **High-Availability**: Enterprise-grade infrastructure ensures uptime,
    sync accuracy and fast transaction relay.


    #### Key Benefits for Developers:

    - Skip the operational complexity and computational overhead of maintaining
    self-hosted Bitcoin nodes.

    - Query mempool and chain data to power wallets, explorers, and backends
    with minimal latency.

    - Broadcast and verify transactions with trusted relay endpoints.

    - Build production-ready Bitcoin apps without worrying about node health,
    bandwidth, or reorg handling.
  title: Bitcoin - Node RPC API
  version: 0.1.1
servers:
  - description: Bitcoin Mainnet
    url: https://xbt-mainnet.gomaestro-api.org/v0/rpc
  - description: Bitcoin Testnet
    url: https://xbt-testnet.gomaestro-api.org/v0/rpc
security:
  - api-key: []
externalDocs:
  description: ''
  url: ''
paths:
  /general/info:
    get:
      tags:
        - General
      summary: Blockchain Info
      description: >-
        Returns global node and chain info: block count, difficulty, pruning,
        fork status, etc.

        Useful for diagnostics, UI status panels, or infrastructure monitoring.
      operationId: rpc_chain_info
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_bitcoin.BlockchainInfoResponseBody'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_bitcoin.NodeRPCError'
          description: Node RPC error.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_bitcoin.APIError'
          description: Error getting blockchain info.
components:
  schemas:
    api_bitcoin.BlockchainInfoResponseBody:
      properties:
        data:
          $ref: '#/components/schemas/api_bitcoin.BlockchainInfo'
        last_updated:
          $ref: '#/components/schemas/api_bitcoin.LastUpdatedBlock'
      type: object
    api_bitcoin.NodeRPCError:
      properties:
        code:
          description: Error code returned from the API request
          example: 0
          type: integer
        node rpc error:
          description: Error returned from the API request
          example: node rpc error
          type: string
      type: object
    api_bitcoin.APIError:
      properties:
        error:
          description: Error returned from the API request
          example: Bad Request
          type: string
      type: object
    api_bitcoin.BlockchainInfo:
      properties:
        automatic_pruning:
          type: boolean
        bestblockhash:
          type: string
        blocks:
          type: integer
        chain:
          type: string
        chainwork:
          type: string
        difficulty:
          type: number
        headers:
          type: integer
        initialblockdownload:
          type: boolean
        mediantime:
          type: integer
        prune_target_size:
          type: integer
        pruned:
          type: boolean
        pruneheight:
          type: integer
        size_on_disk:
          type: integer
        softforks:
          additionalProperties:
            $ref: '#/components/schemas/api_bitcoin.Softfork'
          type: object
        verificationprogress:
          type: number
        warnings:
          type: string
      type: object
    api_bitcoin.LastUpdatedBlock:
      properties:
        block_hash:
          type: string
        block_height:
          type: integer
      type: object
    api_bitcoin.Softfork:
      properties:
        active:
          type: boolean
        bip9:
          $ref: '#/components/schemas/api_bitcoin.Bip9'
        height:
          type: integer
        type:
          type: string
      type: object
    api_bitcoin.Bip9:
      properties:
        bit:
          type: integer
        since:
          type: integer
        start_time:
          type: integer
        statistics:
          $ref: '#/components/schemas/api_bitcoin.Statistics'
        status:
          type: string
        timeout:
          type: integer
      type: object
    api_bitcoin.Statistics:
      properties:
        count:
          type: integer
        elapsed:
          type: integer
        period:
          type: integer
        possible:
          type: boolean
        threshold:
          type: integer
      type: object
  securitySchemes:
    api-key:
      description: Project API Key
      in: header
      name: api-key
      type: apiKey

````