> ## 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 Runes holdings for an address with mempool awareness including pending Runes transactions. # Runes by Address (Mempool-aware) ## OpenAPI ````yaml bitcoin/mempool-monitoring-api/openapi.json get /mempool/addresses/{address}/runes 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}/runes: get: tags: - Addresses summary: Runes by Address (Mempool-aware) description: >- Provides a list of all Rune assets held by the specified address. It returns both total and available balances, allowing for token inventory management and portfolio tracking. 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_runes_by_address parameters: - name: address in: path description: Bitcoin address or hex encoded script pubkey required: true schema: type: string example: bc1phyrmjs2jm5c98tldke2ykp0h66lsx3wy0ey8ug2fjj5mxsn8ftqsa24un8 - name: mempool_blocks_limit in: query description: >- Limit the number of estimated mempool blocks to be reflected in the data (default: as many as available) required: false schema: type: integer format: int32 nullable: true minimum: 0 - name: include_info in: query description: 'Include full rune information for each rune (default: false)' required: false schema: type: boolean nullable: true responses: '200': description: Requested data content: application/json: schema: $ref: '#/components/schemas/MempoolTimestampedRuneQuantities' example: data: '840000:1': balance: '1111.00' info: divisibility: 2 etching_cenotaph: false etching_height: 840000 etching_tx: >- 2bb85f4b004be6da54f766c17c1e855187327112c231ef2ff35ebad0ea67c69e id: '840000:1' name: ZZZZZFEHUZZZZZ premine: '110000000.00' spaced_name: Z•Z•Z•Z•Z•FEHU•Z•Z•Z•Z•Z symbol: ᚠ terms: amount_per_mint: '1.00' end_height: null end_offset: null mint_txs_cap: '1111111' start_height: null start_offset: null indexer_info: chain_tip: block_hash: >- 00000000000000000002da06787fe86324e1cc1421861d899b7bd1e340aa1930 block_height: 867154 estimated_blocks: - block_height: 867155 sats_per_vb: max: 16 median: 14 min: 12 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: MempoolTimestampedRuneQuantities: type: object required: - data - indexer_info properties: data: type: object additionalProperties: 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 ````