Search UTXOs with given address/token/amount

GET 
/utxo_search

For a given token-uid, address and target-amount, get a list of UTXOs that are candidates to be inputs for a total of target-value. The resulsts will try to include the first UTXO with value higher or equal value as target-amount. No more than 256 entries will ever be returned by this API.

Request

Query Parameters

token_uid stringrequired

The UID of the token formatted as a HEX string, use "00" for HTR

target_amount intrequired

The target amount that the UTXOs should sum-up to, 1 means 0.01 HTR

address strrequired

The address that all UTXOs have

target_timestamp int

What timestamp to consider for timelocked outputs, by default uses the timestamp from the current best block

target_height int

What timestamp to consider for reward outputs (which are heightlocked), by default uses the height from the current best block

Responses

200

Success

application/json

Schema

Schema

any

success

Success UTXO search

{
  "success": true,
  "utxos": [
    {
      "txid": "339f47da87435842b0b1b528ecd9eac2495ce983b3e9c923a37e1befbe12c792",
      "index": 0,
      "amount": 1000000000,
      "timelock": null,
      "heightlock": 10
    }
  ]
}

error

Invalid parameter

{
  "success": false,
  "message": "Failed to parse 'address': foobar"
}

Loading...