Which API should I use?

  • Use v20 REST API only if you have a v20 account
  • Use v1 REST API if your account id contains only digits (ie. 2534253) as it is a legacy account

Troubleshooting & Errors


Common HTTP Error Responses

Following are common HTTP Error Responses that may be returned from the v20 REST API when an error occurs.

400 Bad Request

A “400 Bad Request” reponse may be returned from the v20 REST API when the client has provided invalid data to be processed.

Malformed Request

If an incorrect request is submitted the following error will be returned to the user.

"errorMessage" : "The request was missing required data"

Reason: One or more required parameters for the request is missing or is invalid.

Invalid Instrument

If an incorrect currency is submitted the following error will be returned to the user.

"errorMessage":"Invalid value specified for 'instrument'"

Reason: The Currency provided is invalid. Confirm the structure of currency is correct.

Invalid Precission

If an incorrect value is submitted the following error will be returned to the user.

"rejectReason":" STOP_LOSS_ON_FILL_PRICE_PRECISION_EXCEEDED"

Reason: The error message “STOP_LOSS_ON_FILL_PRICE_PRECISION_EXCEEDED” means that The Stop Loss on fill specifies a price with more precision than is allowed by the Order’s instrument. Confirm the value provided for price is a string.

401 Unauthorized

A “401 Unauthorized” reponse may be returned from the v20 REST API when the endpoint being accessed requires the client to be authenticated however the authentication token is invalid or has not been provided.

Invalid AccountID

If an incorrect accountID is submitted the following error will be returned to the user.

"errorMessage":"The provided request was forbidden."

Reason: The given accountID is invalid. Confirm the accountID is correct.

Insufficient Authorization

If an incorrect request is submitted the following error will be returned to the user.

"errorMessage":"Insufficient authorization to perform request."

Reason: The endpoint being accessed requires the client to be authenticated. The following information needs to be verified:

1.The subdomain / URL for the request is correct. Click here to learn how to configure curl examples that can be copied without further modification.

2.The authentication token is valid and has been added as a Bearer token in the HTTP Authorization header.

403 Forbidden

A “403 Forbidden” response may be returned from the v20 REST API when the client has provided a token that does not authorize them to perform the action implemented by the API endpoint.

Account Not Tradable

If an incorrect request is submitted the following error will be returned to the user.

"errorMessage":"Insufficient authorization to perform request."

Reason: The account specified can not be used for trading. Please contact OANDA support for more details

404 Not Found

A “404 Not Found” response may be returned from the v20 REST API when the client is attempting to refer to an entity (Account, Trade, Order, Position, etc.) that does not exist.

NO_SUCH_TRADE

If an incorrect trade ID is submitted the following error will be returned to the user.

"errorMessage":"The trade ID specified does not exist"

Reason: The trade id specified is not valid. The /trade returns recent trade and it is possible that the trade being referenced is no longer in the recent trade list.

NO_SUCH_TRANSACTION

If an incorrect transaction ID is submitted the following error will be returned to the user.

"errorMessage":"The transaction ID specified does not exist"

Reason: The transaction id specified is not valid. The /transactions returns recent transactions and it is possible that the transaction being referenced is no longer in the recent transactions list.

NO_SUCH_ORDER

If an incorrect order ID is submitted the following error will be returned to the user.

"errorMessage":"The order ID specified does not exist"

Reason: The order id specified is not valid. The /orders returns recent transactions and it is possible that the order being referenced is no longer in the recent order list.