Error Handling

The Market Data API uses conventional HTTP response codes to indicate the success or failure of API requests. All error responses follow a consistent JSON structure to help you identify and resolve issues quickly.

Error Response Format

All error responses follow this standardized structure:

{
  "errors": [
    {
      "status": "string",   // HTTP status code (as string)
      "title": "string",    // Short error title
      "detail": "string"    // Human-readable explanation
    }
  ]
}

Key Points:

• The errors array may contain multiple error objects
• Multiple validation errors are returned together when possible
• All error responses use JSON format, even for CSV endpoints
• Error messages are in English and designed to be actionable

HTTP Status Codes

200 OK

Request succeeded. For POST requests, this indicates successful data retrieval.

400 Bad Request

The request was invalid. This typically indicates:

• Missing required parameters
• Invalid parameter values
• Malformed request body
• Validation failures