---
title: "Execute FX"
method: POST
path: "/api/service/fx/execute"
tags: ["FX"]
---

# Execute FX

`POST /api/service/fx/execute`

Execute a standalone foreign exchange transaction.

## Headers

- `Idempotency-Key` string

## Request body

- ExecuteFxDto
  - `idempotencyKey` string — Deprecated: use the Idempotency-Key request header instead.
  - `sourceAmount` string, required — The amount of source currency to convert. Minimum: 10
  - `sourceAccountId` string, uuid, required — The source account id.
  - `targetAccountId` string, uuid, required — The target account id.
  - `metadata` object — Additional metadata.

## Response `200`

FX executed successfully

- RetrieveFxDetailsResponseDto
  - `id` string, required — The fxId attached to the transfer.
  - `rate` string, required — The exchange rate for the given currency pair.
  - `targetAmount` string — The amount of the target currency for the given source amount.
  - `sourceAmount` string — The amount of source currency to convert.
  - `sourceCurrency` 'EUR' | 'GBP' | 'USDC', required — The source currency code
  - `targetCurrency` 'EUR' | 'GBP' | 'USDC', required — The target currency code
  - `metadata` object — Additional metadata.
  - `status` 'initiated' | 'succeeded' | 'failed', required — The status of the FX transaction.

## Changes

- **2026-03-06** `d617edaf95c0` — 2 info
  - added the new optional `header` request parameter `Idempotency-Key`
  - the request property `idempotencyKey` became optional
- **2025-12-19** `6684bba094a6` — 2 breaking, 2 warning
  - added the new required request property `sourceAccountId`
  - added the new required request property `targetAccountId`
  - removed the request property `sourceCurrency`
  - removed the request property `targetCurrency`
- **2025-11-27** `34598bdff304` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/augustus/apis/ivy-api/changes/api/service/fx/execute/post.md)

---

[API](https://skmtc.dev/augustus/apis/ivy-api.md) · [All operations](https://skmtc.dev/augustus/apis/ivy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/augustus/ivy-api/revisions/c3055fc06ca3/schema)