Below is the list of error codes you may come across while using our endpoints. In case if you see any new error please reach out to your account manager for more information.
| HTTP Status Code | Error Code | Error Description | Recommended handling |
|---|---|---|---|
| 200 | None | Success | |
| 201 | None | Created | 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. | |
| 400 | TRD09999 | 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' |
| 400 | TRD00003 | Invalid Currency Code | Check the currency code in the request and retry with a valid ISO currency code |
| 400 | TRD00004 | Inactive Currency Code | Contact your account manager to discuss your currency requirement |
| 400 | TRD00005 | Currency not configured | This currency is not set up on your account. Contact your account manager to discuss. |
| 400 | TRD00006 | Quote request should have one of buy amount or sell amount | 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. |
| 400 | TRD00010 | [Buy/Sell] amount cannot be 0 | This happens when either buyAmountt or sellAmount is provided as 0. This can be resolved by changing amount to required amount. |
| 400 | TRD00011 | Configuration missing | This will only happen when the quote cannot be priced as we have not set up your pricing configuration in our system. Please contact our customer support to set up pricing if this happens. |
| 400 | TRD00012 | Trade Amount [Ccy] [Amount] is above trading limit [Ccy][Amount] | This happens when you try to get a quote for amount higher than permissible limit set for individual transaction |
| 400 | 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. |
| 400 | TRD00015 | The minimum trade amount for [Ccy] is [Amount] | This occurs if you request a quote for an amount which is less than the minimum supported for that buy or sell currency |
| 400 | TRD19999 | 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' |
| 400 | TRD10000 | Invalid Quote Id | This occurs when you try to book trade with a Quote Id that's not a valid Quote Id |
| 400 | TRD10001 | Quote Id expired | This happens when you book a trade with a Quote Id that has expired. Request a new Quote Id & try again. |
| 400 | TRD10005 | Price should be within [5%] of base rate | An unlikely scenario where price has moved by more than [5%] between quote and trade booking |
| 400 | TRD10009 | Trade already booked with Quote [Quote ID] | This is returned when you try to call the Trade booking API with a Quote ID that's already been booked. |
| 400 | TRD10010 | 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. |
| 400 | 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 |
| 400 | 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 |
| 400 | TRD90004 | Trade could not be cancelled | This will occur if we are not able to process your cancellation request |
| 400 | INS00001 | Trade cannot be found | This happens when you try to instruct payments with an invalid fxid . Try again with a valid fxId |
| 400 | 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 |
| 400 | 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 |
| 400 | 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 |
| 400 | 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 |
| 400 | 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 |
| 400 | 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. |