Skip to content
Documentation

Withdraw synthetic USD

POST
/v2/user/withdraw/susd

Creates a new quote for a withdrawal from the synthetic USD balance, specifying what amount you want to withdraw from this balance. For example, to withdraw the equivalent of 1337 sats from your synthetic USD balance, amount is 1337 and currency is btc. The withdrawal can then be executed by calling the /user/withdraw endpoint with an invoice corresponding to the requested amount in sats (in our example: 1337) AND the quote_id. Once the withdrawal is settled, any remains from the fee reserve will be returned to the synthetic USD balance.

Request Body

Body

object
amount
required
number
> 0
currency
required
string
Allowed values: btc usd 
{
  "amount": 1337,
  "currency": "btc"
}

Responses

200

200

object
currency
required
string
Allowed values: btc usd
amount
required
number
> 0
fee_reserve
required
number
> 0
min_balance_after
required
number
> 0
valid_until
required
number
> 0
quote_id
required
string format: uuid 
{
  "currency": "usd",
  "amount": 1.23,
  "fee_reserve": 0.05,
  "min_balance_after": 98.72,
  "valid_until": 1707381751702,
  "quote_id": "f8cc0da3-127b-4583-9b56-e2cc074db218"
}

400

400