---
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.

---

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