Api Explain Paper Position

Return an explanation of why the user's paper position in ticker is up/down. Auth-gated (per-user portfolio data). No CSRF dep — read-only GET, no mutation. Cost cap enforced in the service layer.

get/api/ai/explain-position

Request

  • Base URL: https://www.oxfordledge.com (the document declares no server; this is the origin it was published from)
  • URL: https://www.oxfordledge.com/api/ai/explain-position
  • Auth: none declared

Query parameters

tickerstring required

Response

Successful Response

okboolean required

True on successful explanation; False on cap-hit / no-position / error.

tickerstring required

Resolved + uppercased ticker (empty on validation error).

explanationstring required

Multi-paragraph plain-text explanation.

disclosurestring required

Mandatory advice-disclosure footer.

sourcestring required

deterministic | llm_polished | rate_limited | no_position | error.

calls_todayinteger required

User's explainer call count today (post-increment).

daily_capinteger required

Per-user daily cap on explainer calls.

Changes

No recorded changes to this operation across all 1 revision of this API.