List unspent reservation

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

Query reserved unspents in the wallet.

Path Parameters

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

Query Parameters

  • prevIdstring
    Return the next batch of results, based on the "nextBatchPrevId" value from the previous batch.
  • limitintegerDefault: 25
    Maximum number of results to return. If the result set is truncated, use the "nextBatchPrevId" value to get the next batch.
  • expireTimeGtstring<date-time>
    Returns reserved unspents with an "expireTime" greater than this value.
  • expireTimeLtestring<date-time>
    Returns reserved unspents with an "expireTime" less than or equal to this value.
  • expireTimestring
    Returns reserved unspents with an "expireTime" equal to this value. If "never", returns unspents without expiration dates.
  • typestring
    Returns reserved unspents of a specific type.
    Enum: ordinal inscription

200 Response

unspents array[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
nextBatchPrevId string

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