Build a Liquid token transfer

Build an unsigned Liquid issued-asset transfer on liquid or liquid-testnet, as a base64 PSET. io.vault spends from the vault wallet that holds the asset. For AMP2 assets that is the AMP2 2-of-2 wallet: AMP2 co-signs, and details lists the signing legs, one io.sign request each. The fee is paid in L-BTC (tL-BTC on testnet) from the same wallet. Use amount: "MAX" to send the whole balance; for L-BTC, io.vault keeps enough back for the fee. If the asset is held in both wallets, "MAX" returns 409 SPLIT_HOLDINGS, and so does a fixed amount that neither wallet covers alone; consolidate the balance first. To sign it, create a transaction request: send serialized as serializedTransaction and contextType unchanged.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Vault ID. You create vaults with io.sign (POST /v2/vaults). A malformed ID returns 400; an unknown ID returns 404.

string
enum
required
Allowed:
Body Params
string
required

Amount to send, as a positive raw integer string in the asset's smallest unit, for example 100000000 for 1 L-BTC. "MAX" sends the whole balance on a token transfer. The native L-BTC build does not accept "MAX" and returns 422 MAX_UNSUPPORTED.

string
required
length between 1 and 200

Recipient Liquid address. Use a confidential address (lq1…, tlq1…) to keep the amount and asset private, or a standard one (ex1…, tex1…).

string
required
^[0-9a-f]{64}$
Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json