> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs-v3.openfx.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Exposure

> The organization's credit-line usage: how much is committed to unsettled trades, and the breakdown by currency and settlement stage.

**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`](/v3/api-reference/exposure/get-exposure-summary) 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:

```json theme={null}
{
  "aggregate": {
    "currency": "USD",
    "limitAmount": "50000",
    "usedAmount": "1200",
    "availableAmount": "48800",
    "usageBreakdown": {
      "settlableNow": "800",
      "settlableLater": "400"
    }
  },
  "currencyExposures": [
    {
      "currency": "USD",
      "exposureAmount": "1200",
      "usageBreakdown": {
        "settlableNow": { "amount": "800" },
        "settlableLater": { "amount": "400" }
      }
    }
  ]
}
```

<Note>
  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.
</Note>

* **`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.

<Note>
  Only currencies with currently open exposure appear in `currencyExposures`. An
  empty array means the organization has no open exposure at all.
</Note>

## 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](/v3/trading) 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 [support@openfx.com](mailto:support@openfx.com) to have a limit configured.

## What's next

<CardGroup cols={2}>
  <Card title="Trading" icon="arrows-rotate" href="/v3/trading">
    Quote-then-trade workflow, settlement windows, and trade lifecycle.
  </Card>

  <Card title="Trade Settlement" icon="wallet" href="/v3/trade-settlement">
    Balances, deposits, withdrawals, and verified withdrawal accounts.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/v3/errors">
    Stable error codes and the retry triage matrix.
  </Card>
</CardGroup>