200+ signals. 25+ sources. One API.

Filter /stocks/today.json with query params:

GET /api/v1/stocks/today.json?min_score=80§or=Technology&risk=low&limit=10
GET /api/v1/stocks/today.json?symbol=NVDA

import requests

# Free (no key)
data = requests.get(
  "https://top5stocks-api.top5stocks.workers.dev/api/v1/free/today.json"
).json()["data"]

for s in data["stocks"]:
    print(f"{s['rank']}. {s['symbol']} — Score {s['selection_score']}, ${s['price']}")

# Paid (with key)
headers = {"Authorization": "Bearer YOUR_API_KEY"}
data = requests.get(
  "https://top5stocks-api.top5stocks.workers.dev/api/v1/stocks/today.json",
  headers=headers,
  params={"min_score": 80, "sector": "Technology"}
).json()["data"]

for s in data["stocks"]:
    levels = s.get("technical_levels", {})
    print(f"{s['symbol']} — Up {levels.get('upside_reference_level')}, Down {levels.get('downside_reference_level')}")

// Free (no key)
const res = await fetch(
  "https://top5stocks-api.top5stocks.workers.dev/api/v1/free/today.json"
);
const { data } = await res.json();
data.stocks.forEach(s =>
  console.log(`${s.rank}. ${s.symbol} — Score ${s.selection_score}, $${s.price}`)
);

// Paid (with key)
const paid = await fetch(
  "https://top5stocks-api.top5stocks.workers.dev/api/v1/stocks/today.json?min_score=80",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const paidData = (await paid.json()).data;
paidData.stocks.forEach(s => {
  const levels = s.technical_levels || {};
  console.log(`${s.symbol} — Up ${levels.upside_reference_level}, Down ${levels.downside_reference_level}`);
});

=TOP5PICKS()                    → Today's top 5 ranked stocks
=TOP5STOCK("NVDA", "score")     → AI score for any symbol
=TOP5STOCK("AAPL", "upside")    → Upside reference level (Starter+)
=TOP5SECTORS()                  → Sector breakdown with avg scores

Free functions work without an API key. Upside/downside fields require Starter or above.