> For the complete documentation index, see [llms.txt](https://docs.ur.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ur.app/money-movement/fx.md).

# FX conversion

{% hint style="warning" %}
Detailed integration guides for FX will be added as the Managed Custody Mode FX API becomes available.
{% endhint %}

## What this will cover

* How FX conversion works (atomic burn-and-mint on Mantle Network)
* Supported currency pairs across 7 tokenized deposit currencies
* Rate calculation and fees
* Step-by-step integration guide with code samples

{% hint style="info" %}
FX is already available for **External Wallet Access Mode** integrations. See the [External Wallet Access Mode FX flow](/integration-methods/external-wallet-access-mode.md#fiat-to-fiat-fx) for the current implementation with sequence diagrams.
{% endhint %}

## How FX works

Users can instantly convert between fiat currencies they hold (e.g., USD to EUR). Behind the scenes, UR executes an atomic burn-and-mint operation on the user's tokenized deposits.

```mermaid
sequenceDiagram
participant U as User
participant App as UR App
participant UR as UR (System)
participant MN as Mantle Network

U->>App: 1. Taps 'Convert'
activate App
U->>App: 2. Enters "100 USD to EUR"

App->>UR: 3. Request FX Quote (USD/EUR)
activate UR
UR-->>App: 4. Provide Live Rate (e.g., 1 USD = 0.92 EUR)

App->>U: 5. Display Quote: "Convert 100 USD to ~92.00 EUR?"
U->>App: 6. Confirms Conversion

App->>UR: 7. Execute Confirmed FX Trade

UR-->>MN: 8. Initiate Atomic Swap
activate MN
Note over UR, MN: The following is a single atomic transaction
UR->>MN: 8a. BURN 100 USD24 from User's Wallet
UR->>MN: 8b. MINT 92.00 EUR24 to User's Wallet

MN-->>UR: 9. Transaction Confirmed
deactivate MN

UR-->>App: 10. Conversion Successful
deactivate UR

App->>U: 11. Show success screen & updated balances
deactivate App
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ur.app/money-movement/fx.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.