[v2] Get Bitcoin UTXOs (Mempool-Aware)

get

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.

Authorizations

apiKey

x-api-keystringRequired

Path parameters

addressstring · BitcoinAddress · min: 10RequiredDefault: bc1q0egjvlcfq77cxd9kvpgppyuxckzvws46e3sxch

Query parameters

offsetnumberOptionalDefault: 0

limitnumber · min: 25 · max: 5000OptionalDefault: 60

excludeNonVoidProtocolInscriptionUtxosbooleanOptionalDefault: false

excludeAllInscriptionUtxosbooleanOptionalDefault: false

Responses

200

Paginated Utxo list

application/json

400

Invalid input

application/json

401

Unauthorized

application/json

404

Not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/v2/bitcoin/address/{address}/utxo

HTTPcURLJavaScriptPython

GET /v2/bitcoin/address/{address}/utxo HTTP/1.1
Host: api.secretkeylabs.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "hasMore": true,
  "items": [
    {
      "txid": "text",
      "vout": 1,
      "value": 1,
      "status": {
        "confirmed": true,
        "blockHeight": 1,
        "blockHash": "text",
        "blockTime": 1
      }
    }
  ]
}