●PUBLIC BETASEPOLIA TESTNET · NO REAL FUNDS · NOT PRODUCTION CUSTODYLearn more →
Vela

Error Codes

HTTP and WebSocket error responses include a machine-readable error code.

Error Response Format

{
  "ok": false,
  "error": {
    "code": "E_INSUFFICIENT_BALANCE",
    "message": "Insufficient available balance for this order"
  }
}

Order Errors

CodeDescription
E_SIG_MISMATCHRecovered signer address does not match the user field
E_NONCE_USEDThis nonce has already been used by this account
E_NONCE_INVALIDNonce is not a valid positive integer
E_INSUFFICIENT_BALANCEAvailable balance is too low for this order
E_CREDIT_LIMITOrder would exceed the account credit limit
E_MARKET_NOT_FOUNDThe specified market ID does not exist
E_INVALID_PRICEPrice is zero, negative, or not a valid integer
E_INVALID_QUANTITYQuantity is zero, negative, or not a valid integer
E_POST_ONLY_REJECTEDPost-Only order would have crossed the spread
E_FOK_REJECTEDFOK order could not be fully filled immediately
E_ORDER_NOT_FOUNDOrder ID does not exist or does not belong to this account
E_MARKET_CLOSEDThe market is currently not accepting orders

Authentication Errors

CodeDescription
E_CHALLENGE_EXPIREDThe nonce from request_challenge has expired (60s TTL)
E_CHALLENGE_USEDThis challenge nonce has already been used
E_AUTH_REQUIREDThis channel requires authentication
E_AUTH_FAILEDSignature recovery failed or address mismatch

System Errors

CodeDescription
E_INTERNALUnexpected internal engine error
E_RATE_LIMITToo many requests from this address
E_INVALID_REQUESTRequest body is malformed or missing required fields
In automated strategies, handle E_NONCE_USED by incrementing your nonce counter and retrying. Never retry on E_SIG_MISMATCH — this indicates a signing error that needs investigation.