> ## 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 transaction information with metaprotocol data including Runes, Inscriptions, and BRC-20 token activities.

# Transaction Info with Metaprotocols



## OpenAPI

````yaml bitcoin/blockchain-indexer-api/openapi.json get /transactions/{tx_hash}/metaprotocols
openapi: 3.0.3
info:
  title: Bitcoin - Blockchain Indexer API
  description: >-
    This API provides core indexer endpoints with support for Bitcoin
    metaprotocols by delivering real-time, rollback-protected access to
    Bitcoin's UTXO data, enabling developers to build responsive and reliable
    blockchain applications without managing complex infrastructure.


    #### Key Features:

    - **Real-Time Data with Rollback Protection:** Ensures data accuracy by
    handling chain reorganizations gracefully, providing live data without
    sacrificing integrity.

    - **Comprehensive UTXO Indexing:** Specialized pipelines extract, match, and
    process on-chain information, including handling rollbacks, to provide
    accurate and up-to-date data.


    #### Key Benefits for Developers:

    By abstracting the complexities of blockchain data retrieval and processing,
    Maestro's Bitcoin Indexer API empowers developers to focus on building
    innovative applications with confidence in fast and reliable access to
    historical chain data.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.txt
  version: v0.2.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:
  /transactions/{tx_hash}/metaprotocols:
    get:
      tags:
        - Transactions
      summary: Transaction Info with Metaprotocols
      description: >-
        Returns an enhanced view of the transaction, including info about
        metaprotocols in both inputs and outputs. Useful for deep inspection
        tools.
      operationId: tx_info_with_metaprotocols
      parameters:
        - name: tx_hash
          in: path
          description: Transaction hash
          required: true
          schema:
            type: string
          example: 1b07f02356aed6ddca37db8226c6292f2953d55ea741d7f58d44427976e7d4ee
      responses:
        '200':
          description: Requested data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TimestampedTxInfoMetaprotocols'
              example:
                data:
                  block_hash: >-
                    000000000000000000011c58d06536d2c1453a4742274efc2d4456921f027e98
                  confirmations: 95
                  fees: '1548800'
                  height: 866807
                  inputs:
                    - address: >-
                        bc1ppth27qnr74qhusy9pmcyeaelgvsfky6qzquv9nf56gqmte59vfhqwkqguh
                      inscriptions:
                        - inscription_id: >-
                            6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0
                          offset: 0
                      runes: []
                      satoshis: '606'
                      script_pubkey: >-
                        51200aeeaf0263f5417e40850ef04cf73f43209b13401038c2cd34d201b5e685626e
                      txid: >-
                        47c7260764af2ee17aa584d9c035f2e5429aefd96b8016cfe0e3f0bcf04869a3
                      vout: 0
                    - address: >-
                        bc1pfqgphdlagqahqe5yf5a4yja9nz4hdeycvcmk3j0r3kr79ltetfvqhnlguu
                      inscriptions: []
                      runes: []
                      satoshis: '10000'
                      script_pubkey: >-
                        512048101bb7fd403b7066844d3b524ba598ab76e498663768c9e38d87e2fd795a58
                      txid: >-
                        fbf8ccedf64109568cb69485b28de876547a8c51bbf8f623c1906a69fdf16be4
                      vout: 0
                    - address: >-
                        bc1paefyrryx8j75fe2njzd7flnss9vgse0f9njewm7qpxaaypafhjasjn7qgw
                      inscriptions: []
                      runes: []
                      satoshis: '1558800'
                      script_pubkey: >-
                        5120ee52418c863cbd44e553909be4fe7081588865e92ce5976fc009bbd207a9bcbb
                      txid: >-
                        42d82813e9fb16bcf14b75bd78a1e16983e40d2e04f6c7087dde83e1d93c509b
                      vout: 0
                  metaprotocols:
                    - inscriptions
                    - brc20
                  outputs:
                    - address: >-
                        bc1p6ka80aqd57wjskxknnfzmswl27tegkejcsfa0v600s6rxle5lagqg38e88
                      inscriptions:
                        - inscription_id: >-
                            6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0
                          offset: 0
                      runes: []
                      satoshis: '606'
                      script_pubkey: >-
                        5120d5ba77f40da79d2858d69cd22dc1df5797945b32c413d7b34f7c34337f34ff50
                      spending_tx: null
                    - address: >-
                        bc1p5kjec5vl67yydqqljy4t97hdxq05s62qyqmmgzxhmqcd628ecuqs8c9w97
                      inscriptions:
                        - inscription_id: >-
                            1b07f02356aed6ddca37db8226c6292f2953d55ea741d7f58d44427976e7d4eei0
                          offset: 0
                      runes: []
                      satoshis: '10000'
                      script_pubkey: >-
                        5120a5a59c519fd78846801f912ab2faed301f4869402037b408d7d830dd28f9c701
                      spending_tx: null
                    - address: >-
                        bc1p6uzgus82tyx8d4xt7eh0f6kxqn53a03529cyh9wmqcwchm6uvmtqkt5sdv
                      inscriptions: []
                      runes:
                        - amount: '50000000'
                          rune_id: '866807:12'
                      satoshis: '10000'
                      script_pubkey: >-
                        5120d7048e40ea590c76d4cbf66ef4eac604e91ebe3451704b95db061d8bef5c66d6
                      spending_tx: >-
                        72b6ccd9289cc2aac7c9e55b3fa9185115313702e10bee31c79c87fd5ef5fff6
                    - address: null
                      inscriptions: []
                      runes: []
                      satoshis: '0'
                      script_pubkey: >-
                        6a5d23020704f0daddcdf988a80303400580e9070680e1eb170ae80708d086030cdafe341602
                      spending_tx: null
                  sats_per_vb: 1600
                  timestamp: '2024-10-22 06:16:34'
                  tx_index: 12
                  unix_timestamp: 1729577794
                  volume: '20606'
                last_updated:
                  block_hash: >-
                    00000000000000000001676a1898b7804be18303e68e8ceacc00c713011b0ef4
                  block_height: 866902
        '400':
          description: Malformed query parameters
        '404':
          description: Requested entity not found on-chain
        '500':
          description: Internal server error
