Withdraw crypto instantly with conversion

Withdraw BTC with conversion from EUR

curl --request POST \
  --url https://app.cryptoprocessing.com/api/v2/crypto/withdrawal_instant_exchange \
  --header 'Content-Type: application/json' \
  --header 'X-Processing-Key: <api-key>' \
  --header 'X-Processing-Signature: <x-processing-signature>' \
  --data '
{
  "sender_currency": "EUR",
  "received_currency": "BTC",
  "sender_amount": "100",
  "address": "tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc",
  "foreign_id": "withdrawal_123",
  "end_user_reference": "user_12345",
  "sender_type": "legal",
  "sender_data": {
    "legal_name": "Example GmbH",
    "country_of_registration": "DEU"
  },
  "receiver_type": "natural",
  "receiver_data": {
    "first_name": "Friedrich",
    "last_name": "Müller",
    "date_of_birth": "1995-08-17"
  }
}
'

import requests

url = "https://app.cryptoprocessing.com/api/v2/crypto/withdrawal_instant_exchange"

payload = {
    "sender_currency": "EUR",
    "received_currency": "BTC",
    "sender_amount": "100",
    "address": "tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc",
    "foreign_id": "withdrawal_123",
    "end_user_reference": "user_12345",
    "sender_type": "legal",
    "sender_data": {
        "legal_name": "Example GmbH",
        "country_of_registration": "DEU"
    },
    "receiver_type": "natural",
    "receiver_data": {
        "first_name": "Friedrich",
        "last_name": "Müller",
        "date_of_birth": "1995-08-17"
    }
}
headers = {
    "X-Processing-Signature": "<x-processing-signature>",
    "X-Processing-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Processing-Signature': '<x-processing-signature>',
    'X-Processing-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    sender_currency: 'EUR',
    received_currency: 'BTC',
    sender_amount: '100',
    address: 'tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc',
    foreign_id: 'withdrawal_123',
    end_user_reference: 'user_12345',
    sender_type: 'legal',
    sender_data: {legal_name: 'Example GmbH', country_of_registration: 'DEU'},
    receiver_type: 'natural',
    receiver_data: {first_name: 'Friedrich', last_name: 'Müller', date_of_birth: '1995-08-17'}
  })
};

