v1

latestOpenAPI 3.0.2CC0 1.0 Universal2026-07-17128129208.3 KB

scan

List boxes which are not spent.

get/scan/unspentBoxes/{scanId}

Path parameters

scanIdinteger required

identifier of a scan

Response

List of unspent boxes

confirmationsNuminteger nullable required

Number of confirmations, if the box is included into the blockchain

addressstring required

Encoded Ergo Address

creationTransactionstring base16 required

Base16-encoded 32 byte modifier id

spendingTransactionstring base16 required

Base16-encoded 32 byte modifier id

spendingHeightinteger nullable required

The height the box was spent at

inclusionHeightinteger required

The height the transaction containing the box was included in a block at

onchainboolean required

A flag signalling whether the box is created on main chain

spentboolean required

A flag signalling whether the box was spent

creationOutIndexinteger required

An index of a box in the creating transaction

scansinteger[] required

Scan identifiers the box relates to

Example response

[
  {
    "box": {
      "boxId": "1ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
      "value": 147,
      "ergoTree": "0008cd0336100ef59ced80ba5f89c4178ebd57b6c1dd0f3d135ee1db9f62fc634d637041",
      "creationHeight": 9149,
      "assets": [
        {
          "tokenId": "4ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
          "amount": 1000
        }
      ],
      "additionalRegisters": {
        "R4": "100204a00b08cd0336100ef59ced80ba5f89c4178ebd57b6c1dd0f3d135ee1db9f62fc634d637041ea02d192a39a8cc7a70173007301"
      },
      "transactionId": "2ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117"
    },
    "confirmationsNum": 147,
    "address": "3WwbzW6u8hKWBcL1W7kNVMr25s2UHfSBnYtwSHvrRQt7DdPuoXrt",
    "creationTransaction": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "spendingTransaction": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "spendingHeight": 147,
    "inclusionHeight": 147,
    "onchain": true,
    "creationOutIndex": 2,
    "scans": [
      1
    ]
  }
]