Request a Withdrawal — POST /withdrawals

Withdraws part of your available balance to an external wallet. Blockra validates the address and your balance, deducts the payout fee and the on-chain network fee, then signs and broadcasts the transaction. Requires the withdrawals:write scope.

A withdrawals:write key can move funds. Treat it as a spending credential — keep it server-side and scope your keys tightly.

Request

POST https://api.blockra.io/withdrawals

Body parameters

asset

string

required

The coin to withdraw. One of BTC, LTC, ETH, USDC, or USDT.

amount

string

required

The amount to withdraw, as a decimal string in the coin (e.g. "0.05"). The payout fee and network fee are deducted from this; the recipient receives the net.

destination_address

string

required

The external wallet address to send to. Must be valid for the coin’s network.

Preview the fees first with POST /withdrawals/quote (same body, needs withdrawals:read). It returns amount, payout_fee, network_fee, and net without moving any funds.

Response

string

The withdrawal ID, prefixed wd_.

status

string

requested, broadcast, completed, or failed.

asset

string

The coin.

network

string

The chain: bitcoin, litecoin, or ethereum.

amount_atoms

string

The gross amount debited from your balance, in the coin’s smallest unit.

fee_atoms

string

The Blockra payout fee, in the coin’s smallest unit.

net_atoms

string

The amount actually sent on-chain (amount − payout fee − network fee).

destination_address

string

Where the funds were sent.

tx_hash

string

The broadcast transaction hash, once available.

created_at

string

ISO-8601 creation time.

curl https://api.blockra.io/withdrawals \
  -X POST \
  -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "asset": "LTC",
    "amount": "0.5",
    "destination_address": "ltc1q0u0dnysyzuyua7tg2fu05ztgssazx0j5fqfhun"
  }'

{
  "data": {
    "id": "wd_1a2b3c4d5e6f7g8h",
    "status": "broadcast",
    "asset": "LTC",
    "network": "litecoin",
    "amount_atoms": "50000000",
    "fee_atoms": "250000",
    "net_atoms": "49740000",
    "destination_address": "ltc1q0u0dnysyzuyua7tg2fu05ztgssazx0j5fqfhun",
    "tx_hash": "9f2c8a1b...",
    "created_at": "2026-07-09T02:12:00.000Z"
  },
  "error": null
}

​Request

​Body parameters

​Response

Request

Body parameters

Response