> ## Documentation Index
> Fetch the complete documentation index at: https://developers.circle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Release notes - StableFX - 2026

> 2026 release notes for StableFX

## June 2026

<Update label="2026.06.25">
  ### API updates

  Typed-data message fields that carry `uint256` onchain values now use the
  `string` type instead of `integer`. These values can exceed JavaScript's
  safe-integer range (2^53). Sending them as strings prevents precision loss and
  matches the data you sign.

  The change applies to the `nonce`, `deadline`, `fee`, and `amount` fields in the
  Permit2 message and witness schemas. You use these schemas when you sign
  StableFX trades and funding authorizations. Update your integration to send and
  parse these fields as strings.
</Update>

<Update label="2026.06.24">
  ### API additions

  Added the following endpoints to read Settlement Advance reservations:

  * [`GET /v1/exchange/stablefx/settlementAdvance/reservation`](/api-reference/stablefx/all/list-settlement-advance-reservations)
  * [`GET /v1/exchange/stablefx/settlementAdvance/reservation/{reservationId}`](/api-reference/stablefx/all/get-settlement-advance-reservation)
</Update>

<Update label="2026.06.08">
  Added Settlement Advance, which lets a maker borrow local stablecoin inventory
  against a Circle-issued credit line to fund and instantly settle a confirmed
  StableFX trade.

  ### Documentation additions

  The following documentation was created:

  * [StableFX settlement advance](/stablefx/concepts/settlement-advance)
  * [How-to: Fund a trade with a settlement advance](/stablefx/howtos/fund-trade-settlement-advance)

  ### API additions

  Added the following endpoints to support Settlement Advance:

  * [`GET /v1/exchange/stablefx/settlementAdvance/credit`](/api-reference/stablefx/all/get-settlement-advance-credit)
  * [`POST /v1/exchange/stablefx/settlementAdvance/reserve`](/api-reference/stablefx/all/reserve-settlement-advance)
  * [`POST /v1/exchange/stablefx/signatures/settlementAdvance/presign`](/api-reference/stablefx/all/presign-settlement-advance)
  * [`POST /v1/exchange/stablefx/settlementAdvance`](/api-reference/stablefx/all/request-settlement-advance)
  * [`GET /v1/exchange/stablefx/settlementAdvance/{advanceId}`](/api-reference/stablefx/all/get-settlement-advance-detail)
  * [`GET /v1/exchange/stablefx/settlementAdvances`](/api-reference/stablefx/all/list-settlement-advances)
  * [`POST /v1/exchange/stablefx/settlementAdvance/repayment`](/api-reference/stablefx/all/repay-settlement-advance)
</Update>

## April 2026

<Update label="2026.04.14">
  ### Documentation additions

  Added the following new topic for StableFX API limits:

  * [StableFX API rate limits](/stablefx/references/api-rate-limits)
</Update>

## February 2026

<Update label="2026.02.06">
  ### Documentation additions

  Added the following new topic to document the StableFX trade lifecycle:

  * [StableFX trade states](/stablefx/references/trade-states)
</Update>

<Update label="2026.02.04">
  Added StableFX webhook documentation and subscription management API references.

  ### Documentation additions

  The following documentation was created:

  * [How-to: Set up a webhook endpoint](/api-reference/webhook-endpoints)
  * [How-to: Verify webhook signatures](/api-reference/verify-webhook-signatures)

  ### API additions

  Added the following endpoints to support StableFX webhook subscriptions:

  * [`POST /v1/stablefx/notifications/subscriptions`](/api-reference/stablefx/all/create-subscription)
  * [`GET /v1/stablefx/notifications/subscriptions`](/api-reference/stablefx/all/get-subscriptions)
  * [`GET /v1/stablefx/notifications/subscriptions/{id}`](/api-reference/stablefx/all/get-subscription)
  * [`PUT /v1/stablefx/notifications/subscriptions/{id}`](/api-reference/stablefx/all/update-subscription)
  * [`DELETE /v1/stablefx/notifications/subscriptions/{id}`](/api-reference/stablefx/all/delete-subscription)
  * [`GET /v1/stablefx/notifications/signatures/{notificationId}`](/api-reference/stablefx/all/get-notification-signature)
</Update>

## January 2026

<Update label="2026.01.22">
  Updated StableFX documentation to reflect the latest API environments.

  ### Documentation updates

  The following documentation was updated:

  * [StableFX technical guide](/stablefx/concepts/technical-guide)
  * [Fulfill an FX trade as a maker](/stablefx/quickstarts/fx-trade-maker)
  * [Create an FX trade as a taker](/stablefx/quickstarts/fx-trade-taker)
  * [Test StableFX Integration as a Maker](/stablefx/tutorials/test-stablefx-integration-maker)
  * [Test StableFX Integration as a Taker](/stablefx/tutorials/test-stablefx-integration-taker)
</Update>