💰 List BTC addresses managed by node wallet

Code samples

GET /api/v1/btc/account

curl 'https://settla.net/api/v1/btc/account' \
  -H 'X-API-Key: $SETTLA_API_KEY' \
  -H 'Accept: application/json'

Returns the addresses in the node's own wallet and what they have received, via listreceivedbyaddress. This is not a way to list your addresses. The production node runs without a wallet: it holds no keys and has no addresses of its own, so this endpoint answers 200 with an empty array [] on the live API and will keep doing so. It is documented for completeness and for self-hosted deployments that do load a wallet. To track addresses you control, register an extended public key under Watch-only addresses and derive them there.

🛠️ Parameters

Example responses

200 Response — Real response from the production node (no wallet loaded)

[]

200 Response — Shape returned by a node that does have a wallet

[
  {
    "address": "bc1qay6jxstdwyma44ak8qfu52njqy9ujnfm37hllg",
    "amount": 0.012,
    "confirmations": 136,
    "label": "",
    "txids": [
      "5fc111d07140a808ba08ac28f61fd436efbfe9d84f5437abe980b42c8d9f0a5e"
    ]
  }
]

400 Response

{
  "error": "Parameter \"minconf\" must be a non-negative integer"
}

500 Response

{
  "error": "Could not connect to BTC node."
}

🔁 Responses

🔄 Response Schema

Status Code 400

Status Code 500