POST

Make unspent reservation

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

Path Params

walletId string required

The wallet ID.

matches ^[0-9a-f]{32}$

Body Params

object

unspentIds array of strings required

at least 1 items
expireTime string required

Time when reservation expires. Use date-time format or 'never'. If 'never', reservation doesn't expire.
type string enum

Type of reservation to make on the unspent.

ordinalinscription
inscriptionIds array of strings

Responses

200

Response Body

object

unspents array of objects
unspents object
- id string required
  
  The id of the unspent in the form :<tx_index>
- walletId string required
  
  matches ^[0-9a-f]{32}$
- expireTime string date-time required
- userId string required
  
  matches ^[0-9a-f]{32}$

400

Bad Request

Response Body

object

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

curl --request POST \ --url 'https://app.bitgo-test.com/api/v2/wallet/walletId/reservedunspents' \ --header 'accept: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'content-type: application/json' \ --data '{,"unspentIds":["003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2"],"expireTime":"string","type":"ordinal","inscriptionIds":["003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8i2"]}'

require 'uri' require 'net/http' url = URI("https://app.bitgo-test.com/api/v2/wallet/walletId/reservedunspents") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["accept"] = 'application/json' request["Authorization"] = 'Bearer YOUR_ACCESS_TOKEN' request["content-type"] = 'application/json' request.body = '{,"unspentIds":["003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2"],"expireTime":"string","type":"ordinal","inscriptionIds":["003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8i2"]}' response = http.request(request) puts response.read_body

<?php require_once('vendor/autoload.php'); $client = new \GuzzleHttp\Client(); $response = $client->request('POST', 'https://app.bitgo-test.com/api/v2/wallet/walletId/reservedunspents', [ 'headers' => [ 'accept' => 'application/json', 'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', 'content-type' => 'application/json', ], 'body' => '{,"unspentIds":["003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2"],"expireTime":"string","type":"ordinal","inscriptionIds":["003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8i2"]}', ]); echo $response->getBody();

import requests url = "https://app.bitgo-test.com/api/v2/wallet/walletId/reservedunspents" payload = {,"unspentIds":["003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2"],"expireTime":"string","type":"ordinal","inscriptionIds":["003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8i2"]} headers = { "accept": "application/json", "Authorization": "Bearer YOUR_ACCESS_TOKEN", "content-type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.text)

{ "unspents": [ { "id": "003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2", "walletId": "59cd72485007a239fb00282ed480da1f", "expireTime": "string", "userId": "59cd72485007a239fb00282ed480da1f" } ] }