Skip to main content
What this is. Your organization trades against a credit line extended by OpenFX. Every executed trade that hasn’t fully settled draws against that line. GET /v3/fx/exposures returns how much of the line is currently committed, aggregated and broken down by currency. When it matters. Before submitting a large trade, to confirm you have headroom left on the credit line. When reconciling, to understand why a trade was rejected with TRADE_CREDIT_LIMIT_EXCEEDED.

​
Response shape

A successful response wraps this in data. The exposure summary itself is:
Amounts are decimal strings without fixed precision — trailing zeros aren’t padded ("1200", not "1200.00"). Don’t assume a fixed number of decimal places when parsing.
  • aggregate rolls up credit-line usage into a single currency (aggregate.currency). limitAmount is the total line; usedAmount is what’s committed; availableAmount is the difference and can be negative if open exposure currently exceeds the limit (for example, right after a limit reduction).
  • currencyExposures breaks the same open exposure down per currency, in each currency’s own denomination. A currency with no open trades is omitted from the array rather than listed at zero.
Only currencies with currently open exposure appear in currencyExposures. An empty array means the organization has no open exposure at all.

​
Settlable now vs. settlable later

Both aggregate.usageBreakdown and each currency’s usageBreakdown split exposure by whether the underlying trades’ settlement window has opened:
  • settlableNow — exposure from trades whose settlement window has opened.
  • settlableLater — exposure from trades whose settlement window hasn’t opened yet.
See Trading → settlement window for how T0 / T1 / T2 and Trade.settlementStartTime determine when a trade’s window opens.

​
No exposure limit configured

If your organization has no credit exposure limit configured, the endpoint returns 403 EXPOSURE_NOT_ENABLED instead of a summary. Contact your Customer Success representative at [email protected] to have a limit configured.

​
What’s next

Trading

Quote-then-trade workflow, settlement windows, and trade lifecycle.

Trade Settlement

Balances, deposits, withdrawals, and verified withdrawal accounts.

Errors

Stable error codes and the retry triage matrix.