July 2026
Breaking API changes
Settlement Advance endpoints now use plural URL path segments. Update your integration to call the new paths.See the StableFX API reference for the complete list
of updated endpoints.
API updates
Trade schemas now include afee field so you can see the fee applied to a
trade directly in the trade response. See
Create a trade and
Get a trade by ID.June 2026
API updates
Typed-data message fields that carryuint256 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.API additions
Added the following endpoints to read Settlement Advance reservations: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:API additions
Added the following endpoints to support Settlement Advance:GET /v1/exchange/stablefx/settlementAdvance/creditPOST /v1/exchange/stablefx/settlementAdvance/reservePOST /v1/exchange/stablefx/signatures/settlementAdvance/presignPOST /v1/exchange/stablefx/settlementAdvanceGET /v1/exchange/stablefx/settlementAdvance/{advanceId}GET /v1/exchange/stablefx/settlementAdvancesPOST /v1/exchange/stablefx/settlementAdvance/repayment
April 2026
Documentation additions
Added the following new topic for StableFX API limits:February 2026
Documentation additions
Added the following new topic to document the StableFX trade lifecycle:Added StableFX webhook documentation and subscription management API references.
Documentation additions
The following documentation was created:API additions
Added the following endpoints to support StableFX webhook subscriptions:POST /v1/stablefx/notifications/subscriptionsGET /v1/stablefx/notifications/subscriptionsGET /v1/stablefx/notifications/subscriptions/{id}PUT /v1/stablefx/notifications/subscriptions/{id}DELETE /v1/stablefx/notifications/subscriptions/{id}GET /v1/stablefx/notifications/signatures/{notificationId}
January 2026
Updated StableFX documentation to reflect the latest API environments.