We will return a 201 after a successful POST where a resource was created.
202
None
Accepted
Requested accepted for processing but has not been finished yet. For example when you submit a Cancel Request for a trade.
400
None
Bad Request
The request contains invalid data. Check the request for invalid data before resubmitting the request.
401
None
Unauthorized
Unauthorized. You have not included a valid Access token. It may have expired or you entered incorrect credentials.
404
None
Resource not found
408
None
Request Timeout
429
None
Exceeded Rate Limit
503
None
Server not available or under maintenance.
500
TRD00003
Invalid Currency Code
Check the currency code in the request and retry with a valid ISO currency code
500
TRD00004
Currency Code is available but inactive
Contact your account manager to discuss your currency requirement
500
TRD00005
Currency not configured
This currency is not set up on your account. Contact your account manager to discuss.
500
TRD00006
Amount cannot be zero
This is returned when you don't provide either buyAmount or sellAmount when requesting a Quote Retry with a non-zero amount in one of these fields.
500
TRD00008
Unable to price
This happens when we are unable to price a quote. Please show an error and retry. If error persists, you can display a holding message such as 'Service Unavailable'
500
TRD00011
Invalid Quote Id
This happens when you try to book a trade with a quoteId which is not valid. Try again with a valid quoteId.
500
TRD00012
Quote Id expired
This happens when the quoteId has expired. Try again with a valid Quote Id
500
TRD00014
Request should have either buy or sell amount not both
Try submitting the Rate/Trade request with only one of Buy or Sell amount.
500
TRD00021
Unable to book trade
This happens when we are unable to book a trade. Please show an error and retry. If error persists, you can display a holding message such as 'Service Unavailable'
500
TRD00023
Same currency trade not allowed
This usually happens when your account has not been set up for same currency trades. Contact your account manager to discuss setting this up.
500
TRD90002
Request already under progress
This happens when you try to cancel a trade that's already been requested for cancellation. Call the Status API to check the latest status of the trade
500
TRD90003
Trade has already been cancelled
This happens when you try to cancel a trade that's already cancelled. You can check the latest trade status by calling the Status API
500
TRD90004
Trade could not be cancelled
This will occur if we are not able to process your cancellation request
500
INS00001
fxId is not valid
This happens when you try to instruct payments with an fxid that is not valid. Try again with a valid fxId
500
INS00002
Same Currency Payments cannot contain fxId in request
This happens when you try to instruct payments for same currency (Buy and Sell Currency are spot) with an fxid
500
INS00003
Buy and Sell Currency should be same for same currency payments
This happens when you try to instruct payments for same currency but provide different CCY codes in the instruct API
500
INS00004
Buy and Sell Amounts should be same for same currency payments
This happens when you try to instruct payments for same currency but provide different Buy and Sell amounts in the instruct API
500
INS00005
fxId is already linked with instructions
This happens when you try to instruct payments with a fxId where we already have an instructed linked to that fxid
500
INS00006
Invalid BIC or IBAN
This happens when you instruct a payment with an invalid BIC or IBAN. Try again with a valid BIC or IBAN
500
WEB0001
optimistic version error
This can happen for update operations where we support optimistic locking using the optimisticVersion property: if the optimisticVersion property is in the request body and it does not match the current optimisticVersion, then the request fails with an optimistic lock error. In that case the caller should again get the latest optimisticVersion, apply the changes and try the request again.
