> ## 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 UTXOs for multiple Cardano addresses in a single batch request for efficient wallet management.

# UTxOs by multiple addresses



## OpenAPI

````yaml cardano/blockchain-indexer-api/openapi.json post /addresses/utxos
openapi: 3.0.3
info:
  title: Cardano - Blockchain Indexer API
  description: Core indexer endpoints dedicated to Cardano.
  contact:
    name: Maestro Blockchain Inc.
    url: https://gomaestro.org/
    email: info@gomaestro.org
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.txt
  version: v1.8.0
servers:
  - url: https://mainnet.gomaestro-api.org/v1
    description: Cardano Mainnet
  - url: https://preprod.gomaestro-api.org/v1
    description: Cardano Preprod
  - url: https://preview.gomaestro-api.org/v1
    description: Cardano Preview
security:
  - api-key: []
tags:
  - name: Maestro
paths:
  /addresses/utxos:
    post:
      tags:
        - Addresses
      summary: UTxOs by multiple addresses
      description: >-
        Return detailed information on UTxOs which are controlled by some
        address in the specified list of addresses
      operationId: utxos_by_addresses
      parameters:
        - name: resolve_datums
          in: query
          description: Try find and include the corresponding datums for datum hashes
          required: false
          schema:
            type: boolean
            nullable: true
        - name: with_cbor
          in: query
          description: >-
            Include the CBOR encodings of the transaction outputs in the
            response
          required: false
          schema:
            type: boolean
            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: amounts-as-strings
          in: header
          description: Large numbers returned as strings if set to `true`
          required: false
          schema:
            type: string
            nullable: true
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: string
            example:
              - addr_test1wr2x24tlcpr37sjrscaqsh6z4tue3k7zx8qt8n0kscen2jct0wkz7
              - addr_test1wplyjq2gqaufjt6uux6g9ax9s7mcc50rm3f8zgsmquknggce4mde8
        required: true
      responses:
        '200':
          description: >-
            Get all unspent transaction outputs residing at any address in a
            list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedUtxoWithSlot'
              example:
                data:
                  - tx_hash: >-
                      21d0ff7e2b5d8988ff999f404668aff3f72f9e7a7de5eaa3740cb306f3024ca9
                    index: 0
                    slot: 20648797
                    assets:
                      - unit: lovelace
                        amount: 20000000
                    address: >-
                      addr_test1wr2x24tlcpr37sjrscaqsh6z4tue3k7zx8qt8n0kscen2jct0wkz7
                    datum: null
                    reference_script:
                      hash: d465557fc0471f4243863a085f42aaf998dbc231c0b3cdf68633354b
                      type: plutusv2
                      bytes: 5910630100003....10030021120011
                      json: null
                    txout_cbor: null
                  - tx_hash: >-
                      b2054dc932454372808972d92e46e6725d57438d9095cb77010a12aa843b5e01
                    index: 1
                    slot: 21610369
                    assets:
                      - unit: lovelace
                        amount: 2000000
                      - unit: >-
                          c00c2ee78495d1cc21010b354c56975ca3f0202e2ea9e16ebab0acfa4f7261636c6546656564
                        amount: 1
                    address: >-
                      addr_test1wr2x24tlcpr37sjrscaqsh6z4tue3k7zx8qt8n0kscen2jct0wkz7
                    datum:
                      type: inline
                      hash: >-
                        b908508e84bd37060d4515eb25a43396610a4d6ce363a89ff802f40a7f0a1729
                      bytes: >-
                        d8799fd87b9fa3001a000593e9011b00000186867c6928021b00000186868a24c8ffff
                      json:
                        fields:
                          - constructor: 2
                            fields:
                              - map:
                                  - k:
                                      int: 0
                                    v:
                                      int: 365545
                                  - k:
                                      int: 1
                                    v:
                                      int: 1677293545768
                                  - k:
                                      int: 2
                                    v:
                                      int: 1677294445768
                    reference_script: null
                    txout_cbor: null
                  - tx_hash: >-
                      45c205a85aa13b2bb8677675937deac2d19ac6fccf84905d845e1ca9df62bac3
                    index: 0
                    slot: 21610637
                    assets:
                      - unit: lovelace
                        amount: 3000000
                      - unit: >-
                          436941ead56c61dbf9b92b5f566f7d5b9cac08f8c957f28f0bd60d4b5041594d454e54544f4b454e
                        amount: 850860
                      - unit: >-
                          c00c2ee78495d1cc21010b354c56975ca3f0202e2ea9e16ebab0acfa4167675374617465
                        amount: 1
                    address: >-
                      addr_test1wr2x24tlcpr37sjrscaqsh6z4tue3k7zx8qt8n0kscen2jct0wkz7
                    datum:
                      type: inline
                      hash: >-
                        83115d854808011060dff35ab238823b693250e7a089386cfbd422ce55f50e76
                      bytes: d87b9fd8799fd879....6dffffffff
                      json:
                        constructor: 2
                        fields:
                          - constructor: 0
                            fields:
                              - constructor: 0
                                fields:
                                  - list:
                                      - bytes: >-
                                          007df380aef26e44739db3f4fe67d8137446e630dab3df16d9fbddc5
                                      - bytes: >-
                                          cef7fb5f89a9c76a65acdd746d9e84104d6f824d7dc44f427fcaa1dd
                                      - bytes: >-
                                          4ad1571e7df63d4d6c49240c8372eb639f57c0ef669338c0d752f29b
                                      - bytes: >-
                                          f6f69e5af37c2978cb2124c12202f2185fd5c14ee93bb832911daf8e
                                      - bytes: >-
                                          2d7103fdaf4beecbbef37edc6d24d311230f2836d0af791e3a6364d2
                                  - int: 7500
                                  - int: 900000
                                  - int: 900000
                                  - int: 200
                                  - constructor: 0
                                    fields:
                                      - int: 20
                                  - int: 20000
                                  - int: 1500
                                  - list:
                                      - bytes: 496e6469676f4f7261636c65446174756d
                    reference_script: null
                    txout_cbor: null
                last_updated:
                  timestamp: '2022-10-10 20:25:28'
                  block_hash: >-
                    2d6b15048692aca81cc6dbd9234360ed6163e838fcf9d9f1a9e8dc67e0779f82
                  block_slot: 32266164
                next_cursor: null
        '400':
          description: Malformed query parameters
        '500':
          description: Internal server error
