> ## 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 address balance with mempool awareness including pending transactions and real-time updates.

# Satoshi Balance by Address (Mempool-aware)



## OpenAPI

````yaml bitcoin/mempool-monitoring-api/openapi.json get /mempool/addresses/{address}/balance
openapi: 3.0.3
info:
  title: Bitcoin - Mempool Monitoring API
  description: >-
    Maestro's Bitcoin Mempool Monitoring API offers core indexer endpoints with
    mempool awareness, providing real-time visibility into unconfirmed
    transactions, enabling developers to build responsive, fee-optimized, and
    mempool-aware applications without managing their own node infrastructure.


    #### Key Features:

    - **Real-Time Transaction Monitoring:** Track unconfirmed transactions
    instantly as they enter the mempool, providing immediate insights for
    enhanced user experience.

    - **Optimal Fee Estimation:** Analyze current mempool conditions to help
    users set appropriate transaction fees, ensuring timely confirmations and
    cost efficiency.

    - **Network Health Analysis:** Monitor mempool size and state to detect
    network congestion and anomalies, aiding in informed decision-making
    regarding transaction timing.

    - **Custom Transaction Selection for Miners:** Utilize mempool data to
    prioritize transactions with higher fees, maximizing profits during block
    construction.


    #### Key Benefits for Developers:

    Developers can enhance their applications and improve user experience
    through real-time blockchain insights and optimized transaction processing.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.txt
  version: v0.1.0
servers:
  - url: https://xbt-mainnet.gomaestro-api.org/v0
    description: Bitcoin Mainnet
  - url: https://xbt-testnet.gomaestro-api.org/v0
    description: Bitcoin Testnet
security:
  - api-key: []
paths:
  /mempool/addresses/{address}/balance:
    get:
      tags:
        - Addresses
      summary: Satoshi Balance by Address (Mempool-aware)
      description: >-
        Returns the total balance in satoshis held at the specified address or
        script pubkey by summing all unspent outputs (UTXOs).


        In addition to confirmed transactions, mempool endpoints return data
        which reflects pending transactions in some number of "estimated" blocks
        - predicted blocks containing transactions which have been propagated
        around the network but not yet included in a mined block, with
        transactions with a higher sat/vB value being prioritised. The response
        details how many of these estimated blocks were considered when fetching
        the data.
      operationId: mempool_satoshi_balance_by_address
      parameters:
        - name: address
          in: path
          description: Bitcoin address or hex encoded script pubkey
          required: true
          schema:
            type: string
          example: bc1phyrmjs2jm5c98tldke2ykp0h66lsx3wy0ey8ug2fjj5mxsn8ftqsa24un8
      responses:
        '200':
          description: Requested data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MempoolTimestampedSatoshis'
              example:
                data: '695100'
                indexer_info:
                  chain_tip:
                    block_hash: >-
                      000000000000000000012c80ffd2f0bd17f1f92a0bb4c098236d7108f727bfe5
                    block_height: 874584
                  estimated_blocks:
                    - block_height: 874585
                      sats_per_vb:
                        max: 504
                        median: 8
                        min: 1
                  mempool_timestamp: '2025-01-06 16:43:32'
        '400':
          description: Malformed query parameters
        '404':
          description: Requested entity not found on-chain
        '500':
          description: Internal server error
components:
  schemas:
    MempoolTimestampedSatoshis:
      type: object
      required:
        - data
        - indexer_info
      properties:
        data:
          type: string
        indexer_info:
          $ref: '#/components/schemas/MempoolLastUpdated'
    MempoolLastUpdated:
      type: object
      required:
        - chain_tip
        - estimated_blocks
      properties:
        chain_tip:
          $ref: '#/components/schemas/ChainTip'
        estimated_blocks:
          type: array
          items:
            $ref: '#/components/schemas/EstimatedBlock'
          description: >-
            Information about any estimated blocks from the mempool that were
            indexed in addition to the mainchain
        mempool_timestamp:
          type: string
          description: >-
            Timestamp of the indexed mempool snapshot, if any estimated blocks
            from the mempool have been indexed
          nullable: true
    ChainTip:
      type: object
      required:
        - block_hash
        - block_height
      properties:
        block_hash:
          type: string
          description: The hash of the block
          example: 0000000000000000000a7f3b7b6b6e1d9a18db65a3b4a3f4f3bcb2e1f1b2d3e7
        block_height:
          type: integer
          format: int64
          description: The height of the block in the blockchain
          example: 707000
          minimum: 0
    EstimatedBlock:
      type: object
      required:
        - block_height
        - sats_per_vb
      properties:
        block_height:
          type: integer
          format: int64
          description: Height of the estimated block
          example: '707001'
          minimum: 0
        sats_per_vb:
          $ref: '#/components/schemas/BlockSatsPerVb'
    BlockSatsPerVb:
      type: object
      description: >-
        For transactions within a block, these are the lowest, median and
        highest

        satoshis per virtual-byte values.
      required:
        - min
        - median
        - max
      properties:
        max:
          type: integer
          format: int64
          description: Highest sat/vB value of the transactions within the block
          example: 255
          minimum: 0
        median:
          type: integer
          format: int64
          description: Median sat/vB value of the transactions within the block
          example: 15
          minimum: 0
        min:
          type: integer
          format: int64
          description: Lowest sat/vB value of the transactions within the block
          example: 11
          minimum: 0
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: api-key
      description: Project API Key

````