Make unspent reservation

post/api/v2/wallet/{walletId}/reservedunspents

Mark the unspents as reserved and cannot be used in transactions until the given expire time.

Path Parameters

  • walletIdstringRequired
    Example: "59cd72485007a239fb00282ed480da1f"
    Pattern: ^[0-9a-f]{32}$

Request Body

unspentIds array[string] required
The id of the unspent in the form <txid>:<tx_index>
Min items: >= 1 items
Example: 003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2
expireTime string required
Time when reservation expires. Use "date-time" format or 'never'. If 'never', reservation doesn't expire.
type string
Type of reservation to make on the unspent.
Allowed values: ordinal inscription
inscriptionIds array[string]
The ID of the inscription in the form <txid>i<vin>
Example: 003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8i2

200 Response

unspents array[object]
a ReservedUnspent object
id string required
The id of the unspent in the form <txid>:<tx_index>
Example: 003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2
walletId string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
expireTime string <date-time>required
userId string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
type string
the type of the unspent
Example: undefined, ordinal, inscription
inscriptionIds array[string]
the array of inscription ids inscribed to the unspent

400 Response

error string required
Human-readable error message
requestId string required
Client request id
context object
Properties that apply to a specific error name
name string required
Error code