List withdrawal accounts

GET

withdrawal-accounts

Node.js

const url = 'https://api.openfx.com/v3/fx/withdrawal-accounts';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'X-Request-Signature': '<api-key>'}
};

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

import requests
# sign_request mints a fresh 60s JWT AND the matching X-Request-Signature. See Authentication
url = 'https://api.openfx.com/v3/fx/withdrawal-accounts'
headers, _ = sign_request('GET', url, b'')
accounts = requests.get(url, headers=headers).json()['data']

HttpResponse<String> response = Unirest.get("https://api.openfx.com/v3/fx/withdrawal-accounts")
  .header("Authorization", "Bearer <token>")
  .header("X-Request-Signature", "<api-key>")
  .asString();

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.openfx.com/v3/fx/withdrawal-accounts");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "X-Request-Signature: <api-key>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

package main

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

func main() {

	url := "https://api.openfx.com/v3/fx/withdrawal-accounts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Request-Signature", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "data": [
    {
      "object": "withdrawalAccount",
      "id": "wac_NDqQ9LmcUASpnHR6CTvdkk",
      "assetType": "FIAT",
      "network": null,
      "rail": "FEDWIRE",
      "displayName": "Acme Corp checking",
      "currency": "USD",
      "status": "ACTIVE",
      "verified": true,
      "creatorId": "usr_7m4VsfRw4pGrS76WYj5tnx",
      "destination": {
        "accountName": "Acme Treasury LLC",
        "accountNumber": "1234567890",
        "bankName": "JPMorgan Chase",
        "routingNumber": "021000021"
      },
      "createdAt": "2026-02-14T15:30:00.000Z",
      "updatedAt": "2026-03-02T18:14:55.000Z"
    },
    {
      "object": "withdrawalAccount",
      "id": "wac_JaAf8vzg5Dj95u5RUQVFkA",
      "assetType": "CRYPTO",
      "network": "ETHEREUM",
      "rail": null,
      "displayName": "Treasury cold storage",
      "currency": "USDC",
      "status": "ACTIVE",
      "verified": true,
      "creatorId": "usr_7m4VsfRw4pGrS76WYj5tnx",
      "destination": {
        "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
      },
      "createdAt": "2026-03-15T14:22:01.000Z",
      "updatedAt": "2026-03-15T14:22:01.000Z"
    }
  ],
  "pagination": {
    "limit": 25,
    "hasNext": false,
    "nextCursor": null,
    "hasPrev": false,
    "prevCursor": null
  }
}

Authorizations

Authorization

string

header

required

ES256-signed JWT bearer token, single-use, 60-second TTL. See Authentication for how to mint one.

X-Request-Signature

string

header

required

ES256 signature over the request, bound to the bearer JWT. Required on every request. See Authentication → Request signing.

Headers

X-Request-Id

string

Optional, client-supplied correlation ID for this request. Echoed verbatim on the response when supplied; the response omits it when the request did not supply one. Distinct from X-Trace-Id (server-generated, always present). See Metadata & tracing.

Example:

"my-req-abc-123"

X-App-Mode

enum<string>

default:SANDBOX

Environment selector, matching the API key's bound environment. Defaults to SANDBOX when omitted. See Environments. When present, the value must be SANDBOX or LIVE, matched without regard to case. Any other value, including an empty one, returns 400 INVALID_APP_MODE; details.received echoes the value you sent.

Available options:

SANDBOX,

LIVE

Example:

"SANDBOX"

Query Parameters

limit

integer

default:25

Max records to return. Range 1–100. Default 25.

Required range: 1 <= x <= 100

Example:

50

startingAfter

string

An opaque cursor string from a previous response's pagination.nextCursor. Fetches the page of records older than the cursor's position (lists are sorted newest-first). Cursors are opaque — pass them back verbatim, do not decode or modify them. Mutually exclusive with endingBefore.

Example:

"eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA3VDEzOjAyOjI5LjE0N1oiLCJpZCI6IjZhOGRmZjAzLWFiY2QtNDEyMy1iYWNkLTAxMjM0NTY3ODlhYiJ9"

endingBefore

string

An opaque cursor string from a previous response's pagination.prevCursor. Fetches the page of records newer than the cursor's position. Cursors are opaque — pass them back verbatim, do not decode or modify them. Mutually exclusive with startingAfter.

Example:

