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

FieldTypeDescription
errorstringMachine-readable code, for example ticker_not_tracked. The llms.txt reference lists every code with its HTTP status.
messagestringWhat went wrong, in one sentence.
fixstringWhat to do next: the route or tool to call, or the input to change. Absent when there is nothing to do.
docs_urlurlThe developer docs, where keys are created.
detailsobjectCode-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
{
  "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"
}