Get Unspent Transaction Outputs By Account

POST

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

Path Parameters

chainstringrequired

Parameter specifying the target chain to query.

networkstringrequired

Parameter specifying the network of the target chain.

Request BodyBitcoin

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.

voutIndexintegerrequired

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

addressstringrequired

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

valuestringrequired

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

blockHeightintegerrequired

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

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.

blockTimestampintegerrequired

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

codestringrequired

Code identifying the cause of the failed request.

messagestringrequired

Detailed message including the name and value of the invalid parameter.

{
  "code": "MISSING_REQUIRED_PARAMETER",
  "message": "Missing required parameter: { PARAMETER_NAME }"
}

X-API-KEY

cURL

curl -X POST 'https://web3.nodit.io/v1/bitcoin/mainnet/blockchain/getUnspentTransactionOutputsByAccount' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo' \
  -d '{
    "accountAddress": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq"
  }'