"eyJjcmVhdGVkQXQiOiIyMDI2LTAyLTA4VDA5OjE1OjAwLjAwMFoiLCJpZCI6ImExMmJjMzQ1LWQ2ZTctNDg5MC1iY2RlLWZlZGNiYTk4NzY1NCJ9"

assetType

enum<string>

Restrict results to crypto or fiat accounts. Omit to return both.

Available options:

CRYPTO,

FIAT

verified

enum<string>

Filter by verification state. true returns verified accounts only.

Available options:

true,

false

status

enum<string>

Filter by account lifecycle status.

Available options:

PENDING,

ACTIVE,

ARCHIVED,

REJECTED,

DEACTIVATED,

ADDITIONAL_ACTION_NEEDED

currency

string

Filter by a supported currency code. Crypto: USDC/USDT/EURC; fiat: USD/EUR/GBP/...

network

string

Filter by chain name. Must be uppercase. Crypto-only — supplying it excludes all fiat results, and combining it with assetType=FIAT is rejected with a 400.

rail

enum<string>

Filter by fiat rail. Fiat-only: supplying it excludes all crypto results, and combining it with assetType=CRYPTO is rejected with a 400.

Available options:

SWIFT,

SEPA,

FEDWIRE,

FPS,

UAEFTS,

NPP,

PESONET,

SPEI,

PIX,

PSE,

ACH,

TRANSFERENCIA_3_0,

ACH/WIRE,

CUBIX,

BLINC,

COELSA,

SNP

Response

List of verified withdrawal accounts.

A paginated collection of withdrawal account resources.

data

object[]

required

Withdrawal account resources returned in this page, sorted newest first.

Show child attributes

pagination

object

required

Pagination envelope for unbounded list responses. hasNext / hasPrev are the explicit "is there another page in this direction" booleans; nextCursor / prevCursor are the opaque cursors you pass back verbatim via the startingAfter / endingBefore query parameters. When hasNext is false the nextCursor is null (you are on the last page); likewise hasPrev / prevCursor on the first page.

Show child attributes

⌘I

Node.js

const url = 'https://api.openfx.com/v3/fx/withdrawal-accounts';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'X-Request-Signature': '<api-key>'}
};

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

import requests
# sign_request mints a fresh 60s JWT AND the matching X-Request-Signature. See Authentication
url = 'https://api.openfx.com/v3/fx/withdrawal-accounts'
headers, _ = sign_request('GET', url, b'')
accounts = requests.get(url, headers=headers).json()['data']

HttpResponse<String> response = Unirest.get("https://api.openfx.com/v3/fx/withdrawal-accounts")
  .header("Authorization", "Bearer <token>")
  .header("X-Request-Signature", "<api-key>")
  .asString();

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.openfx.com/v3/fx/withdrawal-accounts");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "X-Request-Signature: <api-key>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

package main

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

func main() {

	url := "https://api.openfx.com/v3/fx/withdrawal-accounts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Request-Signature", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "data": [
    {
      "object": "withdrawalAccount",
      "id": "wac_NDqQ9LmcUASpnHR6CTvdkk",
      "assetType": "FIAT",
      "network": null,
      "rail": "FEDWIRE",
      "displayName": "Acme Corp checking",
      "currency": "USD",
      "status": "ACTIVE",
      "verified": true,
      "creatorId": "usr_7m4VsfRw4pGrS76WYj5tnx",
      "destination": {
        "accountName": "Acme Treasury LLC",
        "accountNumber": "1234567890",
        "bankName": "JPMorgan Chase",
        "routingNumber": "021000021"
      },
      "createdAt": "2026-02-14T15:30:00.000Z",
      "updatedAt": "2026-03-02T18:14:55.000Z"
    },
    {
      "object": "withdrawalAccount",
      "id": "wac_JaAf8vzg5Dj95u5RUQVFkA",
      "assetType": "CRYPTO",
      "network": "ETHEREUM",
      "rail": null,
      "displayName": "Treasury cold storage",
      "currency": "USDC",
      "status": "ACTIVE",
      "verified": true,
      "creatorId": "usr_7m4VsfRw4pGrS76WYj5tnx",
      "destination": {
        "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
      },
      "createdAt": "2026-03-15T14:22:01.000Z",
      "updatedAt": "2026-03-15T14:22:01.000Z"
    }
  ],
  "pagination": {
    "limit": 25,
    "hasNext": false,
    "nextCursor": null,
    "hasPrev": false,
    "prevCursor": null
  }
}

Core concepts

Endpoints

Webhooks

List withdrawal accounts

Authorizations

Headers

Query Parameters

Response