Error Codes & Troubleshooting

Complete reference for API error codes, common issues, and troubleshooting steps.

HTTP Status Codes

StatusMeaningAction
200SuccessRequest processed successfully
201CreatedResource created successfully
400Bad RequestCheck request parameters
401UnauthorizedToken missing/invalid, refresh token
403ForbiddenNo permission for resource
404Not FoundResource doesn't exist
429Rate LimitedWait and retry with backoff
500Server ErrorContact support if persists

Application Error Codes

VALIDATION_ERROR

400

Invalid input data. Check error.details for specific field errors.

SYMBOL_NOT_FOUND

404

Stock symbol doesn't exist or isn't supported.

INSUFFICIENT_DATA

422

Not enough historical data for requested analysis (e.g., date range too short for indicators).

BACKTEST_FAILED

500

Backtest execution failed. Check parameters and data availability.

Common Issues & Solutions

Token Expired

Error: 401 TOKEN_EXPIRED

Solution: Call /auth/refresh with refresh token to get new access token

Rate Limited

Error: 429 RATE_LIMIT_EXCEEDED

Solution: Wait for reset time (check Retry-After header), implement exponential backoff

Invalid Symbol

Error: 404 SYMBOL_NOT_FOUND

Solution: Verify symbol exists, check for typos, ensure proper formatting (uppercase)