In this guide, we’ve prepared the information about the errors you might encounter while working with the SimpleSwap API.
Currency
The GET/v3/currencies/{ticker}/{network} command gives you information about a particular currency.
Possible errors:
400 – Request parameters are not valid. One or several entered parameters are incorrect, missing, or in an improper format. For example, you might have provided an empty value for the API key parameter. Make sure you have entered the correct data.
401 – Wrong API key. This error signals a problem with the authorization with the API key provided in the request: the API key is either missing, expired, or does not match a valid key associated with your account. Please check if you entered the API key correctly (e.g. abcdef12-3456-7890-abcd-ef1234567890).
404 – Ticker not found. This means that the ticker you entered in your request is not recognized or does not exist in SimpleSwap's database. Please double-check its spelling.
The GET/v3/currencies command provides you with a list of all supported currencies.
Possible errors:
400 – Request parameters are not valid. One or several entered parameters are incorrect, missing, or in an improper format. For example, you might have provided an empty value for the API key parameter. Make sure you have entered the correct data.
401 – Wrong API key. This error indicates a problem with the authorization with the API key provided in the request: the API key is either missing, expired, or does not match a valid key associated with your account. Please check if you entered the API key correctly (e.g. abcdef12-3456-7890-abcd-ef1234567890).
Pairs
The GET/v3/pairs/{ticker}/{network} command returns all active pairs with a specified currency.
Possible errors:
400 – Request parameters are not valid. One or several entered parameters are incorrect, missing, or in an improper format. For instance, you might have provided an empty value for the API key parameter. Make sure you have entered the correct data.
401 – This error indicates a problem with the authorization with the API key provided in the request: the API key is either missing, expired, or does not match a valid key associated with your account. Please check if you entered the API key correctly (e.g. abcdef12-3456-7890-abcd-ef1234567890).
404 – Ticker not found. This means that the ticker you entered in your request is not recognized or does not exist in SimpleSwap's database. Please double-check its spelling.
The GET/v3/pairs gives you a list of all active exchange pairs. You can pass "true" for the “fixed” parameter if you want to see the fixed-rate pairs and “false” if you are interested in floating-rate pairs.
Possible errors:
400 – Request parameters are not valid. One or several entered parameters are incorrect, missing, or in an improper format. For instance, you might have provided an empty value for the API key parameter. Make sure you have entered the correct data.
401 – Wrong API key. This error indicates a problem with the authorization with the API key provided in the request: the API key is either missing, expired, or does not match a valid key associated with your account. Please check if you entered the API key correctly (e.g. abcdef12-3456-7890-abcd-ef1234567890).
Estimates
The GET/v3/estimates command gives you the information about an estimated exchange amount. Pass “true” for the “fixed” parameter to request fixed-rate pairs and “false” for floating-rate pairs.
Possible errors:
400 – Request parameters are not valid. One or several entered parameters are incorrect, missing, or in an improper format. For instance, you might have provided an empty value for the API key parameter. Make sure you have entered the correct data.
401 – Wrong API key. This error indicates a problem with the authorization with the API key provided in the request: the API key is either missing, expired, or does not match a valid key associated with your account. Please check if you entered the API key correctly (e.g. abcdef12-3456-7890-abcd-ef1234567890).
404 – Pair not found. The specified trading pair does not exist or is not supported by the API. Please make sure you have typed the tickers correctly, and that the trading pair is available.
422 – Amount is out of range. The amount you provided in the “amount” parameter is either too high or too low, exceeding the acceptable limits set by the API. You can check the available range using the GET/v3/ranges command.
Ranges
The GET/v3/ranges command gives you the information about the smallest and largest (if applicable) amount for the exchange between selected currencies. Pass “true” for the “fixed” parameter to request fixed rate and “false” for floating rate.
Possible errors:
400 – Request parameters are not valid. One or several entered parameters are incorrect, missing, or in an improper format. For instance, you might have provided an empty value for the API key parameter. Make sure you have entered the correct data.
401 – Wrong API key. This error indicates a problem with the authorization with the API key provided in the request: the API key is either missing, expired, or does not match a valid key associated with your account. Please check if you entered the API key correctly (e.g. abcdef12-3456-7890-abcd-ef1234567890).
404 – Pair not found. The specified trading pair does not exist or is not supported by the API. Please make sure you have typed the tickers correctly, and that the trading pair is available.
Exchange
The GET/v3/exchanges/check command is used to see if it is possible to create an exchange with the given parameters. Set the “fixed” parameter “true” to request fixed-rate pairs and “false” to see floating-rate pairs. If the exchange is possible, the response will return “true.”
Possible errors:
400 – Request parameters are not valid. One or several entered parameters are incorrect, missing, or in an improper format. For instance, you might have provided an empty value for the API key parameter. Make sure you have entered the correct data for all required parameters.
401 – Wrong API key. This error indicates a problem with the authorization with the API key provided in the request: the API key is either missing, expired, or does not match a valid key associated with your account. Please check if you entered the API key correctly (e.g. abcdef12-3456-7890-abcd-ef1234567890).
404 – Pair not found. The specified trading pair does not exist or is not supported by the API. Please make sure you have typed the tickers correctly, and that the trading pair is available.
422 – Amount is out of range. The amount you provided in the “amount” parameter is either too high or too low, exceeding the acceptable limits set by the API. You can check the available range using the GET/v3/ranges command.
The GET/v3/exchanges/{publicId} command provides detailed information about a specific exchange, including the currencies, current status, and other relevant information.
Possible errors:
400 – Request parameters are not valid. One or several entered parameters are incorrect, missing, or in an improper format. For instance, you might have provided an empty value for the API key parameter. Make sure you have entered the correct data.
401 – Wrong API key. This error indicates a problem with the authorization with the API key provided in the request: the API key is either missing, expired, or does not match a valid key associated with your account. Please check if you entered the API key correctly (e.g. abcdef12-3456-7890-abcd-ef1234567890).
404 – Exchange not found. The ID of the requested exchange is incorrect. Please ensure that you are using the correct one.
The GET/v3/exchanges command provides a list of exchanges created with the API key.
Possible errors:
400 – Request parameters are not valid. One or several entered parameters are incorrect, missing, or in an improper format. With this command, the specified limit for transactions can be between 0 and 1000, and the date format for choosing the period for display must be ISO 8601. ('2000-01-01' or '2000-01-01T00:00:00Z'). For example, 2023-05-26T10:26:57.079Z. Please double-check the entered data.
401 – Wrong API key. This error indicates a problem with the authorization with the API key provided in the request: the API key is either missing, expired, or does not match a valid key associated with your account. Please check if you entered the API key correctly (e.g. abcdef12-3456-7890-abcd-ef1234567890).
The POST/v3/exchanges command creates a new exchange. Note that in case of creating a fiat exchange, the server response will contain a redirect_url field. It is necessary for the client to follow this link to complete the exchange.
Possible errors:
400 – Request parameters are not valid. One or several entered parameters are incorrect, missing, or in an improper format. For instance, you might have provided an empty value for the API key parameter. Make sure you have entered the correct data.
401 – Wrong API key. This error indicates a problem with the authorization with the API key provided in the request: the API key is either missing, expired, or does not match a valid key associated with your account. Please check if you entered the API key correctly (e.g. abcdef12-3456-7890-abcd-ef1234567890).
404 – Pair not found. The specified trading pair does not exist or is not supported by the API. Please make sure you have typed the tickers correctly, and that the trading pair is available.
422 – Amount is out of range. The amount you provided in the “amount” parameter is either too high or too low, exceeding the acceptable limits set by the API. You can check the available range using the GET/v3/ranges command.
If you have followed the advice listed above but the problem persists, please contact our support team.
Share on: