Error Codes & Handling

Arbion AI APIs return standard HTTP status codes. In addition, response bodies include error objects to aid debugging.

HTTP Code	Error Code	Description	Suggested Action
400	INVALID_REQUEST	Malformed JSON or missing required parameters.	Verify request payload schema.
401	UNAUTHORIZED	Missing or invalid API key.	Check API key and authorization header.
403	FORBIDDEN	Insufficient permissions for the requested resource.	Review account roles or request scopes.
404	NOT_FOUND	Endpoint or resource not found.	Confirm endpoint URL and resource identifiers.
429	RATE_LIMIT_EXCEEDED	Exceeded allowed number of requests in a given timeframe.	Implement exponential backoff and retry.
500	INTERNAL_ERROR	Unexpected server-side exception.	Retry later; contact support if persists.

Error Response Format:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Detailed error description.",
    "details": { ... }
  }
}

8.3 Glossary

Term	Definition
API Key	A secret token used to authenticate requests to Arbion AI APIs.
Bot	A programmable trading agent configured via the createTradingBot endpoint.
Chain	The blockchain network (e.g., eth, bsc, sol, matic) targeted by an API request.
Cross-Chain	Feature for aggregating data or operations across multiple blockchains in a single request.
VaR	Value at Risk; the maximum expected portfolio loss over a given time horizon at a confidence level.
Expected Shortfall	Average loss exceeding the Value at Risk threshold.
Emission Schedule	Planned distribution timeline for token releases as simulated by optimizeTokenomics.