POSTGet Unspent Transaction Outputs By Account

Data APIhttps://web3.nodit.io/v1/bitcoin/mainnet/blockchain/getUnspentTransactionOutputsByAccount

Retrieves the list of UTXOs (Unspent Transaction Outputs) for a specific account.

Path Parameters
chainstring (enum)required

Parameter to specify the target chain for the query.

networkstring (enum)required

Parameter to specify the network of the target chain. Supported networks may vary depending on the chain.

Request Body
accountAddressstringrequired

Parameter specifying the account address to query.

pageinteger

The page parameter specifies the data page to query. It accepts values up to 100; for pages exceeding 100, use the cursor pagination method.

The page and cursor parameters cannot be used together. If both page and cursor are empty, cursor pagination is used.

rppinteger

rpp stands for results per page and specifies the page size. You can specify a number greater than 0 and up to 100.

cursorstring

The cursor parameter supports pagination and data navigation between pages. Provide the cursor value from the previous page in the next request to load the next page of data.

The page and cursor parameters cannot be used together. If both page and cursor are empty, cursor pagination is used.

withCountboolean

Parameter specifying whether to include the count field in the response. The count field indicates the total number of requested data items. When set to true, the count field is included and response speed may be slower.

Responses
pageinteger

Field representing the page number specified in the page parameter. This field is only included in the response when a value greater than 0 is specified for the page parameter.

rppinteger

Field representing the number of results per page specified in the rpp parameter.

cursorstring

A field for cursor pagination. This value must be provided in the next request to load the next page of data.

countinteger

Field representing the total count of requested data. This field is only included in the response when true is set for the withCount parameter.

transactionIdstringrequired

Unique identifier of the transaction in which the UTXO was created. A unique hash value calculated from transaction data; uniquely identifies the transaction.

예: 6b1e04c59a1e42d30af4cdac20e1a9e4d22e947b

voutIndexintegerrequired

Output (Vout) index of the transaction in which the UTXO was created. Indicates which output in the transaction output array; starts at 0.

예: 1

addressstringrequired

Address that received the transaction output. The recipient owns the UTXO using this address; follows P2PKH, P2SH, Bech32, or Bech32m format.

예: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa

valuestringrequired

Value of the UTXO; represents the balance of the transaction output. Value is expressed in satoshis; 1 BTC = 100,000,000 satoshis.

예: 5000000000

blockHeightintegerrequired

Indicates the height of the block containing the UTXO. Integer value representing the order of this block in the blockchain.

예: 100000

blockHashstringrequired

Hash value of the block containing the UTXO. A unique 64-character hexadecimal value generated by the SHA-256 algorithm; uniquely identifies the block.

예: 0000000000000000000a8ed7f3e6c1c2d21cbb5f

blockTimestampintegerrequired

Indicates when the block containing the UTXO was created. Value in UNIX timestamp format (in seconds); represents when the block was created.

예: 1400000000

X-API-KEY
RequestCU150
cURL
curl -X POST "https://web3.nodit.io/v1/bitcoin/mainnet/blockchain/getUnspentTransactionOutputsByAccount" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "accountAddress": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
}'
Response
Example · 200
{
  "page": 0,
  "rpp": 0,
  "cursor": "string",
  "count": 0,
  "items": [
    {
      "transactionId": "6b1e04c59a1e42d30af4cdac20e1a9e4d22e947b",
      "voutIndex": 1,
      "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
      "value": 5000000000,
      "blockHeight": 100000,
      "blockHash": "0000000000000000000a8ed7f3e6c1c2d21cbb5f",
      "blockTimestamp": 1400000000
    }
  ]
}