A research tool your agent can call.

curl -X POST https://www.bobsresearch.com/api/desk/read \
  -H "Authorization: Bearer $BOB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"AAPL","mode":"quick"}'

{
  "success": true,
  "mode": "quick",
  "status": "done",
  "fromCache": true,
  "result": {
    "ticker": "AAPL",
    "companyName": "Apple Inc.",
    "form": "10-K",
    "filingDate": "2025-10-31",
    "accession": "0000320193-25-000079",
    "rating": 72,
    "label": "Bullish",
    "thesis": "Apple maintains strong operational momentum ...",
    "risks": ["Google search-revenue antitrust exposure", "..."],
    "tier": "screen",
    "model": "claude-haiku-4-5",
    "sourceUrl": "https://www.sec.gov/...",
    "updatedForm": "10-Q",
    "updatedFilingDate": "2026-07-31"
  }
}

import os, requests

r = requests.post(
    "https://www.bobsresearch.com/api/desk/read",
    headers={"Authorization": f"Bearer {os.environ['BOB_API_KEY']}"},
    json={"ticker": "AAPL", "mode": "quick"},
    timeout=60,
)
read = r.json()["result"]
print(read["rating"], read["label"], read["thesis"])

const r = await fetch("https://www.bobsresearch.com/api/desk/read", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BOB_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ ticker: "AAPL", mode: "quick" }),
});
const { result } = await r.json();
console.log(result.rating, result.label, result.risks);

# forensic read: cached → result; otherwise a job you poll
curl -X POST https://www.bobsresearch.com/api/desk/read \
  -H "Authorization: Bearer $BOB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"AAPL","mode":"full"}'
# → { "status": "pending", "jobId": "…", "poll": "/api/desk/read?jobId=…", "etaSeconds": 240 }

curl "https://www.bobsresearch.com/api/desk/read?jobId=<id>" \
  -H "Authorization: Bearer $BOB_API_KEY"
# → { "status": "done", "result": { … } }

# pace yourself
curl https://www.bobsresearch.com/api/desk/me -H "Authorization: Bearer $BOB_API_KEY"

{
  "name": "bobs_research_read",
  "description": "Rate a US-listed stock from its latest SEC filing (10-K, with the newest 10-Q and material 8-Ks layered in). Returns a 0-100 rating, a label, a thesis, and the key risks. Quick mode is a fast screen; full mode is a forensic read of the whole filing including footnotes.",
  "input_schema": {
    "type": "object",
    "properties": {
      "ticker": { "type": "string", "description": "US stock ticker, e.g. AAPL" },
      "mode": { "type": "string", "enum": ["quick", "full"], "default": "quick" }
    },
    "required": ["ticker"]
  }
}