---
title: "Initiate Onchain Withdrawal"
method: POST
path: "/wallets/send/initiate/onchain"
---

# Initiate Onchain Withdrawal

`POST /wallets/send/initiate/onchain`

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.

## Headers

- `api-key` string, required
- `Authorization` string, required

## Request body

- object
  - `userId` string, required — The Id of the user who is sending this transaction
  - `sourceAccountId` string, required — The Id of the account to debit
  - `whitelistedAddressId` string, required — The Id of the whitelisted destination
  - `amount` string, required — The amount denominated in the smallest divisible unit of the sending currency. For example: cents or satoshis
  - `fixedFee` string — 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.
  - `percentFeeBps` string — 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`

200

- object
  - `challengeId` string
  - `dateExpires` string
  - `transaction` object
    - `syncedOwnerId` string
    - `sourceAccountId` string
    - `parentWalletId` string
    - `currency` string
    - `amount` string
    - `status` string
    - `txType` string
    - `blockchainDestinationAddress` string
    - `blockchainNetwork` object
      - `name` string
      - `type` string
      - `contractAddress` string
    - `transactionCurrency` string
  - `feeEstimate` object
    - `totalFee` string
    - `networkFee` string
    - `ourFee` string
    - `theirFee` string
    - `feeCurrency` string
    - `gasLimit` string
    - `gasPrice` string
    - `fixedFeeDetails` object
      - `amount` string
      - `exchangeRate` string
      - `appliedFeeCents` string
    - `percentageFeeDetails` object
      - `amount` string
      - `appliedFeeBps` string

---

[API](https://skmtc.net/striga/apis/striga-v1.md) · [All operations](https://skmtc.net/striga/apis/striga-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/striga/striga-v1/versions/63e57aa7df45/schema)