Initiate stablecoin withdrawal

const url = 'https://api.openfx.com/v2/brokerage/{orgId}/withdrawal';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: 10,
    currency: 'USDT',
    withdrawalAddressId: '392cf015-5045-4615-a226-df3543d9c15f'
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.openfx.com/v2/brokerage/{orgId}/withdrawal"

payload = {
    "amount": 10,
    "currency": "USDT",
    "withdrawalAddressId": "392cf015-5045-4615-a226-df3543d9c15f"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

HttpResponse<String> response = Unirest.post("https://api.openfx.com/v2/brokerage/{orgId}/withdrawal")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 10,\n  \"currency\": \"USDT\",\n  \"withdrawalAddressId\": \"392cf015-5045-4615-a226-df3543d9c15f\"\n}")
  .asString();

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.openfx.com/v2/brokerage/{orgId}/withdrawal");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Idempotency-Key: <idempotency-key>");
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\n  \"amount\": 10,\n  \"currency\": \"USDT\",\n  \"withdrawalAddressId\": \"392cf015-5045-4615-a226-df3543d9c15f\"\n}");

CURLcode ret = curl_easy_perform(hnd);

package main

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

func main() {

	url := "https://api.openfx.com/v2/brokerage/{orgId}/withdrawal"

	payload := strings.NewReader("{\n  \"amount\": 10,\n  \"currency\": \"USDT\",\n  \"withdrawalAddressId\": \"392cf015-5045-4615-a226-df3543d9c15f\"\n}")

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

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	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))

}

curl --request POST \
  --url https://api.openfx.com/v2/brokerage/{orgId}/withdrawal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "amount": 10,
  "currency": "USDT",
  "withdrawalAddressId": "392cf015-5045-4615-a226-df3543d9c15f"
}
'

{
  "status": "success",
  "data": {
    "id": "392cf015-5045-4615-a226-df3543d9c15f",
    "createdAt": "2025-02-07T14:04:14.268Z",
    "amount": 0.5,
    "currency": "USDT",
    "network": "ETHEREUM",
    "status": "COMPLETED",
    "transactionHash": null,
    "withdrawalAddressId": "2697eff1-ac30-41db-94b7-d615133a5c9e",
    "orgId": "c96183a5-2830-4606-9ae2-15dfd058872b",
    "actorId": "36bdb6a4-7cc6-4a08-b325-db416dbdd9f5",
    "actorEmail": "[email protected]",
    "comments": "Client initiated the withdrawal"
  }
}

POST

brokerage

{orgId}

withdrawal

Initiate stablecoin withdrawal

const url = 'https://api.openfx.com/v2/brokerage/{orgId}/withdrawal';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: 10,
    currency: 'USDT',
    withdrawalAddressId: '392cf015-5045-4615-a226-df3543d9c15f'
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.openfx.com/v2/brokerage/{orgId}/withdrawal"

payload = {
    "amount": 10,
    "currency": "USDT",
    "withdrawalAddressId": "392cf015-5045-4615-a226-df3543d9c15f"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

HttpResponse<String> response = Unirest.post("https://api.openfx.com/v2/brokerage/{orgId}/withdrawal")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 10,\n  \"currency\": \"USDT\",\n  \"withdrawalAddressId\": \"392cf015-5045-4615-a226-df3543d9c15f\"\n}")
  .asString();

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.openfx.com/v2/brokerage/{orgId}/withdrawal");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Idempotency-Key: <idempotency-key>");
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\n  \"amount\": 10,\n  \"currency\": \"USDT\",\n  \"withdrawalAddressId\": \"392cf015-5045-4615-a226-df3543d9c15f\"\n}");

CURLcode ret = curl_easy_perform(hnd);

package main

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

func main() {

	url := "https://api.openfx.com/v2/brokerage/{orgId}/withdrawal"

	payload := strings.NewReader("{\n  \"amount\": 10,\n  \"currency\": \"USDT\",\n  \"withdrawalAddressId\": \"392cf015-5045-4615-a226-df3543d9c15f\"\n}")

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

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	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))

}

curl --request POST \
  --url https://api.openfx.com/v2/brokerage/{orgId}/withdrawal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "amount": 10,
  "currency": "USDT",
  "withdrawalAddressId": "392cf015-5045-4615-a226-df3543d9c15f"
}
'

{
  "status": "success",
  "data": {
    "id": "392cf015-5045-4615-a226-df3543d9c15f",
    "createdAt": "2025-02-07T14:04:14.268Z",
    "amount": 0.5,
    "currency": "USDT",
    "network": "ETHEREUM",
    "status": "COMPLETED",
    "transactionHash": null,
    "withdrawalAddressId": "2697eff1-ac30-41db-94b7-d615133a5c9e",
    "orgId": "c96183a5-2830-4606-9ae2-15dfd058872b",
    "actorId": "36bdb6a4-7cc6-4a08-b325-db416dbdd9f5",
    "actorEmail": "[email protected]",
    "comments": "Client initiated the withdrawal"
  }
}

Initiates a stablecoin withdrawal to an approved wallet address. The target wallet must already exist in the organization’s approved withdrawal wallets — retrieve its ID via List withdrawal wallets. Use this endpoint to:

Send USDT, USDC, or EURC to an approved wallet
Initiate stablecoin payouts from the organization’s balance
Record a withdrawal that can later be tracked by ID

Idempotency required. This POST requires an Idempotency-Key header. Keys are cached for 7 days. Reusing the same key with the same body returns the cached response; reusing it with different parameters returns a 422 error.

Errors

Status	Message	Notes
400	`Query validation failed`	Request didn’t match schema
400	`Checksum verification failed for withdrawal address`	Destination wallet address fails on-chain checksum — surface to user, do not retry
400	`Insufficient balance for this withdraw.`	Stablecoin balance below requested amount (message string includes trailing period and `withdraw` typo per spec)
400	`Withdrawal address is not active or verified`	Destination wallet exists but is not yet approved for outbound transfers
401	`The authorization key provided is either invalid or expired, please try again`	Mint a fresh JWT — see Authentication
409	`Request with this idempotency key is currently processing`	See Errors → Idempotency
422	`Idempotency key reused with different parameters`	New body → new key
500	`An internal error has occurred`	Withdrawal may or may not have been submitted — GET the withdrawal by ID before retrying

See the full v2 error reference for retry semantics and idempotency-specific codes.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key

string<uuid>

required

Unique key to ensure idempotent requests. UUID v4 recommended. Valid for 7 days.

Example:

"123e4567-e89b-12d3-a456-426614174000"

Path Parameters

orgId

string

required

Body

application/json

amount

number

required

Example:

10

currency

enum<string>

required

Available options:

USDT,

USDC,

EURC

Example:

"USDT"

withdrawalAddressId

string<uuid>

required

Example:

"392cf015-5045-4615-a226-df3543d9c15f"

Response

success

status

enum<string>

Available options:

success,

error

Example:

"success"

data

object

Show child attributes

message

string

Example:

"Data fetched successfully"

⌘I

Overview

Market Data

Balances

Trade

Deposits

Withdrawals

Initiate stablecoin withdrawal

Errors

Authorizations

Headers

Path Parameters

Body

Response

​Errors

Authorizations

Headers

Path Parameters

Body

Response

Errors