components:
  schemas:
    PaginatedUtxoWithSlot:
      type: object
      description: >-
        A paginated response. Pass in the `next_cursor` in a subsequent request
        as the `cursor` query parameter to fetch the next page of results.
      required:
        - data
        - last_updated
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/UtxoWithSlot'
          description: Endpoint response data
        last_updated:
          $ref: '#/components/schemas/LastUpdated'
        next_cursor:
          type: string
          description: Pagination cursor
          nullable: true
    UtxoWithSlot:
      type: object
      description: Transaction output
      required:
        - tx_hash
        - index
        - slot
        - assets
        - address
      properties:
        address:
          type: string
          description: Address which controls the UTxO
        assets:
          type: array
          items:
            $ref: '#/components/schemas/Asset'
          description: List of assets contained in the UTxO
        datum:
          allOf:
            - $ref: '#/components/schemas/DatumOption'
          nullable: true
        index:
          type: integer
          description: UTxO transaction index
          minimum: 0
        reference_script:
          allOf:
            - $ref: '#/components/schemas/Script'
          nullable: true
        slot:
          type: integer
          format: int64
          description: Absolute slot of block which produced the UTxO
          minimum: 0
        tx_hash:
          type: string
          description: UTxO transaction hash
        txout_cbor:
          type: string
          description: Hex encoded transaction output CBOR bytes
          nullable: true
    LastUpdated:
      type: object
      description: >-
        Details of the most recent block processed by the indexer (aka chain
        tip); that is, the data returned is correct as of this block in time.
      required:
        - timestamp
        - block_hash
        - block_slot
      properties:
        block_hash:
          type: string
          description: >-
            Hex-encoded hash of the most recently processed block (aka chain
            tip)
        block_slot:
          type: integer
          format: int64
          description: Absolute slot of the most recently processed block (aka chain tip)
          minimum: 0
        timestamp:
          type: string
          description: UTC timestamp of when the most recently processed block was minted
    Asset:
      type: object
      description: Lovelace or native asset
      required:
        - unit
        - amount
      properties:
        amount:
          $ref: '#/components/schemas/NumOrString'
        unit:
          type: string
          description: >-
            Asset (either `lovelace` or concatenation of hex encoded policy ID
            and asset name for native asset)
    DatumOption:
      type: object
      description: Datum (inline or hash)
      required:
        - type
        - hash
      properties:
        bytes:
          type: string
          description: >-
            Hex encoded datum CBOR bytes (`null` if datum type is `hash` and
            corresponding datum bytes have not been seen on-chain)
          nullable: true
        hash:
          type: string
          description: Datum hash
        json:
          type: object
          description: >-
            JSON representation of the datum (`null` if datum type is `hash` and
            corresponding datum bytes have not been seen on-chain)
          nullable: true
        type:
          $ref: '#/components/schemas/DatumOptionType'
    Script:
      type: object
      description: Details of a Native or Plutus script
      required:
        - hash
        - type
        - bytes
      properties:
        bytes:
          type: string
          description: Script bytes
        hash:
          type: string
          description: Script hash
        json:
          type: object
          description: >-
            JSON representation of script (`null` if script not of `native`
            type)
          nullable: true
        type:
          $ref: '#/components/schemas/ScriptType'
    NumOrString:
      oneOf:
        - type: integer
          format: int64
          description: Unsigned 64-bit integer
          minimum: 0
        - type: integer
          description: Unsigned 128-bit integer
          minimum: 0
        - type: integer
          format: int64
          description: Signed 64-bit integer
        - type: number
          format: double
          description: 64-bit floating point number
        - type: string
          description: String representation of an integer or number
      description: >-
        Integer or number by default, or a string representation if the
        `amounts-as-strings` header is set to `true`
    DatumOptionType:
      type: string
      description: Datum type (inline datum or datum hash)
      enum:
        - hash
        - inline
    ScriptType:
      type: string
      description: Script type and version
      enum:
        - native
        - plutusv1
        - plutusv2
        - plutusv3
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: api-key
      description: Project API Key

````