Link Errors
Find below the list of errors that can be displayed in Link.
General Errors
| Error Code | Likely Scenario | Displayed Error Message | Possible User Actions | Possible Developer Actions |
|---|---|---|---|---|
| 1000 | Failed to instantiate SDK IMX Client when connecting wallet | Something went wrong. | Contact the Customer Support team. | Check SDK Settings. |
| 1001 | Unable to retrieve tokens list | Something went wrong retrieving your tokens list: ${apiError} | Retry the operation/Refresh the page or Contact support team | Try to replicate the issue. |
| 1002 | Failed to retrieve the wallet address | Something went wrong when retrieving your wallet address. Check with your wallet provider. | Check wallet connection with IMX.Check wallet provider.Contact Customer Support. | Try to replicate the issue. Check console logs. |
| 1003 | Link forcibly closed by the user | Link window closed. | - | Give feedback on the Link closed to the user. |
| 1004 | Failed to open Link as iFrame due to 3rd party cookies blocked | There is no storage available. This is usually related to a 3rd party cookie-blocking policy. | Unblock the 3rd party cookies on the browser. | Give a feedback regarding 3rd party cookies to the user or change Link mode to be opened as popup. |
⛔ Obsolete |
Deposits
| Error Code | Likely Scenario | Displayed Error Message | Possible User Actions | Possible Developer Actions |
|---|---|---|---|---|
| 2000 | Failed to retrieve the wallet address | Something went wrong when retrieving your wallet address. Check with your wallet provider. | Check wallet connection with IMX.Contact Customer Support. | Try to replicate the issue. Check console logs. |
| 2001 | Provided invalid ERC20 token | Token not available in IMX. | Retry the transaction.Contact support team to report the invalid token. | Try to replicate the issue. Check console logs. |
| 2002 | Insufficient funds | Insufficient funds. | Add funds to L1 wallet. | N/A |
| 2003 | API rejected deposits | The API rejected the deposit: ${details} | Retry the operation. If it continues failing, contact the Customer Support team. | Try to replicate the issue. Check the error details. |
Complete Withdrawal
| Error Code | Likely Scenario | Displayed Error Message | Possible User Actions | Possible Developer Actions |
|---|---|---|---|---|
| 4000 | Failed to retrieve the wallet address | Something went wrong when retrieving your wallet address. Check with your wallet provider. | Check wallet connection with IMX.Check wallet provider.Contact Customer Support. | Try to replicate the issue. Check console logs. |
Buy
| Error Code | Likely Scenario | Displayed Error Message | Possible User Actions | Possible Developer Actions |
|---|---|---|---|---|
| 5000 | Failed to retrieve order details | Something went wrong.-Additional error message provided by the API. | Check wallet connection with IMX.Retry operation.If continue to fail, contact Customer Support. | Try to replicate the issue. Check console logs. |
| 5001 | Failed to retrieve asset details | Something went wrong.-Additional error message provided by the API. | Check wallet connection with IMX.Retry operation.If continue to fail, contact Customer Support. | Try to replicate the issue. Check console logs. |
| 5002 | Failed trade request | Something went wrong.-Additional error message provided by the API. | Check wallet connection with IMX.Retry operation.If continue to fail, contact Customer Support. | Try to replicate the issue. Check console logs. |
| 5003 | API rejected trades | The API rejected the purchase: ${details} | Retry the operation. If it continues failing, contact the Customer Support team. | Try to replicate the issue. Check the error details. |
| - | API rejected trades | Cannot accept order of version 3 from this API endpoint. Please upgrade to the newer API endpoints. | Contact the Customer Support team. | Upgrade to use the latest version of Order & Trade API. |
Sell
| Error Code | Likely Scenario | Displayed Error Message | Possible User Actions | Possible Developer Actions |
|---|---|---|---|---|
| 6000 | Unable to retrieve asset details | Something went wrong.-Additional details/error message provided by the API. | Retry operation.If continue to fail, contact Customer Support. | Try to replicate the issue. Check console logs. |
| 6001 | Unable to list asset for sale | Unable to list asset-Additional details/error message provided by the API. | Retry operation.Check if asset is already listed.If continue to fail, contact Customer Support. | Try to replicate the issue. Check console logs. |
| 6002 | Asset is already listed for sale | Asset is unavailable. | Retry operation.Confirm if asset is already listed.If continue to fail, contact Customer Support. | Try to replicate the issue. Check console logs. |
| 6003 | Invalid currency provided as query param | Unknown currency. | Retry operation.If continue to fail, contact Customer Support. | Confirm tokens available in IMX.Try to replicate the issue. Check console logs. |
| 6004 | Invalid asset price provided as query param | Price should be at least ${minPrice} | Retry operation with different price.If continue to fail, contact Customer Support. | N/A |
| 6005 | API rejected listings | The API rejected the listing: ${details} | Retry the operation. If it continues failing, contact the Customer Support team. | Try to replicate the issue. Check the error details. |
Transfer
| Error Code | Likely Scenario | Displayed Error Message | Possible User Actions | Possible Developer Actions |
|---|---|---|---|---|
| 7000 | Failed to retrieve transfer token details | Something went wrong retrieving token details. | Retry operation.If continue to fail, contact Customer Support. | Confirm tokens available in IMX.Try to replicate the issue. Check console logs. |
| 7001 | Failed to retrieve user token balance | Something went wrong retrieving your ${tokenType} token balance | Retry operation.If continue to fail, contact Customer Support. | Confirm tokens available in IMX.Try to replicate the issue. Check console logs. |
| 7002 | Invalid data found before starting transfer | Transfers have failed validation.The following validation errors were identified:${listOfFailedValidations} | Retry operation.If continue to fail, contact Customer Support. | Try to repliace the issue.Check error details. |
| 7003 | API rejected transfers | The API rejected the transfer: ${details} | Retry the operation. If it continues failing, contact the Customer Support team. | Try to replicate the issue. Check the error details. |
History
| Error Code | Likely Scenario | Displayed Error Message | Possible User Actions | Possible Developer Actions |
|---|---|---|---|---|
| 8000 | Failed to retrieve any transaction | Something went wrong retrieving the transactions: ${details} | Retry operation.Check wallet connection.If continue to fail, contact Customer Support. | Try to replicate the issue. Check console logs. |
Cancel
| Error Code | Likely Scenario | Displayed Error Message | Possible User Actions | Possible Developer Actions |
|---|---|---|---|---|
| 9000 | Failed to retrieve the order details | Something went wrong retrieving the order details. | Retry operation.If continue to fail, contact Customer Support. | Try to replicate the issue. Check console logs. |
| 9001 | Failed to retrieve token details | Something went wrong retrieving the token details. | Retry operation.If continue to fail, contact Customer Support. | Try to replicate the issue. Check console logs. |
Onramp
| Error Code | Likely Scenario | Displayed Error Message | Possible User Actions | Possible Developer Actions |
|---|---|---|---|---|
| 10001 | Exchange status is failed | Something went wrong. | Retry operation.If continue to fail, contact Customer Support. | Check transaction status with IMX/MoonPay. |
| 10002 | Unable to retrieve exchange status | Connection Error. | Retry operation.If continue to fail, contact Customer Support. | Check transaction status with IMX/MoonPay. |
| 10003 | Invalid crypto currencies | Invalid currencies. | Retry operation.If continue to fail, contact Customer Support. | Check supported tokens for Onramp. |
| 10004 | Could not get currencies | Something went wrong. | Retry operation.If continue to fail, contact Customer Support. | Check supported tokens for Onramp. |
Offramp
| Error Code | Likely Scenario | Displayed Error Message | Possible User Actions | Possible Developer Actions |
|---|---|---|---|---|
| 11001 | Exchange status is failed | Something went wrong. | Retry operation.If continue to fail, contact Customer Support. | Check transaction status with IMX/MoonPay. |
| 11002 | Unable to retrieve exchange status | Connection Error. | Retry operation.If continue to fail, contact Customer Support. | Check transaction status with IMX/MoonPay. |
| 11003 | Could not get currencies | Something went wrong. | Retry operation.If continue to fail, contact Customer Support. | Check supported tokens for Offramp. |
| 11004 | No currencies left after filtering | Currencies not available | Retry operation.If continue to fail, contact Customer Support. | Check supported tokens for Offramp. |
| 11005 | Invalid currency amount | Invalid currency amount | Retry operation with different amount.If continue to fail, contact Customer Support. | Check supported tokens for Offramp. |
| 11006 | Incorrect transaction format | Something went wrong. | Retry operation.If continue to fail, contact Customer Support. | Try to replicate the issue. Check console logs. |
NFT Checkout Primary
| Error Code | Likely Scenario | Displayed Error Message | Possible User Actions | Possible Developer Actions |
|---|---|---|---|---|
| 12000 | Feature is disabled | NFT Primary sale is not supported. | Try later, when a feature will be announced | Check that a feature should be enabled or not. |
| 12001 | Cannot create a transaction | Cannot create a transaction. | Retry operation. If continue to fail, contact Customer Support. | Try to replicate the issue. Check console logs. |
| 12002 | Cannot connect to imx-exchange | Connection Error. | Retry operation. If continue to fail, contact Customer Support. | Check transaction status with IMX/MoonPay. |
| 12003 | Polling error | Cannot retrieve status. | Retry operation. If continue to fail, contact Customer Support. | Check logs why status polling is failing. |
| 12004 | Transaction is failed | Transaction failed. | Retry operation. If continue to fail, contact Customer Support. | Check transaction status with IMX/MoonPay. |
Offers
| Error Code | Likely Scenario | Displayed Error Message | Possible User Actions | Possible Developer Actions |
|---|---|---|---|---|
| - | Invalid parameters supplied to link route | Invalid make offer parameters | Retry operation. If continue to fail, contact Customer Support. | Check that the correct parameters are being passed to the link route and are valid |
| - | API is returning an error | We have encountered an issue with our APIs while processing this request. Please try again. For further assistance please visit our support page. | Retry operation. If continue to fail, contact Customer Support. | Try to replicate the issue. Check console logs. |