Vessel Finance API
Vessel Finance API
  • Introduction
  • General Info
  • HMAC Signature Guide
  • Poseidon Signature Guide
  • Internal Transfer Signature Guide
  • Error Code
  • Vessel REST API
    • Public
      • Market Data
        • 24hr Ticker Statistics
        • Kline / Candlestick Data
        • Order Book
        • Recent Trades List
        • Average Price
        • AMM Pool Last 24h Data
      • Exchange Data
        • Ticker Info
        • Asset Info
        • Trade Fee
        • AMM Pool Info
    • User
      • Asset
        • User Asset
        • Withdraw
        • Withdraw History
        • Deposit History
        • Claim History
        • Internal Transfer (Send)
        • Internal Transfer History
      • Order
        • Place Order
        • Cancel Order
        • Open Orders
        • Completed Orders
        • All Orders
        • Query Order
        • Modify Order
      • AMM
        • Add Liquidity
        • Remove Liquidity
        • Collect Fee
        • AMM Position
        • AMM Action History
      • Account
        • User Profile
        • User Trade List
  • Vessel WebSocket
    • Market
      • Order Book
      • K Line
      • Recent Trades
      • 24hr Ticker Statistics
      • Ticker Setting Upade
    • User
      • Authorize
      • Balance
      • Account

Error Code

This document provides a comprehensive list of error codes that may be returned by the DEX API. Understanding these error codes will help you handle errors effectively in your applications.

HTTP Status Codes#

The API uses standard HTTP status codes to indicate the success or failure of a request:
HTTP CodeError Type
2xxSuccess
4xxClient Error
5xxServer Error

Error Response Format#

When an error occurs, the API will return a JSON response in the following format:
{
  "code": "ERROR_CODE",
  "message": "A human-readable error message"
}

Error Code#

10xxx - General Errors#

These are common error codes that apply to any API request. They typically indicate issues like invalid input, missing parameters, or internal server errors.
HTTP CodeError CodeError Description
50010000Internal server error
50210001Bad Gateway
50310002Unable to connect to server
50410003Request timestamp is far from the server time
50410004Timeout
40110005Unauthorized api key
40110006Invalid 'VESSEL-PASSPHRASE'
40110007Failed to verify signature
40410008API not found
40510009Request method is not allowed
42910010IP address rate limit exceeded
42910011User rate limit exceeded
50010012System under maintenance. All APIs currently unavailable.

11xxx - API Request Errors#

These errors are related to specific issues with the API request itself, such as unauthorized access, rate limits, or endpoint not found.
HTTP CodeError CodeError Description
40011001Missing required header '{headerName}'
40011002Missing required parameter '{paramName}'
40011003Header '{headerName}' was empty
40011004Parameter '{paramName}' was empty
40011005Invalid '{paramName}'. Value must be of type ({type})
40011006Invalid '{paramName}'. Value not in allowed enum values [{allowedValues}]
40011007Invalid '{paramName}'. Value exceeds maximum allowed ({maxValue})
40011008Invalid '{paramName}'. Value does not reach minimum required ({minValue})
40011009Invalid '{paramName}'. Value must start with '{expectedPrefix}'
40011010Invalid '{paramName}'. '{paramName}' must be an integral multiple of ({1e(-maxDecimal)})
40011011Unknown parameter '{paramName}'
40011012Invalid request body
40011013Invalid 'symbol'
40011014Invalid 'assetName'
40011015Invalid 'assetId'
40011016Invalid 'level'
40011017Invalid 'poolId'
40011018Invalid 'VESSEL-TIMESTAMP'
40011021Upload limit exceeded. Maximum of ({maxNumber}) files allowed
40011022File '{fileName}' exceeds maximum size limit ({sizeLimit})
40011023User not found. Please register first
40011024Twitter account already verified for this user
40011025Not eligible to generate invitation code

12xxx - Spot Trading Errors#

This category covers errors specific to spot trading operations. Examples include invalid order types, insufficient balance, or market data issues.
HTTP CodeError CodeError Description
40012001Insufficient balance
40012002Duplicate clientOrderId
40012003Invalid 'clientOrderId'. 'clientOrderId' must be unit252.
40012004Order not found
40012005Order already closed
40012006Order already cancelled
40012007Order already filled
40012008Cancel order failed. Can only cancel order with 'NEW' or 'PARTIALLY_FILLED' status
40012009Modify order failed. Can only modify order with 'NEW' status
40012010Place order failed. Reach the max open orders allowed ({maxOrderQty})
40012011Spot market is closed for the symbol
40012012Invalid Poseidon hash or signature
40012013Cancel all orders partially failed. Some orders could not be cancelled

13xxx - AMM (Automated Market Maker) Errors#

These errors occur in the context of Automated Market Maker functions. Issues such as liquidity provision failures or incorrect AMM pool parameters are categorized here.
HTTP CodeError CodeError Description
40013001Insufficient balance
40013002Invalid Poseidon hash or signature
40013003Add liquidity failed. Amount of liquidity added less than minimum requirement
40013004Invalid 'nonce'. 'nonce' must be uint252
40013005Invalid tick range. 'tickIndexL' must be less than 'tickIndexR'
40013006Invalid 'tickIndexL'. Value cannot be less than pool minimum tick ({minTick})
40013007Invalid 'tickIndexR'. Value cannot be more than pool maximum tick ({maxTick})
40013008Add liquidity failed. Reached the max open positions allowed in this pool ({maxPositionSize})
40013009Remove liquidity failed. Removing zero liquidity is not allowed
40013010Remove liquidity failed. Amount of liquidity removed less than minimum requirement.
40013011AMM position not found
40013012Duplicate nonce
40013013Collect fee failed. Empty fee in this position
40013014Must provide 'tickR' and 'tickL' at the same time

14xxx - Deposits & Withdrawals Errors#

Transfer errors are associated with the movement of assets between wallets or accounts, such as failed transfers or invalid recipient addresses.
HTTP CodeError CodeError Description
40014001Insufficient balance
40014002Withdraw history not found
40014003ClientOrderId duplicated
40014004Duplicate nonce
40014005Invalid 'nonce'. 'nonce' must be uint252
40014006To Address must be registered on Vessel
40014007Failed to verify Ethereum signature

20xxx - WebSocket Errors#

These errors occur when interacting with WebSocket streams. Examples include issues with connection, authentication, or data transmission through WebSocket channels.
Error CodeError Description
20000Connection failed due to internal error
20001Request timestamp is far from the server time
20002Unauthorized api key
20003Invalid 'VESSEL-PASSPHRASE'
20004Failed to verify signature
20005Missing required parameter '{paramName}'
20006Parameter '{paramName}' was empty
20007Invalid request body
20008Unknown parameter '{paramName}'
20009Invalid 'type'
20010Invalid 'channel'
20011Invalid 'Interval'. Value not in allowed enum values [1m, 3m, 5m, 15m, 30m, 1h, 4h, 8h, 12h,1d]
20012User channel requires authentication first
20013Multiple authentications not allowed on a single WebSocket connection.
20014Invalid 'symbol'
20999Automatically disconnected. A single connection to the WebSocket API is valid for 24 hours. Reconnection is required for continuous communication.
Modified at 2024-10-12 10:10:02
Previous
Internal Transfer Signature Guide
Next
Vessel REST API
Built with