components:
  schemas:
    TimestampedTxInfoMetaprotocols:
      type: object
      required:
        - data
        - last_updated
      properties:
        data:
          $ref: '#/components/schemas/TxInfoMetaprotocols'
        last_updated:
          $ref: '#/components/schemas/ChainTip'
    TxInfoMetaprotocols:
      type: object
      required:
        - height
        - block_hash
        - confirmations
        - unix_timestamp
        - timestamp
        - tx_index
        - volume
        - fees
        - sats_per_vb
        - metaprotocols
        - inputs
        - outputs
      properties:
        block_hash:
          type: string
          description: Block hash.
          example: 0000000000000000000290db65621592a96224ecbe92ae22532a35dc40213471
        confirmations:
          type: integer
          format: int64
          description: Number of confirmations of the block.
          example: 3
          minimum: 0
        fees:
          type: string
          description: Fees paid to the miner.
          example: '2504'
        height:
          type: integer
          format: int64
          description: Block height.
          example: 875075
          minimum: 0
        inputs:
          type: array
          items:
            $ref: '#/components/schemas/TxInMetaprotocols'
          description: List of inputs, in the same order as the transaction.
        metaprotocols:
          type: array
          items:
            $ref: '#/components/schemas/Metaprotocol'
          description: Whether any of the transactions in the block involved metaprotocols.
        outputs:
          type: array
          items:
            $ref: '#/components/schemas/TxOutMetaprotocols'
          description: List of outputs, in the same order as the transaction.
        sats_per_vb:
          type: integer
          format: int64
          description: sats per vB of the transaction.
          example: 15
          minimum: 0
        timestamp:
          type: string
          description: The timestamp of the block, as claimed by the miner, in UTC format.
          example: '2024-12-16 22:48:06'
        tx_index:
          type: integer
          format: int32
          description: Index of transaction in block.
          example: 123
          minimum: 0
        unix_timestamp:
          type: integer
          format: int32
          description: The timestamp of the block, as claimed by the miner.
          example: 1734389286
          minimum: 0
        volume:
          type: string
          description: >-
            Total number of satoshis that went through this transaction, minus
            fees.
          example: '12345678'
    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
    TxInMetaprotocols:
      type: object
      required:
        - txid
        - vout
        - script_pubkey
        - satoshis
        - inscriptions
        - runes
      properties:
        address:
          type: string
          description: Address-encoding of the script pubkey at which the input resides.
          example: bc1p5u4y8vdhn46adxhfv5scfv4c8myykw6r5uyzlavm42k4wgjewktq7xqcyr
          nullable: true
        inscriptions:
          type: array
          items:
            $ref: '#/components/schemas/InscriptionAndOffset'
          description: List of inscription IDs and their offsets in this input.
        runes:
          type: array
          items:
            $ref: '#/components/schemas/RuneAndAmount'
          description: List of rune IDs and their amount in this input.
        satoshis:
          type: string
          description: Total number of satoshis in the UTxO.
          example: '1234567'
        script_pubkey:
          type: string
          description: Script pubkey at which the input resides.
          example: 5120a72a43b1b79d75d69ae9652184b2b83ec84b3b43a7082ff59baaad5722597596
        txid:
          type: string
          description: Transaction hash of the UTxO.
          example: 2ca28d42583fc5bace84fe024d3697969e06dd1cf769a2141286825b81773fd5
        vout:
          type: integer
          format: int32
          description: Output index of the UTxO.
          example: 0
          minimum: 0
    Metaprotocol:
      type: string
      enum:
        - inscriptions
        - runes
        - brc20
    TxOutMetaprotocols:
      type: object
      required:
        - script_pubkey
        - satoshis
        - inscriptions
        - runes
      properties:
        address:
          type: string
          description: >-
            Address-encoding of the script pubkey at which the output containing
            the inscription resides.
          example: bc1ppth27qnr74qhusy9pmcyeaelgvsfky6qzquv9nf56gqmte59vfhqwkqguh
          nullable: true
        inscriptions:
          type: array
          items:
            $ref: '#/components/schemas/InscriptionAndOffset'
          description: List of inscription IDs and their offsets in this input.
        runes:
          type: array
          items:
            $ref: '#/components/schemas/RuneAndAmount'
          description: List of rune IDs and their amount in this input.
        satoshis:
          type: string
          description: Total number of satoshis in the UTxO.
          example: '1234567'
        script_pubkey:
          type: string
          description: >-
            Script pubkey at which the output containing the inscription
            resides.
          example: 51200aeeaf0263f5417e40850ef04cf73f43209b13401038c2cd34d201b5e685626e
        spending_tx:
          type: string
          description: >-
            If this output is known to have been spent, hash of the transaction
            that spent it.
          example: 2ca28d42583fc5bace84fe024d3697969e06dd1cf769a2141286825b81773fd5
          nullable: true
    InscriptionAndOffset:
      type: object
      required:
        - offset
        - inscription_id
      properties:
        inscription_id:
          type: string
        offset:
          type: integer
          format: int64
          minimum: 0
    RuneAndAmount:
      type: object
      required:
        - rune_id
        - amount
      properties:
        amount:
          type: string
        rune_id:
          type: string
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: api-key
      description: Project API Key

````