> ## 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 UTXOs for an address with mempool awareness including pending Runes transactions. # Rune UTxOs by Address (mempool-aware) ## OpenAPI ````yaml bitcoin/mempool-monitoring-api/openapi.json get /mempool/addresses/{address}/runes/utxos 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/utxos: get: tags: - Addresses summary: Rune UTxOs by Address (mempool-aware) description: >- Lists all UTXOs at the address or script pubkey that contains Rune tokens, with optional refinement based on Rune type or metadata. Helpful for spend analysis or wallet state audits. 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_rune_utxos_by_address parameters: - name: address in: path description: Bitcoin address or hex encoded script pubkey required: true schema: type: string example: '' - name: rune in: query description: >- Return only UTxOs containing a specific Rune, specified either by the Rune ID (etching block number and transaction index) or name (spaced or un-spaced) required: false schema: type: string nullable: true example: '840000:3' - name: order_by in: query description: >- The property by which response items should be sorted. Supported values: height (height of block which produced the UTxO - default), amount (amount of runes in UTxO) required: false schema: allOf: - $ref: '#/components/schemas/OrderBy' nullable: true - name: order in: query description: >- The order in which the results are sorted. Supported values: asc, desc required: false schema: allOf: - type: string default: asc enum: - asc - desc nullable: true - name: count in: query description: The max number of results per page required: false schema: allOf: - type: integer default: 100 minimum: 0 nullable: true - name: cursor in: query description: >- Pagination cursor string, use the cursor included in a page of results to fetch the next page. required: false schema: type: string nullable: true - name: from in: query description: Return only UTxOs created on or after a specific height required: false schema: type: integer format: int64 nullable: true minimum: 0 - name: to in: query description: Return only UTxOs created on or before a specific height required: false schema: type: integer format: int64 nullable: true minimum: 0 responses: '200': description: Requested data content: application/json: schema: $ref: '#/components/schemas/MempoolPaginatedRuneUtxoByAddress' example: data: - confirmations: 20674 height: 876954 runes: - amount: '2500000' rune_id: '876947:7' satoshis: '546' txid: >- 67715c2b42eaa053fc174c68ca4f393446986567ed0509fa78eb3aa9d0b8db0b vout: 3 - confirmations: 20674 height: 876954 runes: - amount: '2500000' rune_id: '876947:7' satoshis: '546' txid: >- 67715c2b42eaa053fc174c68ca4f393446986567ed0509fa78eb3aa9d0b8db0b vout: 4 - confirmations: 20674 height: 876954 runes: - amount: '2500000' rune_id: '876947:7' satoshis: '546' txid: >- 67715c2b42eaa053fc174c68ca4f393446986567ed0509fa78eb3aa9d0b8db0b vout: 5 indexer_info: chain_tip: block_hash: >- 0000000000000000000119bd8dffd7d8285a69744011aa98f0d9091b0555ca46 block_height: 897627 estimated_blocks: - block_height: 897628 sats_per_vb: max: 202 median: 5 min: 1 mempool_timestamp: '2025-05-21 00:47:53' next_cursor: null '400': description: Malformed query parameters '404': description: Requested entity not found on-chain '500': description: Internal server error components: schemas: OrderBy: type: string default: height enum: - height - amount MempoolPaginatedRuneUtxoByAddress: type: object required: - data - indexer_info properties: data: type: array items: $ref: '#/components/schemas/RuneUtxoByAddress' indexer_info: $ref: '#/components/schemas/MempoolLastUpdated' next_cursor: type: string nullable: true RuneUtxoByAddress: type: object required: - txid - vout - satoshis - confirmations - height - runes properties: confirmations: type: integer format: int64 minimum: 0 height: type: integer format: int64 minimum: 0 runes: type: array items: $ref: '#/components/schemas/RuneAndAmount' satoshis: type: string txid: type: string vout: type: integer format: int32 minimum: 0 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 RuneAndAmount: type: object required: - rune_id - amount properties: amount: type: string rune_id: type: string 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 ````