v1

latestOpenAPI 3.1.02026-07-26165182724.7 KB

Initiate Onchain Withdrawal

Send funds on chain to a whitelisted destination on the blockchain. The amount being withdrawn + total fees (including your fees + network fees) must be >= the users' account balance.

post/wallets/send/initiate/onchain

Headers

api-keystring required

api-key is available on the dashboard

Authorizationstring required

Request body

userIdstring required

The Id of the user who is sending this transaction

sourceAccountIdstring required

The Id of the account to debit

whitelistedAddressIdstring required

The Id of the whitelisted destination

amountstring required

The amount denominated in the smallest divisible unit of the sending currency. For example: cents or satoshis

fixedFeestring

Optional fixedFee in Euro cents to override the default application fee configuration. This amount can only be <= the default configured amount for this transaction type.

percentFeeBpsstring

Optional percentage fee in bps to override the default application fee configuration. This amount can only be <= the default configured amount for this transaction type.

verificationMethod'sms' | 'passkey' | 'totp'

SCA factor — one of sms (default), totp, or passkey. For USDC withdrawals, totp requires the destination address to be a Trusted Beneficiary; non-regulated crypto (BTC/ETH/BNB/SOL/POL) accepts any factor.

Response

200

challengeIdstring

dateExpiresstring

Example response

{
  "challengeId": "e49febf6-7b05-44cb-a8c8-0a64ec2575a8",
  "dateExpires": "2023-08-20T08:05:38.905Z",
  "transaction": {
    "syncedOwnerId": "b6c77114-0e07-48ec-96a8-6c7f52d07415",
    "sourceAccountId": "d3ec681f6f84f404554c44bba797315b",
    "parentWalletId": "1a6cd565-590f-4187-8d53-2f65774f9f40",
    "currency": "USDC",
    "amount": "1000",
    "status": "PENDING_2FA_CONFIRMATION",
    "txType": "ON_CHAIN_WITHDRAWAL_INITIATED",
    "blockchainDestinationAddress": "0x712073F86D2ad7EEd23a3F7683aa6145042B81Cf",
    "blockchainNetwork": {
      "name": "USD Coin Test (Goerli)",
      "type": "ERC20",
      "contractAddress": "0x07865c6E87B9F70255377e024ace6630C1Eaa37F"
    },
    "transactionCurrency": "USDC"
  },
  "feeEstimate": {
    "totalFee": "398",
    "networkFee": "1662779116152000",
    "ourFee": "279",
    "theirFee": "119",
    "feeCurrency": "USDT",
    "gasLimit": "84000",
    "gasPrice": "15.014",
    "fixedFeeDetails": {
      "amount": "104",
      "exchangeRate": "0.96",
      "appliedFeeCents": "100"
    },
    "percentageFeeDetails": {
      "amount": "15",
      "appliedFeeBps": "100"
    }
  }
}