Error Messages

If the Totle API is unable to handle your request, it will respond with the appropriate response code and error message.

Error
Error Code
Error Message
Additional Information
MissingRequiredParameterError
1101
Request parameter PARAMETER NAME is missing.
​
IncorrectFormatError
1102
Request input in incorrect format.
Based on scenario, the error may be due to: the request exchange list isn't formatted correctly; the request includes both swap and swaps objects; swaps isn't formatted as an array; the request includes both source and destination amounts; the request sets strictDestination with sourceAmount
UnknownParameterError
1103
Request parameter NAME is not recognized
​
AmountError
1201
Swap amounts must be greater than 0.
​
InvalidAddressError
1202
The wallet address ADDRESS format is invalid.
​
TokenNotFoundError
1203
This token contract ADDRESS is not found.
​
InvalidSlippagePercentError
1204
The maximum MARKET/EXECUTION slippage must be between 0-99.
Make sure your request is formatted properly with values that fall in the specified range.
InvalidFillPercentError
1205
Minimum fill percent must be between 1-100.
Use minimum fill to specify the quantity of tokens you need guaranteed during transaction execution.
IsOptionalError
1206
Is optional must be boolean (true or false).
This boolean controls whether or not the order can be skipped. This could be helpful when you have an array of orders that you would like to submit through Totle, and you don’t want the entire set of swaps to fail from one failed swap. 
PartnerContractAddressNotRegisteredError
1301
This partner contract address ADDRESS is not registered.
To learn more about deploying partner contracts and how to earn and claim fees, please see our fees section.
ExecutionError
2000
An internal error occurred while finding suggestions.
​
NotEnoughVolumeError
2100
We couldn’t find enough orders to fill your request for SOURCE SYMBOL => DESTINATION SYMBOL. Please try again later.
​
NoUsableExchangeError
2102
No exchange from the list EXCHANGES is usable.
​
TokenNotTradableError
2103
TOKEN NAME - TOKEN ADDRESS is not tradable.
​
SourceAmountGreaterThanMaxError
2104
Required source amount for swap is greater than the requested max.
​
InsufficientFundsError
3100
User wallet has insufficient funds. 
​

API Response

Operational Details

Last modified 2yr ago

Error	Error Code	Error Message	Additional Information
MissingRequiredParameterError	1101	Request parameter PARAMETER NAME is missing.
IncorrectFormatError	1102	Request input in incorrect format.	Based on scenario, the error may be due to: the request exchange list isn't formatted correctly; the request includes both `swap` and `swaps` objects; `swaps` isn't formatted as an array; the request includes both source and destination amounts; the request sets `strictDestination` with `sourceAmount`
UnknownParameterError	1103	Request parameter NAME is not recognized
AmountError	1201	Swap amounts must be greater than 0.
InvalidAddressError	1202	The wallet address ADDRESS format is invalid.
TokenNotFoundError	1203	This token contract ADDRESS is not found.
InvalidSlippagePercentError	1204	The maximum MARKET/EXECUTION slippage must be between 0-99.	Make sure your request is formatted properly with values that fall in the specified range.
InvalidFillPercentError	1205	Minimum fill percent must be between 1-100.	Use minimum fill to specify the quantity of tokens you need guaranteed during transaction execution.
IsOptionalError	1206	Is optional must be boolean (true or false).	This boolean controls whether or not the order can be skipped. This could be helpful when you have an array of orders that you would like to submit through Totle, and you don’t want the entire set of swaps to fail from one failed swap.
PartnerContractAddressNotRegisteredError	1301	This partner contract address ADDRESS is not registered.	To learn more about deploying partner contracts and how to earn and claim fees, please see our fees section.
ExecutionError	2000	An internal error occurred while finding suggestions.
NotEnoughVolumeError	2100	We couldn’t find enough orders to fill your request for SOURCE SYMBOL => DESTINATION SYMBOL. Please try again later.
NoUsableExchangeError	2102	No exchange from the list EXCHANGES is usable.
TokenNotTradableError	2103	TOKEN NAME - TOKEN ADDRESS is not tradable.
SourceAmountGreaterThanMaxError	2104	Required source amount for swap is greater than the requested max.
InsufficientFundsError	3100	User wallet has insufficient funds.