Query Bitcoin UTxOs

get utxo details on bitcoin in this guide, you will learn to query bitcoin and extract utxo information by leveraging the utxos by address https //docs gomaestro org/bitcoin/utxos by address endpoint prerequisites before submitting an api request, ensure you have completed the following getting started docid\ uduqgvf2grn2tlw nkeks getting started docid\ uduqgvf2grn2tlw nkeks project name \<your project name> blockchain bitcoin network testnet steps to submit an api request the api allows applications to retrieve a list of all utxos that are located at a specific address or controlled by a particular script (script pubkey) in this example, we will use the bitcoin testnet as the selected network for our project 1\ select the network ensure your project is configured to use bitcoin testnet 2\ retrieve transaction output use the following endpoint to get a list of all utxos that reside at the specified bitcoin address or script pubkey /addresses/\ address/utxos 3\ specify path parameters include the required path parameters in your request parameter data type description required address string the bitcoin address or hex encoded script pubkey yes 4\ specify query parameters (optional) include optional query parameters as needed parameter data type description required filter dust boolean ignore utxos containing less than 100,000 sats no filter dust threshold integer ignore utxos containing less than the specified number of satoshis no count any maximum number of results per page no order any the order in which the results are sorted (by height at which utxo was produced) no from int64 return only utxos created on or after a specific height no to int64 return only utxos created on or before a specific height no cursor string pagination cursor string; use the cursor included in a page of results to fetch the next page no 5\ send the api request use curl or your preferred tool to send the api request for this example, we will use address bc1qh62wlr6cv349jg2ltpfe6dgrjt585gzhlmecdu filter dust true order desc qfkwfyfdd8wzixrxztcgzrqzyphma0hk curl x get \\ h "api key \<your project api key>" \\ h "accept application/json" \\ "https //xbt testnet gomaestro api org/v0/addresses/tb1qphcdyah2e4vtpxn56hsz3p6kapg90pl4x525kc/utxos?filter dust=true\&order=desc" 6\ review the response the api will return a response like the following { "data" \[{ "txid" "caff433f77a1458696280be82a9bdb7298260e5d85b81e7a77a762c47bbb89c2", "vout" 1, "address" "tb1qphcdyah2e4vtpxn56hsz3p6kapg90pl4x525kc", "script pubkey" "00140df0d276eacd58b09a74d5e0288756e8505787f5", "satoshis" "9813110", "confirmations" 186347, "height" 2815507, "runes" \[], "inscriptions" \[] }, { "txid" "9e46003cb9ae4906a81b4be663c0b3ea5acb8947857bbc20594e9d76144be6ff", "vout" 2, "address" "tb1qphcdyah2e4vtpxn56hsz3p6kapg90pl4x525kc", "script pubkey" "00140df0d276eacd58b09a74d5e0288756e8505787f5", "satoshis" "980362", "confirmations" 186373, "height" 2815481, "runes" \[], "inscriptions" \[] }], "last updated" { "block hash" "000000000538766058d37b6ca5e2cd6d313aed48f16da2633eceec75a417e4ea", "block height" 3001854 }, "next cursor" null } 7\ understanding the response term definition txid the transaction id where the utxo was created vout the index of the output in the transaction ( txid ) address the bitcoin address that received the utxo script pubkey the script public key associated with the utxo, usually in hex format satoshis the amount of satoshis (smallest unit of bitcoin) in the utxo confirmations the number of confirmations that the utxo has received on the blockchain height the block height at which the utxo was created runes additional data related to runes, if any (empty in this response) inscriptions additional data related to inscriptions, if any (empty in this response) last updated information about the last block update related to this request block hash the hash of the last block where the utxos were updated or retrieved block height the height of the last block where the utxos were updated or retrieved next cursor a cursor for pagination to fetch the next page of results, if applicable ( null if no further pages) next steps congrats! now that you've made your api request, let's submit your first transaction docid\ oinij9bhfepvfuvftrpwp