Retrieve trades which are eligible for drawdowns, submit drawdown requests, process payments, and get a detailed view of your trades and associated drawdowns.

Get all open positions

To find the open positions that are eligible to drawdown from, you will first need to retrieve all your trades using the GET/v1/fx/trades endpoint.

The endpoint returns all trades. You will need to refine your query by using the following parameters to ensure you will get trades which are drawdown eligible.

Use the following query parameters to filter out what trades you can drawdown from:

Trade Type:

Must be forward to be able to drawdown.

Trade Subtypes:

Open: You will be able to drawdown anytime between the trade date and value date.

Window & Variable: You will be able to drawdown only between the access date (agreed with your dealer) and the value date.

Fixed: You will only be able to drawdown on the value date.



---

Check individual trade details

Once you have retrieved your open positions, you will need to select the trade you wish to drawdown from.

Ensure the trade is open (the value date has not passed) and check the AccessDate to see when you can start to drawdown from.

To get this information, use the GET /v1/fx/trades/forwards/tradeID

This endpoint will provide additional information on the individual trade, such as the 'balance' remaining on the trade. The balance remaining on the trade will inform you the amount that is still available to drawdown.

---

Make a drawdown request

Now that you have selected the trade to drawdown from, you can proceed to place a drawdown request, using the POST/v1/fx/trades/forwards/drawdowns endpoint.

The following parameters are required to be included in your drawdown request.

TradeID:

The trade you want to draw down from.

BuyCurrency or SellCurrency:

Fix the amount for your drawdown in either the sell or the buy currency. Regardless of the side the amount is fixed in, the drawdown and subsequent payment will be in the Buy currency.

Amount
The amount cannot exceed the balance left on the trade

ValueDate

The value date must be within the accessDate and the valueDate of the forward trade

FundingMethod

You can choose where to fund the drawdown via Currency Account balance or Wire Transfer.

PaymentInstructions:

Should you want to send the funds directly to a beneficiary, you will need to include a payment instruction. You can either use an existing beneficiaryID or create a new beneficiary in the payment instruction object.

To ensure the payment instructions are correct and STP is achieved, you can validate your beneficiary and payment details using POST /v1/payments/validation before submitting.

If you do not provide payments totalling the full amount, we will credit the drawdown remaining amount to your default currency account.

---

Retrieve drawdown information

To retrieve all drawdown information against a trade, you will be able to use the GET /v1/fx/trades/forwards/tradeID/drawdowns endpoint.

You will be able to see all the drawdowns you have made on a specific forward trade, check how much balance you still have available on the trade and view how much margin will be released following the successful drawdown.