Skip to main content
POST
Refresh VTXOs in delegated mode

Authorizations

Authorization
string
header
required

Base64url-encoded auth token

Body

application/json
vtxos
string[]
required

List of VTXO IDs to refresh. The sum of the VTXOs being refreshed must be

= P2TR_DUST [blocked]. Keep in mind that fees set out in RefreshFees [blocked] will be deducted from the newly created VTXO, this value must also be >= P2TR_DUST [blocked].

height
integer<int32> | null

Optional block height to schedule the refresh at. When set, the refresh fee is priced at that height and the server includes the participation in the first round once the chain tip reaches it; when omitted, the participation is eligible for the next round.

Required range: x >= 0

Response

Returns the refresh result

funding_txid
string | null
required

The round transaction id, if already assigned

id
integer<int32>
required

Unique identifier for the round

Required range: x >= 0
participation
object
required

the round participation details

status
object
required

the current status of the round

unlock_hash
string | null
required
funding_tx_hex
string | null