[v1] Get Bitcoin UTXOs

We recommend switching to [v2] UTXOs for real-time mempool support

get

Retrieve confirmed UTXOs ignoring mempool completely. This can be useful for applications that need to rely on confirmed UTXOs only, eg constructing RBF txs as well. To query mempool aware endpoint use /v2/bitcoin/address/:address/utxo. Iterate using offset if hasMore is true.

Authorizations

apiKey

Path parameters

addressstring · BitcoinAddress · min: 10RequiredDefault: bc1q0egjvlcfq77cxd9kvpgppyuxckzvws46e3sxch

Query parameters

offsetnumberOptionalDefault: 0

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

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

/v1/bitcoin/address/{address}/utxo

HTTPcURLJavaScriptPython

GET /v1/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
      }
    }
  ]
}