Quickstart
Authenticate and pull your first scored feed items.
1. Get an API key
Create a key from the API keys page in your dashboard. Keys are
prefixed fc_live_ and are shown once at creation — store it somewhere safe.
2. Make your first request
Every request is authenticated with a Bearer token. Here's how to pull the most recent scored feed items:
curl https://api.forecite.dev/v1/feeds?limit=5 \
-H "Authorization: Bearer fc_live_your_key_here"const res = await fetch("https://api.forecite.dev/v1/feeds?limit=5", {
headers: { Authorization: `Bearer ${process.env.FORECITE_API_KEY}` },
})
const { data, next_cursor } = await res.json()
console.log(data)import os, requests
res = requests.get(
"https://api.forecite.dev/v1/feeds",
params={"limit": 5},
headers={"Authorization": f"Bearer {os.environ['FORECITE_API_KEY']}"},
)
print(res.json()["data"])3. Read the response
Each item carries the source artifact plus its Verdict Engine scoring block:
{
"data": [
{
"id": "0b3f...",
"title": "Q3 EPS $4.93 vs $4.59 est; FY guide raised",
"source": "globenewswire",
"published_at": "2026-06-29T13:31:02Z",
"scoring": {
"actionability": true,
"sentiment_score": 8,
"sentiment_comment": "Beat + raised guide; clear positive surprise."
},
"symbols": [{ "symbol": "NVDA", "exchange": "NASDAQ" }]
}
],
"next_cursor": "eyJpZCI6..."
}Next steps
- Filter the feed by ticker, source, or sentiment — see The feed.
- Score your own news or filings with the Verdict Engine.
- Understand per-plan caps in Rate limits & quotas.