Skip to main content
Each recipe maps a class of user prompt to the smallest set of tool calls and an answer template. The output rules these assume — answer first, keep signs and provenance, report refusals, never advise — live once in the Agent instructions. Every tool is POST https://api.stockcontext.com/v1/tools/{name} with the X-API-Key header; the recipes show the JSON body.

​
One-symbol brief

For “What’s going on with Apple?”, “Give me a read on AAPL”. Resolve, then one overview call.
Template:
Filled from the live AAPL fixture (numbers verbatim):

​
Exact statement numbers

For “Show me Apple’s income statement”, “What was net income?”. Use stock_financials for multiple periods, a specific statement, quarterly data, or full provenance.
Financial statements are columnar: report the period from data.periods, then the aligned data.fields cell. Parse exact string cells as decimals. A field with unavailable is a refusal; report the token, never a 0.

​
Latest price

For “What’s Apple trading at?”. One call, licensed feed.
The response carries provenance: "licensed_market_data" and a meta.as_of.market date. Cite the market clock, not the SEC clock.

​
Insider activity

For “Any insider selling in NVIDIA?”. One call; the response is Form 4s transcribed (provenance: "sec_filing").
Filled from the live fixture:

​
Institutional holders

For “Who holds Apple?”. One call — but this is a tracked subset, never total ownership.
The response always carries a coverage block (managers_tracked: 20, exhaustive: false). Report holders as “among tracked managers” and pass the report_period through; 13F holdings are filed up to 45 days after quarter-end.

​
Filings inventory

For “What has Apple filed?”. One call returns the inventory with accession, dates, and the primary document.
Each filing carries its accession, form, filed date, period_end, and a full_text_submission URL to SEC. This tool lists filings; it does not return parsed section text.

Choose a tool

For a prompt no recipe covers, pick the smallest set of calls by job.