> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.alpha.openantares.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.alpha.openantares.com/_mcp/server.

# Errors and request IDs

Alpha returns JSON errors with a stable code, a human-readable message, and a request ID.

```json
{
  "error": {
    "code": "invalid_request",
    "message": "The JSON body must be an object.",
    "requestId": "b4db1e4f-0f4e-4f55-9471-a7bf50f9e6b1"
  }
}
```

| Status | Meaning                                            | What to do                                      |
| ------ | -------------------------------------------------- | ----------------------------------------------- |
| `400`  | Invalid body, argument, or vault selection         | Correct the request and do not retry unchanged  |
| `401`  | Missing, invalid, expired, or revoked bearer token | Refresh OAuth or replace the API key            |
| `403`  | The user or key role cannot perform the action     | Request the correct vault role                  |
| `404`  | Tool or resource not found                         | Refresh the tool catalog or resource ID         |
| `429`  | Rate limit reached                                 | Wait for `Retry-After`, then retry with backoff |
| `5xx`  | Temporary service failure                          | Retry with bounded exponential backoff          |

## Request IDs

Every response includes `X-Request-Id`. You can also send your own value, up to 120 characters, in the request header. Use a unique ID for each attempt.

```http
X-Request-Id: order-review-2026-09-02-001
```

Alpha stores the ID with its shared API and MCP audit record. Secret values and sensitive tool arguments are redacted before storage.

## Rate limits

Current API limits are 240 requests per minute per credential and 600 requests per minute per source IP. SDKs retry common transient responses, but your application should still bound total retries.