openapi: 3.0.3
info:
  title: Blockchain.com Charts, Stats & Market Data Addresses Network API
  description: 'Aggregated JSON endpoints covering Bitcoin network statistics, historical chart datasets,

    mining pool distribution, BTC exchange rates (ticker) and fiat-to-BTC conversion. Generated

    from https://www.blockchain.com/explorer/api/charts_api and

    https://www.blockchain.com/explorer/api/exchange_rates_api.

    '
  version: 1.0.0
  contact:
    name: Blockchain.com
    url: https://www.blockchain.com/api
  license:
    name: Blockchain.com API Terms of Service
    url: https://www.blockchain.com/legal/terms
  x-generated-from: documentation
  x-last-validated: '2026-05-30'
servers:
- url: https://api.blockchain.info
  description: Blockchain.com aggregated data host (charts, stats, pools).
- url: https://blockchain.info
  description: Blockchain.info explorer host (ticker, fiat-to-BTC conversion).
tags:
- name: Network
  description: Simple network metrics — difficulty, block height, supply, ETA, averages.
paths:
  /q/getdifficulty:
    get:
      operationId: getDifficulty
      summary: Blockchain.com Get Current Difficulty
      description: Current mining difficulty target as a decimal number.
      tags:
      - Network
      responses:
        '200':
          description: Difficulty value.
          content:
            text/plain:
              schema:
                type: string
                example: '92671248843810.34'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /q/getblockcount:
    get:
      operationId: getBlockCount
      summary: Blockchain.com Get Current Block Count
      description: Current block height in the longest chain.
      tags:
      - Network
      responses:
        '200':
          description: Block height.
          content:
            text/plain:
              schema:
                type: integer
                example: 851234
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /q/latesthash:
    get:
      operationId: getLatestHash
      summary: Blockchain.com Get the Latest Block Hash
      description: Hash of the most recent block on the longest chain.
      tags:
      - Network
      responses:
        '200':
          description: Latest block hash.
          content:
            text/plain:
              schema:
                type: string
                example: 00000000000000000004f4e7a1...
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /q/bcperblock:
    get:
      operationId: getBcPerBlock
      summary: Blockchain.com Get the Current Block Reward
      description: Current block reward in BTC.
      tags:
      - Network
      responses:
        '200':
          description: Block reward in BTC.
          content:
            text/plain:
              schema:
                type: number
                example: 3.125
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /q/totalbc:
    get:
      operationId: getTotalBc
      summary: Blockchain.com Get Total Bitcoins in Circulation
      description: Total Bitcoins in circulation (delayed by up to 1 hour), in Satoshi.
      tags:
      - Network
      responses:
        '200':
          description: Total supply in Satoshi.
          content:
            text/plain:
              schema:
                type: integer
                format: int64
                example: 1968000000000000
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /q/probability:
    get:
      operationId: getProbability
      summary: Blockchain.com Get Block Solve Probability
      description: Probability of a single hash attempt solving the next block.
      tags:
      - Network
      responses:
        '200':
          description: Probability value.
          content:
            text/plain:
              schema:
                type: number
                example: 1.0e-23
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /q/hashestowin:
    get:
      operationId: getHashesToWin
      summary: Blockchain.com Get Hashes Needed to Solve a Block
      description: Average number of hashes required to solve a single block.
      tags:
      - Network
      responses:
        '200':
          description: Hashes-to-win value.
          content:
            text/plain:
              schema:
                type: integer
                format: int64
                example: 100000000000000000000000
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /q/nextretarget:
    get:
      operationId: getNextRetarget
      summary: Blockchain.com Get Next Difficulty Retarget Block
      description: Block height of the next difficulty re-target event.
      tags:
      - Network
      responses:
        '200':
          description: Block height.
          content:
            text/plain:
              schema:
                type: integer
                example: 851840
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /q/avgtxsize:
    get:
      operationId: getAverageTxSize
      summary: Blockchain.com Get Average Transaction Size
      description: Average transaction size in bytes across the most recent blocks (configurable).
      tags:
      - Network
      parameters:
      - name: blocks
        in: query
        required: false
        description: Number of trailing blocks to average over.
        schema:
          type: integer
          default: 1000
      responses:
        '200':
          description: Average transaction size in bytes.
          content:
            text/plain:
              schema:
                type: integer
                example: 412
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /q/avgtxvalue:
    get:
      operationId: getAverageTxValue
      summary: Blockchain.com Get Average Transaction Value
      description: Average transaction value in Satoshi across the most recent blocks (configurable).
      tags:
      - Network
      parameters:
      - name: blocks
        in: query
        required: false
        description: Number of trailing blocks to average over (default 1000).
        schema:
          type: integer
          default: 1000
      responses:
        '200':
          description: Average transaction value in Satoshi.
          content:
            text/plain:
              schema:
                type: integer
                format: int64
                example: 18400000
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /q/interval:
    get:
      operationId: getBlockInterval
      summary: Blockchain.com Get Average Interval Between Blocks
      description: Average time between blocks in seconds.
      tags:
      - Network
      responses:
        '200':
          description: Interval in seconds.
          content:
            text/plain:
              schema:
                type: number
                example: 612.4
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /q/eta:
    get:
      operationId: getEta
      summary: Blockchain.com Get ETA of the Next Block
      description: Estimated number of seconds until the next block is mined.
      tags:
      - Network
      responses:
        '200':
          description: ETA in seconds.
          content:
            text/plain:
              schema:
                type: number
                example: 235.0
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /q/avgtxnumber:
    get:
      operationId: getAverageTxNumber
      summary: Blockchain.com Get Average Transactions Per Block
      description: Average number of transactions per block over the most recent blocks.
      tags:
      - Network
      parameters:
      - name: blocks
        in: query
        required: false
        description: Number of trailing blocks to average over.
        schema:
          type: integer
          default: 1000
      responses:
        '200':
          description: Average transactions per block.
          content:
            text/plain:
              schema:
                type: integer
                example: 2840
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK