1. Crypto Withdrawals
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Balances & History
      • Get Balances
      • Get Balance History
    • Crypto Deposits
      • Get Crypto Deposit Details
      • Update Travel Rule
    • Crypto Withdrawals
      • Add Whitelisted Wallet
        POST
      • Get Whitelisted Wallets
        GET
      • Delete Whitelisted Wallet
        DELETE
      • Create Crypto Withdrawal
        POST
      • Get Crypto Withdrawal Details
        GET
    • SEPA Deposits
      • Get SEPA Payment Details
      • Get SEPA Deposit Details
    • SEPA Withdrawals
      • Create SEPA Withdrawal
      • Get SEPA Withdrawal Details
    • Currency Exchange
      • Get Rates
      • Create Lock
      • Create Exchange
      • Get Exchange Details
  • Integration
    • Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • Crypto Deposit Webhook
      • Crypto Withdrawal Webhook
      • SEPA Deposit Webhook
      • SEPA Withdrawal Webhook
      • Exchange Webhook
  • Reference
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Crypto Withdrawals

Create Crypto Withdrawal

Testing Env
http://k8s-partnera-partnera-7873f15634-69ebb7c047cac3d1.elb.eu-central-1.amazonaws.com
Testing Env
http://k8s-partnera-partnera-7873f15634-69ebb7c047cac3d1.elb.eu-central-1.amazonaws.com
POST
/v1/partner/crypto-withdrawal
Creates a crypto withdrawal to an address from the Partner's whitelist. The recipient is identified by walletId - currency, network, address and memo are taken from the whitelist entry. To add a recipient, use Add Whitelisted Wallet.

Amount and fee#

amount is the total amount debited from the balance, including the fee. The recipient receives amount - fee. The minimum amount and the fee are returned by Get Balances (withdrawal.minAmount, withdrawal.feeAmount).

Processing#

The request is validated immediately - if it is invalid, an error is returned and no withdrawal is created. An accepted withdrawal is created with status STARTED and processed asynchronously (verification, sending to the network). Track its status via Get Crypto Withdrawal Details, Get Balance History or webhooks.

Retries#

If the request times out or no response is received, do not retry it automatically - the withdrawal may have been created. Check Get Balance History or wait for the webhook first. Retrying without checking may result in a duplicate withdrawal.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Body Params application/json

Examples

Responses

🟢201Created
application/json
Withdrawal created.
Bodyapplication/json

🟠401Access Denied
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'http://k8s-partnera-partnera-7873f15634-69ebb7c047cac3d1.elb.eu-central-1.amazonaws.com/v1/partner/crypto-withdrawal' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "walletId": "a3f8d2c1-4b6e-4f9a-8c7d-1e2b3a4c5d6e",
    "amount": "20"
}'
Response Response Example
201 - DOGE
{
    "type": "WITHDRAWAL",
    "transactionId": "1af00eff-9f6c-4915-a82e-e79e48e0961b",
    "externalId": "6f14e003-e90a-4e5f-916f-19d0b6cfc305",
    "balanceId": "6f22378e-71e6-4389-b1d8-3e3d40828e28",
    "walletId": "a3f8d2c1-4b6e-4f9a-8c7d-1e2b3a4c5d6e",
    "status": "STARTED",
    "amount": "10",
    "currency": "DOGE",
    "network": "DOGE",
    "toAddress": "DNEusWUFMPG24pznn4yCT82xmEJXuLXJmB",
    "memo": null,
    "fee": "10",
    "totalAmount": "20",
    "transactionHash": null,
    "createdAt": "2026-10-05T14:02:11.204Z",
    "updatedAt": "2026-10-05T14:02:11.204Z"
}
Previous
Delete Whitelisted Wallet
Next
Get Crypto Withdrawal Details
Built with