Quick Start
Make Your First API Request

Query Dogecoin UTxOs

17min
get utxo details on dogecoin in this guide, you will learn to query dogecoin and extract utxo information by leveraging the utxos by address https //docs gomaestro org/dogecoin/utxos by address endpoint prerequisites before submitting an api request, ensure you have completed the following getting started docid 3wmdf cqc0f3qrklets3f getting started docid 3wmdf cqc0f3qrklets3f project name \<your project name> blockchain doge network mainnet steps to submit an api request the api allows applications to list all utxos located at a specific address or controlled by a particular script (script pubkey) in this example, we will use the doge mainnet as the selected network for our project 1\ select the network ensure your project is configured to use doge mainnet 2\ retrieve transaction output use the following endpoint to get a list of all utxos that reside at the specified doge 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 doge 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 d9xni5mwofyjvtzg4cq7ae5vsdja3zxqti count 3 order asc curl l x get \\ h "accept application/json" \\ h "api key \<api key value>" \\ 'https //xdg mainnet gomaestro api org/v0/addresses/d9xni5mwofyjvtzg4cq7ae5vsdja3zxqti/utxos?count=3\&order=asc' 6\ review the response the api will return a response like the following { "data" \[{ "txid" "9921cf6256c0794aabdbd830ecd2cc75526ad3728a0a31ec6eb1cea816162cd8", "vout" 0, "address" "d9xni5mwofyjvtzg4cq7ae5vsdja3zxqti", "script pubkey" "76a914302b2f9e99b0f1256ea229f1399ee2d38044dce488ac", "satoshis" "100000", "confirmations" 247204, "height" 5144691, "dunes" \[], "inscriptions" \[{ "offset" 0, "inscription id" "676bd73b326dc73de502fa78f7ac4994a8054d9df1311e34c5d81f9182b51015i0" }] }, { "txid" "9921cf6256c0794aabdbd830ecd2cc75526ad3728a0a31ec6eb1cea816162cd8", "vout" 1, "address" "d9xni5mwofyjvtzg4cq7ae5vsdja3zxqti", "script pubkey" "76a914302b2f9e99b0f1256ea229f1399ee2d38044dce488ac", "satoshis" "100000", "confirmations" 247204, "height" 5144691, "dunes" \[], "inscriptions" \[{ "offset" 0, "inscription id" "25025072dac60ec88cfe353d2d39448b33b702ce5799383493be797f00e97bf7i0" }] }, { "txid" "9921cf6256c0794aabdbd830ecd2cc75526ad3728a0a31ec6eb1cea816162cd8", "vout" 2, "address" "d9xni5mwofyjvtzg4cq7ae5vsdja3zxqti", "script pubkey" "76a914302b2f9e99b0f1256ea229f1399ee2d38044dce488ac", "satoshis" "100000", "confirmations" 247204, "height" 5144691, "dunes" \[], "inscriptions" \[{ "offset" 0, "inscription id" "e0a9abc190a19e3287874c4244d2f8b20dbe437922c6c9774606d4f71e7bb2d1i0" }] }], "last updated" { "block hash" "a8e23d570387e97591545f98fd1572d4f8787ab180c5c282b76de1949c06c780", "block height" 5391895 }, "next cursor" "aaaaaaboghng2cwwfqjosw7smqqkctnqunxm0uww2nursnnavmlpizlgaaaaag" } 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\ albtfznix7oe2xmfiobfk