Quickstart

curl "https://api.forwardmodel.ai/v1/scores?symbols=COST,MSFT" \
  -H "Authorization: Bearer $FORWARD_MODEL_API_KEY"

import os, requests

r = requests.get(
    "https://api.forwardmodel.ai/v1/scores",
    params={"symbols": "COST,MSFT"},
    headers={"Authorization": f"Bearer {os.environ['FORWARD_MODEL_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
for e in r.json()["entries"]:
    print(e["symbol"], e["score"], e["band"])

{
  "date": "2026-11-16",
  "of": 2926,
  "entries": [
    {
      "symbol": "COST",
      "name": "Costco Wholesale Corp",
      "date": "2026-11-16",
      "score": 6.83,
      "out_of": 10.0,
      "band": "Above average",
      "top_pct": 35,
      "summary": "A steady business whose members keep coming back, with thin margins that leave little room for rising costs.",
      "for": ["Members keep renewing at near-record rates", "More shoppers are coming through the doors"],
      "against": ["Thin margins leave little room for rising costs", "A slowdown in big-ticket spending would weigh on sales"]
    }
  ],
  "not_scored": []
}