Skip to main content
The OpenFX v2 API provides programmatic access to market data, trade execution, and money movement. This page lists every v2 endpoint grouped by domain, with links to the full reference. Version: v2.0.0

​
Server

​
Security

See Authentication for how to mint a bearer token.

​
OpenAPI description

Download the v2 OpenAPI bundle: api-docs.openfx.com/_bundle/api/v2/index.yaml

​
MarketData

Retrieve the complete list of tradable fiat and stablecoin currency pairs on the OpenFX platform.

Get available markets

GET /v2/brokerage/{orgId}/available_markets — Access the complete list of tradable currency pairs along with trading limits and supported directions.

​
Balances

Real-time tracking and management of currency holdings within an account.

Get balances

GET /v2/brokerage/{orgId}/balances — View real-time balances, track multi-currency holdings, monitor available trading funds, and reconcile account positions.

​
Trade

The Trade endpoints implement a quote-then-trade workflow: generate a quote, then execute against the quote ID within the 3-second validity window.

Generate quote

POST /v2/brokerage/{orgId}/generate_quote — Create a quote for a specific currency pair and amount. Returns a quote ID and rate valid for 3 seconds.
Idempotency (v2 only): generate_quote requires an Idempotency-Key header. Keys are cached for 30 minutes. Reusing a key with the same parameters returns the cached response; different parameters return a 422.

List trades

GET /v2/brokerage/{orgId}/trades — List all trades, both completed and pending. Use it to track activity, monitor statuses, generate reports, and reconcile transactions.

Get trade by ID

GET /v2/brokerage/{orgId}/trade/{id} — Detailed information on a specific trade: execution details, settlement status, timestamps, and trade parameters.

Execute trade

POST /v2/brokerage/{orgId}/trade — Execute a currency exchange against a valid quote ID. Must be called within 3 seconds of quote generation.
Idempotency (v2 only): trade requires an Idempotency-Key header. Keys are cached for 24 hours. Reusing a key with the same parameters returns the cached response; different parameters return a 422.

​
Deposits

Deposit endpoints provide visibility into incoming funding across supported fiat currencies and stablecoins.

List deposits

GET /v2/brokerage/{orgId}/deposits — Get a complete view of all deposits (fiat and stablecoin) for an organization.

​
Withdrawals

Withdrawal endpoints manage outbound payments to approved wallets and bank accounts, for both fiat and stablecoin rails.

List withdrawal wallets

GET /v2/brokerage/{orgId}/withdrawal_addresses — Retrieve the list of approved stablecoin wallets that can receive withdrawals.

List fiat withdrawal accounts

GET /v2/brokerage/{orgId}/fiat_withdrawal_addresses — Retrieve the list of approved fiat withdrawal accounts. Paginated for organizations with many accounts.

List withdrawals

GET /v2/brokerage/{orgId}/withdrawals — Get a complete view of all withdrawals (fiat and stablecoin) for an organization.

Get withdrawal by ID

GET /v2/brokerage/{orgId}/withdrawal/{withdrawalId} — Detailed information on a specific withdrawal using its unique identifier.

Initiate stablecoin withdrawal

POST /v2/brokerage/{orgId}/withdrawal — Initiate a stablecoin withdrawal to an approved wallet address.
Idempotency (v2 only): withdrawal requires an Idempotency-Key header. Keys are cached for 7 days. Reusing a key with the same parameters returns the cached response; different parameters return a 422.

Initiate fiat withdrawal

POST /v2/brokerage/{orgId}/fiat_withdrawal — Initiate a fiat withdrawal to an approved bank account.
Idempotency (v2 only): fiat_withdrawal requires an Idempotency-Key header. Keys are cached for 7 days. Reusing a key with the same parameters returns the cached response; different parameters return a 422.

​
See also