Objects
Error
Every non-2xx answer.
Every non-2xx answer. The code is stable; message and fix are written so an agent can act on them.
Fields
| Field | Type | Description |
|---|---|---|
error | string | Machine-readable code, for example ticker_not_tracked. The llms.txt reference lists every code with its HTTP status. |
message | string | What went wrong, in one sentence. |
fix | string | What to do next: the route or tool to call, or the input to change. Absent when there is nothing to do. |
docs_url | url | The developer docs, where keys are created. |
details | object | Code-specific extras: retry_after_seconds on rate_limited, symbols on invalid_symbol and unknown_symbol, cap and sent on ticker_cap_exceeded, demo_symbols on not_a_demo_symbol. Absent otherwise. |
Example
{
"error": "ticker_not_tracked",
"message": "NVDA is not one of the tickers this account tracks",
"fix": "Add it to the tracked tickers (3 of 50 slots used): PUT /api/v1/tickers, or the set_tracked_tickers MCP tool.",
"docs_url": "https://tradingpal.io/developers"
}