Skip to main content
POST
Send crypto from customer wallet

Authorizations

X-API-Key
string
header
required

Business API key for server-to-server integrations. Key prefix determines the environment — no separate flag needed: test_sk_* = sandbox/testnet, live_sk_* = production/mainnet.

Headers

Idempotency-Key
string
required

Required, 16-128 characters. Reuse the same value to retry a transfer safely: a replay returns the original transfer instead of sending a second one. Read the outcome back with GET /api/v1/wallet/{customerID}/transfers/{key}. A request without this header is rejected with 400.

Required string length: 16 - 128
Example:

"8f14e45f-ea6d-4f3a-9c21-7b0e5d3a1c92"

Path Parameters

customerID
string
required

Body

application/json
fee_quote_hash
string

Optional. The fee_quote_hash from POST /api/v1/wallet/{customerID}/transfer-quote. If your fee configuration changed since that quote, the transfer is refused with 409 and code: "quote_changed" instead of sending at a fee your customer never saw.

Response

Transfer submitted to the network

amount
string

Amount ACTUALLY delivered to the recipient, in base units — after every deduction. This is gross minus your merchant WaaS fee, and minus the TRON sponsorship fee on sponsored TRON USDT transfers. Always read this rather than echoing the amount you requested.

currency
string
Example:

"USDT"

fee_amount
string

Fee collected in base units (omitted if no fee configured)

Example:

"1000000"

fee_tx_hash
string

Hash of the fee collection transaction (omitted if no fee). Empty string for UTXO chains (BTC/LTC/BCH) where the fee is part of the main transaction.

from_address
string

Sender address (derived customer wallet address)

gas_fee
string

Network gas fee paid in base units (native token)

network
string
Example:

"ETH"

status
string
Example:

"pending"

timestamp
string<date-time>
to_address
string

Recipient address

tx_hash
string

Main transaction hash

Example:

"0xabc123..."