# \[v2] Get Bitcoin UTXOs (Mempool-Aware)
## GET /v2/bitcoin/address/{address}/utxo
> Mempool-aware: Retrieve UTXOs. This endpoint considers both confirmed and unconfirmed\
> utxos. When a confirmed UTXO is spent in the mempool, it will not be returned here as its no longer a utxo.\
> To query confirmed-only endpoint use \ /v1/bitcoin/address/:address/utxo\.\
> \
\
> Iterate using offset if hasMore is true.\
> \
\
\
> \UTXO filtering:\\
\
> \excludeNonVoidProtocolInscriptionUtxos\ - When true, excludes UTXOs that hold valuable\
> inscriptions, but can include void protocol inscriptions (e.g. BRC-20, TAP spent inscriptions).\
\
> \excludeAllInscriptionUtxos\ - When true, excludes all inscription-bearing UTXOs,\
> including both valuable inscriptions(non-void protocol inscriptions) and void protocol inscriptions.\
> Implies \excludeNonVoidProtocolInscriptionUtxos=true\.
```json
{"openapi":"3.0.3","info":{"title":"SecretKeyLabs API","version":"1.0.0"},"tags":[{"name":"Bitcoin"}],"servers":[{"url":"https://api.secretkeylabs.io"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"x-api-key","in":"header"}}},"paths":{"/v2/bitcoin/address/{address}/utxo":{"get":{"tags":["Bitcoin"],"description":"Mempool-aware: Retrieve UTXOs. This endpoint considers both confirmed and unconfirmed\n utxos. When a confirmed UTXO is spent in the mempool, it will not be returned here as its no longer a utxo.\n To query confirmed-only endpoint use /v1/bitcoin/address/:address/utxo.\n
\n Iterate using offset if hasMore is true.\n
\n UTXO filtering:
\n excludeNonVoidProtocolInscriptionUtxos - When true, excludes UTXOs that hold valuable\n inscriptions, but can include void protocol inscriptions (e.g. BRC-20, TAP spent inscriptions).
\n excludeAllInscriptionUtxos - When true, excludes all inscription-bearing UTXOs,\n including both valuable inscriptions(non-void protocol inscriptions) and void protocol inscriptions.\n Implies excludeNonVoidProtocolInscriptionUtxos=true.","parameters":[{"schema":{"default":0,"minimum":0,"type":"number"},"in":"query","name":"offset","required":false},{"schema":{"default":60,"minimum":25,"maximum":5000,"type":"number"},"in":"query","name":"limit","required":false},{"schema":{"default":false,"type":"boolean"},"in":"query","name":"excludeNonVoidProtocolInscriptionUtxos","required":false},{"schema":{"default":false,"type":"boolean"},"in":"query","name":"excludeAllInscriptionUtxos","required":false},{"schema":{"minLength":10,"default":"bc1q0egjvlcfq77cxd9kvpgppyuxckzvws46e3sxch","format":"BitcoinAddress","type":"string"},"in":"path","name":"address","required":true}],"responses":{"200":{"description":"Paginated Utxo list","content":{"application/json":{"schema":{"description":"Paginated Utxo list","type":"object","properties":{"hasMore":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"txid":{"type":"string"},"vout":{"type":"number"},"value":{"type":"number"},"status":{"type":"object","properties":{"confirmed":{"type":"boolean"},"blockHeight":{"type":"number"},"blockHash":{"type":"string"},"blockTime":{"type":"number"}},"required":["confirmed"]}},"required":["txid","vout","value","status"]}}},"required":["hasMore","items"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"description":"Invalid input","type":"string"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"description":"Unauthorized","type":"string"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"description":"Not found","type":"string"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"description":"Rate limit exceeded","type":"string"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"description":"Internal server error","type":"string"}}}}}}}}}
```