Skip to content
API reference/REST API/
/
Amend trade

Amend trade

Request

Amend a verified trade by amount, rate, customer, or all three. Available to broker users and sales dealer users.

You must specify at least one property in addition to id.

Work with your Integral Customer Engineer to configure the following trade amendment restrictions:

  • Number of minutes during which a trade is eligible for amendment after verification.
  • Total number of price amend requests allowed for a trade. Each request to change a rate property (spotRate, forwardPoints) counts against the total allowed.
  • Maximum amount a trade can be amended expressed as a percentage of the trade’s size. If you specify dealtAmount, the value must be greater than zero and less than this maximum.
Security
SSO_TOKEN
Bodyapplication/json
idstring, [ 5 .. 30 ] charactersrequired

ID of the verified trade to amend.

dealtAmountnumber, (double), >= 0.01

New amount of the dealt instrument. Must be greater than zero and less than the maximum percentage change allowed, if configured.

customerAccountstring, [ 1 .. 30 ] characters

New customer’s legal entity ID.

forwardPointsnumber, (double)

New forward points for a forward or NDF trade.

spotRatenumber, (double)

New spot rate of the trade. Must be greater than zero.

notestring, <= 255 characters

Any notes on the trade. These notes are sent via STP if the trade is eligible for STP (stp=true).

Amend a trade by customer, rate, and amount.

{
  "id": "FXI9271593184",
  "spotRate": 1.18631,
  "dealtAmount": 21000,
  "customerAccount": "BrokerCustOrg1le1",
  "forwardPoints": 0.0001,
  "note": "Sales: done after cover"
}

Responses

The ID of the amended trade.

Bodyapplication/json
originalTradeIdstring, [ 5 .. 30 ] characters

ID of the original trade that was amended.

tradeIdstring, [ 5 .. 30 ] characters

ID of the new trade.

createdTimestring, <= 32 characters

Date and time (GMT) the trade was booked in the format yyyy-MM-dd HH:mm:ss,SSS Z.

Response
{
  "originalTradeId": "string",
  "tradeId": "string",
  "createdTime": "string"
}