Errors

Error schema

All REST errors are returned as JSON with success: false:

{
  "success": false,
  "requestId": "6debfe7e-177d-4dad-aa96-5150e225dd6e",
  "error": {
    "code": "SOME_ERROR_CODE",
    "message": "Human readable message"
  }
}

Common HTTP statuses

400: invalid input, expired token, invalid signed tx, slippage exceeded, etc.
401: missing/invalid API key
404: token not found / invalid resource
408: transaction expired (blockhash expired)
409: already processed / conflicts
502: upstream RPC error
503: transient errors (account in use, network issues)

Common errors

Code	Action
`AUTH_ERROR`	Verify `Authorization: Bearer api_...`
`VALIDATION_ERROR`	Validate request body (mints/amounts/slippage)
`INSUFFICIENT_FUNDS`	Check wallet balance (not enough SOL or tokens for transaction)
`INSUFFICIENT_SOL`	Add SOL to wallet (not enough for transaction fees)
`INSUFFICIENT_TOKEN_BALANCE`	Check token balance (not enough tokens to sell)
`SLIPPAGE_EXCEEDED`	Try increasing priority or slippage
`RATE_LIMIT_EXCEEDED`	Too many RPC requests, wait and retry
`TX_EXPIRED`	Rebuild the transaction and submit quicker
`CONFLICT_ERROR`	Wallet already registered, use existing API key