Create a transaction request

Send a built transaction to io.sign for approval and signing. Send the build endpoint's serialized value as serializedTransaction, and its contextType unchanged. A Liquid PSET that spends the vault's AMP2 2-of-2 wallet opens one io.sign request per derivation path (signatureRequestIds). Once every one is approved, AMP2 co-signs and broadcasts the transaction, whatever you send as broadcast. For a tokenised asset, a paused asset (ASSET_PAUSED) or a recipient the token's allowlist or blocklist refuses (RECIPIENT_NOT_VERIFIED, RECIPIENT_BLOCKED) is a 400.

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

Ecosystem of chain.

Allowed:
string
required
length ≥ 1

Chain alias. It must belong to ecosystem.

Body Params
string
required
length ≥ 1

Unsigned transaction: the serialized value from a build endpoint. Its encoding is set by contextType.

string
enum
required

Media type of serializedTransaction, as returned by the build endpoint. It must match the path ecosystem and chain, or the request is a 400. For application/evm-rlp-v1+hex and application/ionetwork-eea-rlp-v1+hex, the chain ID in the transaction must also match the path chain.

Allowed:
string
required
length ≥ 1

Sending address. It must be the vault address for this chain and derivationPath, or a 400 is returned. For a Liquid AMP2 2-of-2 spend, use the registered multisig address. EVM addresses compare case-insensitively.

boolean
Defaults to true

When false, io.vault holds the signed transaction in waiting_to_broadcast for you to broadcast with POST /v2/treasury/vaults/{vaultId}/transactions/{transferId}/broadcast. Ignored for an AMP2 2-of-2 spend, which AMP2 co-signs and broadcasts once every approval is in.

^m(\/\d+)+$

BIP-44 style HD derivation path (m/<n>/<n>/..., unhardened only). When omitted, the vault base address is used. A hardened segment (', h or H suffix) returns 400.


BIP-44 style HD derivation path of the form m/<n>/<n>/..., with unhardened numeric segments only. A hardened segment (', h or H suffix) returns 400. Where the field is optional and omitted, the vault base address is used.

Free-text note stored with the request.

string
length between 1 and 64
^\S+$

Originator recorded on the io.sign request. Defaults to you. An API client can name any user or API client; a user can only name themself, or the request is a 403.

string
^[a-z][a-z0-9-]{0,63}$

Kebab-case tag saying what the request is for, for example token-transfer. Returned unchanged on reads.

When the request expires (ISO 8601). Must be in the future.

Transaction hash, if you already know it.

metadata
object
Headers
string
length between 1 and 255

Key that makes this call safe to retry. Repeating the key with the same body returns the original response without running the operation again. Reusing the key with a different body is refused. Keys are scoped to you and this operation, so the same key on another operation does not collide. Keys expire some time after the original call completes. An empty or whitespace-only value is rejected. Maximum length: 255 characters.

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