Trade a Quote and Close The Deal

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

quoteIdrequired string

Unique identifier for the FX quote
clientReferencerequired string

Client-provided reference for the trade

Response 200

tradeReference string

Unique identifier for the trade
clientReference string

Client-provided reference for the trade
quoteId string

Identifier for the FX quote
buyCurrency string

Currency of the buy amount
buyAmount number

Amount to be bought
sellCurrency string

Currency of the sell amount
sellAmount number

Amount to be sold
rate number

FX rate applied to the trade
bookingTime string

Time at which the trade was booked
bookingSource string

Source of the trade booking

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 '{
  "quoteId": "string",
  "clientReference": "string"
}'

OkHttpClient client = new OkHttpClient();

String payload = """
    {
      "quoteId": "string",
      "clientReference": "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({
    "quoteId": "string",
    "clientReference": "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={
      "quoteId": "string",
      "clientReference": "string"
    },
)

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

Response

200OK

{
  "tradeReference": "string",
  "clientReference": "string",
  "quoteId": "string",
  "buyCurrency": "string",
  "buyAmount": 0,
  "sellCurrency": "string",
  "sellAmount": 0,
  "rate": 0,
  "bookingTime": "2026-01-15T09:30:00Z",
  "bookingSource": "FX_API"
}

Authorization

Authorization: Bearer <access-token>

Sent on every request. See Getting Started.

Try it

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

Requests go to your test environment only. Nothing here reaches production, and your token is forwarded once and never stored.

Environment Request URL

POST

Authorization

Sent with this request only and never stored. Use a test credential — if a proxy in front of this site blocks POST, the request is retried as an encoded URL, which edge logs can capture. Get one from Getting Started.

Request Body

JSON. Edited here, not saved.

Response

Response headers