Skip to main content
When an API request fails, Obiex returns a standard error response with relevant information about what went wrong.

​
Error Response Format

{
  "message": "Error description",
  "code": "ERROR_CODE",
  "details": {}
}

​
Common Error Codes

CodeHTTP StatusDescription
UNAUTHORIZED401Invalid or missing authentication
FORBIDDEN403Insufficient permissions
NOT_FOUND404Resource not found
VALIDATION_ERROR422Invalid request parameters
RATE_LIMIT_EXCEEDED429Too many requests
INTERNAL_ERROR500Server error

​
HTTP Status Codes

StatusMeaning
200Success
201Created
400Bad Request
401Unauthorized
403Forbidden
404Not Found
422Validation Error
429Too Many Requests
500Internal Server Error

​
Handling Errors

try {
  const response = await fetch('https://api.obiex.finance/addresses/me/broker', {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  });
  
  if (!response.ok) {
    const error = await response.json();
    console.error('API Error:', error.message);
    return;
  }
  
  const data = await response.json();
} catch (err) {
  console.error('Network error:', err);
}