Reverse a trade

const url = 'https://api.openfx.com/v3/fx/trades/{id}/reverse';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'X-Request-Signature': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({quoteId: 'qte_TmHeAhdFLes63uGgDjcJRx'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.openfx.com/v3/fx/trades/{id}/reverse"

payload = { "quoteId": "qte_TmHeAhdFLes63uGgDjcJRx" }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "X-Request-Signature": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

HttpResponse<String> response = Unirest.post("https://api.openfx.com/v3/fx/trades/{id}/reverse")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("X-Request-Signature", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"quoteId\": \"qte_TmHeAhdFLes63uGgDjcJRx\"\n}")
  .asString();

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.openfx.com/v3/fx/trades/{id}/reverse");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Idempotency-Key: <idempotency-key>");
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "X-Request-Signature: <api-key>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\n  \"quoteId\": \"qte_TmHeAhdFLes63uGgDjcJRx\"\n}");

CURLcode ret = curl_easy_perform(hnd);

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.openfx.com/v3/fx/trades/{id}/reverse"

	payload := strings.NewReader("{\n  \"quoteId\": \"qte_TmHeAhdFLes63uGgDjcJRx\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Request-Signature", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

curl --request POST \
  --url https://api.openfx.com/v3/fx/trades/{id}/reverse \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-Request-Signature: <api-key>' \
  --data '
{
  "quoteId": "qte_TmHeAhdFLes63uGgDjcJRx"
}
'

{
  "data": {
    "object": "trade",
    "id": "tde_8XvH7fKH8hcFyopFF2PFas",
    "quoteId": "qte_TmHeAhdFLes63uGgDjcJRx",
    "buyCurrency": "USD",
    "sellCurrency": "USDC",
    "executedAmount": "999.25",
    "status": "EXECUTED",
    "clientReferenceId": "order-123-reversal",
    "createdAt": "2026-07-13T10:00:00.000Z",
    "settlementWindow": "T0",
    "settlementStartTime": null,
    "originalTradeId": "tde_5W7guYdHT24JFnRQrZN9y8",
    "reversalDetails": {
      "direction": "CREDIT",
      "differentialAmount": "0.75",
      "currency": "USD"
    }
  }
}

POST

trades

{id}

reverse

Reverse a trade

const url = 'https://api.openfx.com/v3/fx/trades/{id}/reverse';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'X-Request-Signature': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({quoteId: 'qte_TmHeAhdFLes63uGgDjcJRx'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.openfx.com/v3/fx/trades/{id}/reverse"

payload = { "quoteId": "qte_TmHeAhdFLes63uGgDjcJRx" }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "X-Request-Signature": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

HttpResponse<String> response = Unirest.post("https://api.openfx.com/v3/fx/trades/{id}/reverse")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("X-Request-Signature", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"quoteId\": \"qte_TmHeAhdFLes63uGgDjcJRx\"\n}")
  .asString();

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.openfx.com/v3/fx/trades/{id}/reverse");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Idempotency-Key: <idempotency-key>");
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
headers = curl_slist_append(headers, "X-Request-Signature: <api-key>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\n  \"quoteId\": \"qte_TmHeAhdFLes63uGgDjcJRx\"\n}");

CURLcode ret = curl_easy_perform(hnd);

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.openfx.com/v3/fx/trades/{id}/reverse"

	payload := strings.NewReader("{\n  \"quoteId\": \"qte_TmHeAhdFLes63uGgDjcJRx\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Request-Signature", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

curl --request POST \
  --url https://api.openfx.com/v3/fx/trades/{id}/reverse \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-Request-Signature: <api-key>' \
  --data '
{
  "quoteId": "qte_TmHeAhdFLes63uGgDjcJRx"
}
'

{
  "data": {
    "object": "trade",
    "id": "tde_8XvH7fKH8hcFyopFF2PFas",
    "quoteId": "qte_TmHeAhdFLes63uGgDjcJRx",
    "buyCurrency": "USD",
    "sellCurrency": "USDC",
    "executedAmount": "999.25",
    "status": "EXECUTED",
    "clientReferenceId": "order-123-reversal",
    "createdAt": "2026-07-13T10:00:00.000Z",
    "settlementWindow": "T0",
    "settlementStartTime": null,
    "originalTradeId": "tde_5W7guYdHT24JFnRQrZN9y8",
    "reversalDetails": {
      "direction": "CREDIT",
      "differentialAmount": "0.75",
      "currency": "USD"
    }
  }
}

Authorizations

Authorization

string

header

required

ES256-signed JWT bearer token, single-use, 60-second TTL. See Authentication for how to mint one.

X-Request-Signature

string

header

required

ES256 signature over the request, bound to the bearer JWT. Required on every v3 request. See Authentication → Request signing.

Headers

Idempotency-Key

string

required

Client-generated unique key to make a write operation safely retryable. UUID v4 recommended. See Idempotency.

Required string length: 1 - 255

Pattern: ^[a-zA-Z0-9_-]{1,255}$

Example:

"550e8400-e29b-41d4-a716-446655440000"

X-Request-Id

string

Optional, client-supplied correlation ID for this request. Echoed verbatim on the response when supplied; the response omits it when the request did not supply one. Distinct from X-Trace-Id (server-generated, always present). See Metadata & tracing.

Example:

"my-req-abc-123"

Path Parameters

string

required

Unique identifier of the trade to reverse. Accepts either the current readable, typed-prefix ID (see ResourceId) or a legacy bare UUID v4, for backward compatibility with IDs persisted before v3 introduced readable IDs. Both forms resolve to the same underlying record. Responses always return the readable form — see Resource IDs.

Pattern: ^([a-z]{3,5}_[1-9A-HJ-NP-Za-km-z]{1,22}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$

Example:

"tde_5W7guYdHT24JFnRQrZN9y8"

Body

application/json

Executes a reversal of the trade in the path against an approved reverse quote.

quoteId

string

required

ID of the reversal quote to execute the reversal against.

Pattern: ^([a-z]{3,5}_[1-9A-HJ-NP-Za-km-z]{1,22}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$

Example:

"qte_TmHeAhdFLes63uGgDjcJRx"

clientReferenceId

string

Optional client-supplied reference for the reversal.

Example:

"order-123-reversal"

Response

Reverse a trade.

data

object

required

A trade reversal is itself a Trade — created by POST /v3/fx/trades/{id}/reverse against a reverse quote — with two additional fields: originalTradeId (the trade it unwinds) and reversalDetails (the differential applied).

Show child attributes

⌘I

Trade

Trade Settlement

Exposure

Reverse a trade

Authorizations

Headers

Path Parameters

Body

Response