Book a Trade

The Trade API allows you to book foreign exchange (FX) trades using a valid quoteId. Upon successful booking, you will receive a trade confirmation with details such as currencies, amounts, rates, fees, and a unique fxId for future reference.

Request

To book an FX trade, send a POST request with a valid quoteId in the request body.

Request Body:

• Required Fields:
  • quoteId: The unique identifier for the quote you wish to book.
• Optional Fields
  • sellAmount: The amount of the sell currency you are trading.
  • buyAmount: The amount of the buy currency you want to receive.
  • clientReference: Your external identifier to track each trade.
  • doddFrank: To specify if the trade is a Dodd-Frank payment. We can payments up to 30 mins before releasing if they are flagged as Dodd-Frank payments during trade booking. This helps you meet Dodd-Frank cancellation requirements within the first 30 mins of trade booking. Contact us if you'd like to discuss this further.

{
"quoteId": "9165eeca-beef-4973-b3b9-7f244a300c5f"
}

{
  "quoteId": "96ce6ac3-aa60-4bb8-9de5-17ccfc3af411",
  "sellAmount": 250
}

Response

A successful response will include details about the booked trade.

{
    "isSuccess": true,
    "buyAmount": 284.4,
    "sellAmount": 250,
    "buyCurrency": "EUR",
    "sellCurrency": "GBP",
    "tradeStatus": "PENDINGINSTRUCTION",
    "rate": 0.879,
    "tradeDate": "2025-11-28",
    "quoteId": "2be2c45b-b48b-4bdf-8566-a58fe61756d4",
    "fxId": 7004009,
    "fee": 0
}

Fields:

• isSuccess: Indicates whether the trade booking was successful (true or false).
• buyAmount: The amount of the buy currency.
• sellAmount: The amount of the sell currency.
• buyCurrency: ISO currency code for the buy currency.
• sellCurrency: ISO currency code for the sell currency.
• tradeStatus: The current status of the trade (ex- PENDINGINSTRUCTION). Use the Get Status endpoint to check the latest status of your trades.
• rate: The rate applied to the trade.
• tradeDate: The date when the trade was booked.
• quoteId: contains the quoteId used for booking.
• fxId: StoneX's unique identifier for the booked trade, used for future reference.
• fee: If any fee was charged for the trade booking (for example - same currency fee)

Usage

• Prepare Request: Include a valid quoteId in the request body.
• Send Request: Make a POST request to the trade booking endpoint.
• Track Trade: Use the fxId from the response to track the status of the booked trade.

Notes

• Quote Validity: Ensure the quoteId is valid and has not expired.
• Trade Status: Use the Get Status endpoint to monitor the status of your trade after you've booked it.