7️⃣Error Codes

Error Handling

Validation Errors (400)

Invalid Messages

{
  "status": "error",
  "message": "Invalid request. Messages array is required."
}

Invalid Chain

{
  "status": "error",
  "message": "Invalid chain. Supported chains are: base, polygon, avalanche, solana"
}

Invalid Wallet Address

{
  "status": "error",
  "message": "Invalid wallet address format for base. Expected EVM (0x...) address."
}

Not Found Errors (404)

{
  "status": "error",
  "message": "Operation not found"
}

Payment Errors (402)

{
  "x402Version": 1,
  "error": "Token payment required",
  "accepts": [
    {
      /* payment config */
    }
  ]
}

Payment Verification Failure (400)

{
  "status": "error",
  "message": "Payment verification failed",
  "error": "Invalid payment proof"
}

Server Errors (500)

{
  "status": "error",
  "message": "Internal server error while processing query."
}