Execute Trade

POST /fx-rate-api/partner/fx/trade

The Execute Trade endpoint is used to initiate a foreign exchange trade on behalf of a partner, allowing them to execute a trade with a quote previously obtained from the rate api. A partner would call this endpoint when they wish to confirm and execute a trade, providing the external reference and quote ID obtained from the rate api. The endpoint returns the trade data, including the status and any relevant messages.

Request body

Field	Type	Description
externalReference required	string	—
quoteId required	string	—

Response 200

Field	Type	Description
success	boolean	—
externalReference	string	—
tradeData	object	—
status	string	—
message	string	—
systemReference	string	—
fixedSide	string	—
sourceCurrency	string	—
sourceAmount	number	—
targetCurrency	string	—
targetAmount	number	—
quoteId	string	—
rate	number	—
valueDate	string	—

Environment

Request

curl -X POST "https://api.dev.cslpay.io/fx-rate-api/partner/fx/trade" \
  -H "Authorization: Bearer <access-token>" \
  -H "Content-Type: application/json" \
  -d '{
  "externalReference": "string",
  "quoteId": "string"
}'

OkHttpClient client = new OkHttpClient();

String payload = """
    {
      "externalReference": "string",
      "quoteId": "string"
    }
""";

RequestBody body = RequestBody.create(
        payload, MediaType.get("application/json"));

Request request = new Request.Builder()
        .url("https://api.dev.cslpay.io/fx-rate-api/partner/fx/trade")
        .post(body)
        .addHeader("Authorization", "Bearer <access-token>")
        .addHeader("Content-Type", "application/json")
        .build();

try (Response response = client.newCall(request).execute()) {
    if (!response.isSuccessful()) {
        throw new IOException("Unexpected status " + response.code());
    }
    System.out.println(response.body().string());
}

const response = await fetch("https://api.dev.cslpay.io/fx-rate-api/partner/fx/trade", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <access-token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "externalReference": "string",
    "quoteId": "string"
  })
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://api.dev.cslpay.io/fx-rate-api/partner/fx/trade",
    headers={
        "Authorization": "Bearer <access-token>",
        "Content-Type": "application/json"
    },
    json={
      "externalReference": "string",
      "quoteId": "string"
    },
)

response.raise_for_status()
print(response.json())

Response

200OK

{
  "success": true,
  "externalReference": "string",
  "tradeData": {
    "status": "string",
    "message": "string",
    "systemReference": "string",
    "fixedSide": "string",
    "sourceCurrency": "string",
    "sourceAmount": 0,
    "targetCurrency": "string",
    "targetAmount": 0,
    "quoteId": "string",
    "rate": 0,
    "valueDate": "2026-01-15"
  }
}

Authorization

Authorization: Bearer <access-token>

Sent on every request. See Getting started.