fetch('https://app.cryptoprocessing.com/api/v2/crypto/withdrawal_instant_exchange', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.cryptoprocessing.com/api/v2/crypto/withdrawal_instant_exchange",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'sender_currency' => 'EUR',
    'received_currency' => 'BTC',
    'sender_amount' => '100',
    'address' => 'tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc',
    'foreign_id' => 'withdrawal_123',
    'end_user_reference' => 'user_12345',
    'sender_type' => 'legal',
    'sender_data' => [
        'legal_name' => 'Example GmbH',
        'country_of_registration' => 'DEU'
    ],
    'receiver_type' => 'natural',
    'receiver_data' => [
        'first_name' => 'Friedrich',
        'last_name' => 'Müller',
        'date_of_birth' => '1995-08-17'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Processing-Key: <api-key>",
    "X-Processing-Signature: <x-processing-signature>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.cryptoprocessing.com/api/v2/crypto/withdrawal_instant_exchange"

	payload := strings.NewReader("{\n  \"sender_currency\": \"EUR\",\n  \"received_currency\": \"BTC\",\n  \"sender_amount\": \"100\",\n  \"address\": \"tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc\",\n  \"foreign_id\": \"withdrawal_123\",\n  \"end_user_reference\": \"user_12345\",\n  \"sender_type\": \"legal\",\n  \"sender_data\": {\n    \"legal_name\": \"Example GmbH\",\n    \"country_of_registration\": \"DEU\"\n  },\n  \"receiver_type\": \"natural\",\n  \"receiver_data\": {\n    \"first_name\": \"Friedrich\",\n    \"last_name\": \"Müller\",\n    \"date_of_birth\": \"1995-08-17\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Processing-Signature", "<x-processing-signature>")
	req.Header.Add("X-Processing-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.cryptoprocessing.com/api/v2/crypto/withdrawal_instant_exchange")
  .header("X-Processing-Signature", "<x-processing-signature>")
  .header("X-Processing-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"sender_currency\": \"EUR\",\n  \"received_currency\": \"BTC\",\n  \"sender_amount\": \"100\",\n  \"address\": \"tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc\",\n  \"foreign_id\": \"withdrawal_123\",\n  \"end_user_reference\": \"user_12345\",\n  \"sender_type\": \"legal\",\n  \"sender_data\": {\n    \"legal_name\": \"Example GmbH\",\n    \"country_of_registration\": \"DEU\"\n  },\n  \"receiver_type\": \"natural\",\n  \"receiver_data\": {\n    \"first_name\": \"Friedrich\",\n    \"last_name\": \"Müller\",\n    \"date_of_birth\": \"1995-08-17\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.cryptoprocessing.com/api/v2/crypto/withdrawal_instant_exchange")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Processing-Signature"] = '<x-processing-signature>'
request["X-Processing-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"sender_currency\": \"EUR\",\n  \"received_currency\": \"BTC\",\n  \"sender_amount\": \"100\",\n  \"address\": \"tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc\",\n  \"foreign_id\": \"withdrawal_123\",\n  \"end_user_reference\": \"user_12345\",\n  \"sender_type\": \"legal\",\n  \"sender_data\": {\n    \"legal_name\": \"Example GmbH\",\n    \"country_of_registration\": \"DEU\"\n  },\n  \"receiver_type\": \"natural\",\n  \"receiver_data\": {\n    \"first_name\": \"Friedrich\",\n    \"last_name\": \"Müller\",\n    \"date_of_birth\": \"1995-08-17\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": 134702815,
    "foreign_id": "withdrawal_123",
    "end_user_reference": "user_12345",
    "type": "withdrawal_instant_exchange",
    "status": "processing",
    "sender_currency": "EUR",
    "sender_amount": "100.00000000",
    "received_currency": "BTC",
    "received_amount": "0.00153827"
  }
}

POST

crypto

withdrawal_instant_exchange

Withdraw BTC with conversion from EUR

curl --request POST \
  --url https://app.cryptoprocessing.com/api/v2/crypto/withdrawal_instant_exchange \
  --header 'Content-Type: application/json' \
  --header 'X-Processing-Key: <api-key>' \
  --header 'X-Processing-Signature: <x-processing-signature>' \
  --data '
{
  "sender_currency": "EUR",
  "received_currency": "BTC",
  "sender_amount": "100",
  "address": "tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc",
  "foreign_id": "withdrawal_123",
  "end_user_reference": "user_12345",
  "sender_type": "legal",
  "sender_data": {
    "legal_name": "Example GmbH",
    "country_of_registration": "DEU"
  },
  "receiver_type": "natural",
  "receiver_data": {
    "first_name": "Friedrich",
    "last_name": "Müller",
    "date_of_birth": "1995-08-17"
  }
}
'

import requests

url = "https://app.cryptoprocessing.com/api/v2/crypto/withdrawal_instant_exchange"

payload = {
    "sender_currency": "EUR",
    "received_currency": "BTC",
    "sender_amount": "100",
    "address": "tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc",
    "foreign_id": "withdrawal_123",
    "end_user_reference": "user_12345",
    "sender_type": "legal",
    "sender_data": {
        "legal_name": "Example GmbH",
        "country_of_registration": "DEU"
    },
    "receiver_type": "natural",
    "receiver_data": {
        "first_name": "Friedrich",
        "last_name": "Müller",
        "date_of_birth": "1995-08-17"
    }
}
headers = {
    "X-Processing-Signature": "<x-processing-signature>",
    "X-Processing-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Processing-Signature': '<x-processing-signature>',
    'X-Processing-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    sender_currency: 'EUR',
    received_currency: 'BTC',
    sender_amount: '100',
    address: 'tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc',
    foreign_id: 'withdrawal_123',
    end_user_reference: 'user_12345',
    sender_type: 'legal',
    sender_data: {legal_name: 'Example GmbH', country_of_registration: 'DEU'},
    receiver_type: 'natural',
    receiver_data: {first_name: 'Friedrich', last_name: 'Müller', date_of_birth: '1995-08-17'}
  })
};

