Initiate fiat withdrawal

const url = 'https://api.openfx.com/v2/brokerage/{orgId}/fiat_withdrawal';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: 10,
    currency: 'USD',
    withdrawalAddressId: '123e4567-e89b-12d3-a456-426614174001'
  })
};

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}/fiat_withdrawal"

payload = {
    "amount": 10,
    "currency": "USD",
    "withdrawalAddressId": "123e4567-e89b-12d3-a456-426614174001"
}
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}/fiat_withdrawal")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 10,\n  \"currency\": \"USD\",\n  \"withdrawalAddressId\": \"123e4567-e89b-12d3-a456-426614174001\"\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}/fiat_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\": \"USD\",\n  \"withdrawalAddressId\": \"123e4567-e89b-12d3-a456-426614174001\"\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}/fiat_withdrawal"

	payload := strings.NewReader("{\n  \"amount\": 10,\n  \"currency\": \"USD\",\n  \"withdrawalAddressId\": \"123e4567-e89b-12d3-a456-426614174001\"\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}/fiat_withdrawal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "amount": 10,
  "currency": "USD",
  "withdrawalAddressId": "123e4567-e89b-12d3-a456-426614174001"
}
'

{
  "status": "success",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2024-10-10T07:15:44.030Z",
    "amount": 1000000,
    "currency": "USD",
    "network": "FIAT",
    "status": "PENDING",
    "transactionHash": null,
    "withdrawalAddressId": "123e4567-e89b-12d3-a456-426614174001",
    "orgId": "123e4567-e89b-12d3-a456-426614174002",
    "actorId": "123e4567-e89b-12d3-a456-426614174003",
    "actorEmail": "[email protected]",
    "comments": "Client initiated the withdrawal via API"
  }
}

POST

brokerage

{orgId}

fiat_withdrawal

Initiate fiat withdrawal

const url = 'https://api.openfx.com/v2/brokerage/{orgId}/fiat_withdrawal';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: 10,
    currency: 'USD',
    withdrawalAddressId: '123e4567-e89b-12d3-a456-426614174001'
  })
};

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}/fiat_withdrawal"

payload = {
    "amount": 10,
    "currency": "USD",
    "withdrawalAddressId": "123e4567-e89b-12d3-a456-426614174001"
}
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}/fiat_withdrawal")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 10,\n  \"currency\": \"USD\",\n  \"withdrawalAddressId\": \"123e4567-e89b-12d3-a456-426614174001\"\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}/fiat_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\": \"USD\",\n  \"withdrawalAddressId\": \"123e4567-e89b-12d3-a456-426614174001\"\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}/fiat_withdrawal"

	payload := strings.NewReader("{\n  \"amount\": 10,\n  \"currency\": \"USD\",\n  \"withdrawalAddressId\": \"123e4567-e89b-12d3-a456-426614174001\"\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}/fiat_withdrawal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "amount": 10,
  "currency": "USD",
  "withdrawalAddressId": "123e4567-e89b-12d3-a456-426614174001"
}
'

{
  "status": "success",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2024-10-10T07:15:44.030Z",
    "amount": 1000000,
    "currency": "USD",
    "network": "FIAT",
    "status": "PENDING",
    "transactionHash": null,
    "withdrawalAddressId": "123e4567-e89b-12d3-a456-426614174001",
    "orgId": "123e4567-e89b-12d3-a456-426614174002",
    "actorId": "123e4567-e89b-12d3-a456-426614174003",
    "actorEmail": "[email protected]",
    "comments": "Client initiated the withdrawal via API"
  }
}

Initiates a fiat withdrawal to an approved bank account. The target account must already exist in the organization’s approved fiat withdrawal accounts — retrieve its ID via List fiat withdrawal accounts. Use this endpoint to:

Send USD, EUR, GBP, AED, AUD, MXN, BRL, PHP, ARS, or COP to an approved bank account
Initiate fiat 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.

FEDWIRE payment details. Once a USD FEDWIRE withdrawal settles, the bank-side identifiers (IMAD outbound, OMAD inbound) are surfaced on the withdrawal record under paymentDetails.FEDWIRE. Poll GET /v2/brokerage/{orgId}/withdrawal/{withdrawalId} after submission to pick them up — they may not appear on the initial response.

Errors

Status	Message	Notes
400	`Query validation failed`	Request didn’t match schema
400	`Checksum verification failed for withdrawal address`	Destination account fails verification (e.g. malformed routing/SWIFT data)
400	`Insufficient balance for this withdraw.`	Fiat balance below requested amount (message string includes trailing period and `withdraw` typo per spec)
400	`Withdrawal account is not active or verified`	Destination bank account 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:

USD,

AED,

GBP,

EUR,

AUD,

MXN,

BRL,

PHP,

ARS,

COP

Example:

"USD"

withdrawalAddressId

string<uuid>

required

Example:

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

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 fiat withdrawal

Errors

Authorizations

Headers

Path Parameters

Body

Response

​Errors

Authorizations

Headers

Path Parameters

Body

Response

Errors