On this page

  2. Komodo Defi Framework
  3. Api
  4. V20
  5. Wallet
  6. fetch_utxos

Fetch Utxos

API-v2fetch_utxos

fetch_utxos

Returns all unspent transaction outputs (UTXOs) for supported coins.

After a wallet has cultivated a long history, or received many small mining payouts, it may become slower to respond. Consolidating unspent transaction outputs should be routinely performed when mining to wallet in order to avoid this.

Request Parameters

Parameter* = requiredTypeDescription
coin*
string
The coin to fetch utxos for.

Response Parameters

Parameter* = requiredTypeDescription
result*
string
The outcome of the request.

📌 Examples

fetch_utxos

POST
fetch_utxos
{
  "method": "fetch_utxos",
  "mmrpc": "2.0",
  "params": {
    "coin": "MARTY"
  },
  "userpass": "RPC_UserP@SSW0RD"
}

Success

Response (Success)

SUCCESS
{
  "id": null,
  "mmrpc": "2.0",
  "result": {
    "addresses": [
      {
        "address": "RDux85r5XE7xuUs5DCTt7jTY1cJZT7SKAW",
        "count": 1,
        "utxos": [
          {
            "txid": "23cd0403085c962870cd373a09a6896d179309de51f028ef945da44bdece5aa9",
            "value": "7.60454375",
            "vout": 1
          }
        ]
      }
    ],
    "total_count": 1
  }
}

Error Types

Parameter* = requiredTypeDescription
InvalidRequest
string
Optional. The request is malformed or missing required parameters.
NoSuchCoin
string
Optional. The selected coin was not found or is not activated yet.

Error Response (Coin Not Found)

{
    "mmrpc": "2.0",
    "error": "NoSuchCoin",
    "error_path": "fetch_utxos.lp_coins",
    "error_trace": "fetch_utxos:72] lp_coins:5278]",
    "error_type": "NoSuchCoin",
    "id": null
}

Error Response (Missing parameter)

{
    "mmrpc": "2.0",
    "error": "Error parsing request: missing field `coin`",
    "error_path": "dispatcher",
    "error_trace": "dispatcher:143]",
    "error_type": "InvalidRequest",
    "error_data": "missing field `coin`",
    "id": null
}