fetch('https://app.cryptoprocessing.com/api/v2/crypto/withdrawal_instant_exchange', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.cryptoprocessing.com/api/v2/crypto/withdrawal_instant_exchange",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'sender_currency' => 'EUR',
    'received_currency' => 'BTC',
    'sender_amount' => '100',
    'address' => 'tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc',
    'foreign_id' => 'withdrawal_123',
    'end_user_reference' => 'user_12345',
    'sender_type' => 'legal',
    'sender_data' => [
        'legal_name' => 'Example GmbH',
        'country_of_registration' => 'DEU'
    ],
    'receiver_type' => 'natural',
    'receiver_data' => [
        'first_name' => 'Friedrich',
        'last_name' => 'Müller',
        'date_of_birth' => '1995-08-17'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Processing-Key: <api-key>",
    "X-Processing-Signature: <x-processing-signature>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.cryptoprocessing.com/api/v2/crypto/withdrawal_instant_exchange"

	payload := strings.NewReader("{\n  \"sender_currency\": \"EUR\",\n  \"received_currency\": \"BTC\",\n  \"sender_amount\": \"100\",\n  \"address\": \"tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc\",\n  \"foreign_id\": \"withdrawal_123\",\n  \"end_user_reference\": \"user_12345\",\n  \"sender_type\": \"legal\",\n  \"sender_data\": {\n    \"legal_name\": \"Example GmbH\",\n    \"country_of_registration\": \"DEU\"\n  },\n  \"receiver_type\": \"natural\",\n  \"receiver_data\": {\n    \"first_name\": \"Friedrich\",\n    \"last_name\": \"Müller\",\n    \"date_of_birth\": \"1995-08-17\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Processing-Signature", "<x-processing-signature>")
	req.Header.Add("X-Processing-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.cryptoprocessing.com/api/v2/crypto/withdrawal_instant_exchange")
  .header("X-Processing-Signature", "<x-processing-signature>")
  .header("X-Processing-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"sender_currency\": \"EUR\",\n  \"received_currency\": \"BTC\",\n  \"sender_amount\": \"100\",\n  \"address\": \"tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc\",\n  \"foreign_id\": \"withdrawal_123\",\n  \"end_user_reference\": \"user_12345\",\n  \"sender_type\": \"legal\",\n  \"sender_data\": {\n    \"legal_name\": \"Example GmbH\",\n    \"country_of_registration\": \"DEU\"\n  },\n  \"receiver_type\": \"natural\",\n  \"receiver_data\": {\n    \"first_name\": \"Friedrich\",\n    \"last_name\": \"Müller\",\n    \"date_of_birth\": \"1995-08-17\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.cryptoprocessing.com/api/v2/crypto/withdrawal_instant_exchange")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Processing-Signature"] = '<x-processing-signature>'
request["X-Processing-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"sender_currency\": \"EUR\",\n  \"received_currency\": \"BTC\",\n  \"sender_amount\": \"100\",\n  \"address\": \"tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc\",\n  \"foreign_id\": \"withdrawal_123\",\n  \"end_user_reference\": \"user_12345\",\n  \"sender_type\": \"legal\",\n  \"sender_data\": {\n    \"legal_name\": \"Example GmbH\",\n    \"country_of_registration\": \"DEU\"\n  },\n  \"receiver_type\": \"natural\",\n  \"receiver_data\": {\n    \"first_name\": \"Friedrich\",\n    \"last_name\": \"Müller\",\n    \"date_of_birth\": \"1995-08-17\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": 134702815,
    "foreign_id": "withdrawal_123",
    "end_user_reference": "user_12345",
    "type": "withdrawal_instant_exchange",
    "status": "processing",
    "sender_currency": "EUR",
    "sender_amount": "100.00000000",
    "received_currency": "BTC",
    "received_amount": "0.00153827"
  }
}

CryptoProcessing is required to collect sender data in compliance with the MiCA regulations. For more details, see User data collection. The sender_data and the end_user_reference you provide must be associated with the same customer.

Authorizations

X-Processing-Key

string

header

required

Your API key.

Headers

X-Processing-Signature

string

required

Hex-encoded HMAC-SHA512 signature of the request body, generated using your secret key.

Body

application/json

sender_currency

string

required

Currency to withdraw. For a list of all available currencies, see API currency codes.

received_currency

string

required

Target currency to convert funds into before sending.

sender_amount

number

required

Amount to withdraw in sender_currency.

address

string

required

Cryptocurrency address where you want to send funds.

foreign_id

string

required

Unique ID of the withdrawal request.

end_user_reference

string

required

Persistent internal ID of the merchant's customer who initiates the withdrawal. Use the same value for the same customer across all requests. This value must refer to the same customer described in sender_data.

Do not include personal data, such as the customer's name or email address. Put personal details in sender_data.

sender_type

enum<string>

required

Type of the merchant's customer who initiates the withdrawal. The sender must be the same customer identified by end_user_reference.

Use natural if the sender is an individual person and legal if the sender is a legal entity. The selected type determines which fields must be included in sender_data.

Available options:

natural,

legal

sender_data

Natural person · object

required

Must contain the details of the merchant's customer who initiates the withdrawal. Which fields are required depends on sender_type.

Natural person
Legal entity

Hide child attributes

sender_data.first_name

string

required

The sender's first name.

Maximum string length: 255

sender_data.last_name

string

required

The sender's last name.

Maximum string length: 255

sender_data.date_of_birth

string

required

The sender's date of birth, YYYY-MM-DD.

receiver_type

enum<string>

required

Type of the withdrawal recipient.

Use natural if the recipient is an individual person, legal if the recipient is a legal entity, or self if the recipient is the same person or legal entity as the sender.

The selected type determines whether receiver_data is required and which fields it must contain.

Available options:

natural,

legal,

self

receiver_data

Natural person · object

Details of the withdrawal recipient. Omit this field entirely if receiver_type is self. Otherwise, which fields are required depends on receiver_type.

Natural person
Legal entity

Hide child attributes

receiver_data.first_name

string

required

The recipient's first name.

receiver_data.last_name

string

required

The recipient's last name.

receiver_data.date_of_birth

string

required

The recipient's date of birth, YYYY-MM-DD.

Response

Created

data

object

Hide child attributes

data.id

integer

Transaction ID.

data.foreign_id

string

Unique ID of the withdrawal request.

data.end_user_reference

string

Do not include personal data, such as the customer's name or email address. Put personal details in sender_data.

data.type

string

Transaction type (always withdrawal_instant_exchange).

data.status

string

Transaction status.

data.sender_currency

string

Source currency ISO code.

data.sender_amount

string

Withdrawal amount in sender_currency.

data.received_currency

string

Destination currency ISO code.

data.received_amount

string

Amount sent in received_currency.

Last modified on July 31, 2026

Reference

Deposits & withdrawals

Payment requests

Currencies

Exchange

Transactions

Account balance

System Health

Withdraw crypto instantly with conversion

Authorizations

Headers

Body

Response