Build an EVM token transfer

Build an unsigned ERC-20 transfer. Omitted fee fields are estimated. Set simulate to check for a revert before you sign. 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
required

Chain alias, such as ethereum, avalanche-c, solana, tron, bitcoin or ripple, not a numeric chain ID. GET /v2/treasury/chains lists the canonical aliases of the chains you can use, and includes testnets with includeTestnets=true. Older aliases such as btc are also accepted. Must be a chain in the evm ecosystem.

Body Params
string
required

Amount to send, as a positive human-readable decimal string: 1.5 means 1.5 ETH or BTC, not wei or satoshis. Tokens use their own decimals. "MAX" sends the whole balance: for a native transfer, the balance minus network fees; for a token transfer, the whole token balance, with fees paid separately in the native currency. "MAX" cannot be combined with skipFeeValidation.

string
required
length ≥ 1

On-chain address in the format of the chain the request names, in the path or the body: EVM 0x hex, Solana base58, Tron T… base58, Bitcoin bc1… or legacy (testnets tb1…), XRP r….

^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.

Gas price in gwei, as a decimal string, for type: "legacy". Estimated when omitted.

^\d+$

Gas limit, as an integer string. Estimated when omitted.

0 to 9007199254740991

Nonce to use. Defaults to the next nonce of the sending address.

enum

Fee model: legacy uses gasPrice; eip1559 uses maxFeePerGas and maxPriorityFeePerGas.

EIP-1559 maximum fee per gas in gwei, as a decimal string.

EIP-1559 maximum priority fee (tip) per gas in gwei, as a decimal string.

boolean

When true, builds the transaction even if the sender cannot pay the fee. Cannot be combined with amount: "MAX". To also skip the amount check, set skipBalanceValidation.

boolean

When true, builds the transaction even if the sender's balance cannot cover the amount. A native "MAX" send still needs a balance above the fee (plus the base reserve on XRP), or it returns 422.

string
required
length ≥ 1
\S

Token or contract address, for example an ERC-20 or TRC-20 contract or an SPL mint, in the format of the chain in the path. Surrounding whitespace is trimmed, a 0X prefix is accepted, and a blank value is rejected.

boolean
Defaults to false

When true, simulates the transfer from the vault address and returns 422 TRANSFER_WOULD_REVERT if it would revert for any reason, such as an insufficient balance, a paused contract or a blocklisted party.

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