Embedded FX APIs for Brazilian reais and dollar stablecoins
How Crown FX offers embedded FX APIs between Brazilian reais and the dollar stablecoins USDC and USDT: sub-accounts, quotes, Pix, webhooks and reporting.
Crown FX, the institutional FX infrastructure of Crown, offers an embedded FX API between Brazilian reais and the dollar stablecoins USDC and USDT, in the FX-as-a-Service model. Companies that want to embed FX in their own products integrate Crown’s APIs, and Crown handles settlement and the mandatory reporting to the Central Bank of Brazil, including the transactions of the client’s end users. This page describes Crown FX. It does not compare other providers.
The model
In FX-as-a-Service, the company embeds instant FX directly in its product experience: sending, receiving and converting between reais and dollar stablecoins, transparently to the end user. According to Crown, the company monetizes the FX and keeps the customer on its own platform. Crown describes the profile that fits this model as companies in any sector, such as remittance companies and international payment platforms, marketplaces and e-commerce companies with suppliers or customers abroad, travel platforms, ERPs with a financial module and fintechs serving businesses with international flows. The regulatory side is in embedding dollar-real FX in a product: who handles the Central Bank reporting.
What the API covers
The platform is fully accessible through a secure web interface or API, with public documentation at docs.crown-brlv.com, and the OpenAPI specification is available. The API uses API keys and JWT tokens. It allows a company to:
- create and query accounts and sub-accounts, in a partner model for companies that serve their own clients;
- create wallets and transfer tokens between EVM wallets;
- generate Pix QR Codes for deposits in reais and track deposits;
- get quotes and execute conversion orders between assets;
- request withdrawals by Pix, TED or token;
- query balances and the complete transaction history, with all on-chain transactions linked and identified.
Webhooks
The platform sends a webhook for each event: deposit processed, order completed, transfer completed, withdrawal completed, redemption completed and sub-account approved.
Quote, confirmation and settlement
The client requests a quote, the desk returns it with the full spread visible, the client confirms, and execution is immediate at the locked price, within the applicable operating limits. Settlement happens in real time through Pix on the real side and in USDC or USDT on the dollar side. Operations through the API settle in a few minutes (D+0), and operations of very high volumes may settle within the business-day window, up to 6 p.m. (Brasília time). Crown consolidates the month’s transactions in the format required by the Central Bank.
Tax, regulatory status and risks
According to Crown, IOF-Câmbio does not apply to Crown FX operations because virtual assets, and not foreign currency, are traded; see Crown FX and IOF: why embedded real-to-dollar settlement isn’t taxed as a currency exchange. Crown is a virtual asset service provider under Law No. 14,478/2022, has filed an authorization request with the Central Bank of Brazil and operates under the transition regime, as informed by Crown in September 2026. Crown describes regulatory, technology and tax risks and states that it does not promise absolute security or any financial result. The two Crown FX models, Liquidity Provider and FX-as-a-Service, are compared in institutional BRL and dollar-stablecoin liquidity: Liquidity Provider vs. FX-as-a-Service.