Sign in
latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-08-202722135.7 KB

842376cab855

Withdraw

Withdraw stablecoin

Withdraw USDT from your Mavapay stablecoin wallet to an external address. The amount is specified in USDT cents (2 decimal places). For example, 100 = 1 USDT.

post/withdraw/stablecoin

Request body

amountstring required

The amount to withdraw in USDT cents (2 decimal places). For example, 100 = 1 USDT, 500 = 5 USDT.

network'trc20' | 'erc20' | 'plasma' | 'solana' | 'polygon' required

The blockchain network to withdraw on. Use lowercase values in the request.

currency'USDT' required

The stablecoin to withdraw. Currently only USDT is supported.

addressstring required

The destination wallet address on the selected network. Must be a valid address for that chain (e.g. a Tron address for trc20, an Ethereum address for erc20).

customerReferencestring

Optional identifier you supply to correlate this withdrawal in webhooks (stablecoinTransactionMetadata.customerReference).

Example request

{
  "amount": "500000",
  "network": "trc20",
  "currency": "USDT",
  "address": "TLt6fwdcdD18S36L9oiikn4Z8hebgwbzwS",
  "customerReference": "customer-provided-reference"
}

Response

Withdraw response

statusstring

Example response

{
  "status": "ok",
  "data": {
    "id": "d1614a76-9c7f-4111-98a7-43199f307e5b",
    "walletId": "d1614a76-9c7f-4111-98a7-43199f307e5b",
    "ref": "99eeff854ffd345fffs67890",
    "hash": "189727ef2e0f35921af7858b96e27cbad960b0ec2bb2a4ab73b6a231f9ce8727",
    "amount": 1000,
    "autopayout": true,
    "createdAt": "2021-07-01T12:00:00Z",
    "updatedAt": "2021-07-01T12:00:00Z",
    "metadata": {
      "id": "d1614a76-9c7f-4111-98a7-43199f307e5b",
      "orderId": "99854-2345",
      "bankCode": "090267",
      "bankAccountName": "Satoshi Nakamoto",
      "bankAccountNumber": "0123456789",
      "createdAt": "2021-07-01T12:00:00Z",
      "updatedAt": "2021-07-01T12:00:00Z"
    }
  }
}