Get a daily news brief

A research monitor can read the news and SEC filings for a list of companies every morning and tell you what matters. Itoflow rates each story for each company it could affect, from minor to material, so the brief leads with what could move your holdings. What you’ll get: a short report every weekday before the market opens, plus a feed of rated news you can read from your own code.

Before you start

An Itoflow account. The free plan is enough.
Your companies as Itoflow symbols. See Find and resolve symbols.

Quick start

Ask your AI assistant
In the Itoflow app
With the API

With Itoflow connected to Codex or Claude, paste this into your assistant:

Use Itoflow to create a research monitor named "Morning brief" for NVDA.US,
ASML.AS and TSM.US. Mandate: each morning, summarize the news and filings from
the last 24 hours that could change the value of these companies, lead with
anything rated material, say what happened and why it matters, skip routine
items, and keep it under 300 words. Schedule it on weekdays at 07:30
Europe/London. Show me the monitor before creating it, then create it, enable
it, run one report now, and summarize what it found.

Open in Claude

Start this in Claude with the Itoflow plugin.

Open in ChatGPT

Start this in ChatGPT with the Itoflow plugin.

Using another client? Copy the prompt with the button on the code block.

Open Monitors and select New monitor → Research.
Add your symbols, such as NVDA.US, ASML.AS and TSM.US.
Write the mandate: what to cover each morning, such as material news and filings from the last 24 hours, in under 300 words.
Set a weekday schedule, such as 07:30 in your time zone, and save.
On the monitor’s page, turn on Agent reports so the schedule runs.
To see a brief straight away, select Run report. It appears on the monitor’s page when it finishes.

You need an access token in ITOFLOW_ACCESS_TOKEN.

Create the monitor

curl --fail-with-body --silent --show-error \
  'https://api.itoflow.ai/watchlists' \
  --header "Authorization: Bearer $ITOFLOW_ACCESS_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Morning brief",
    "mandate": "Each morning, summarize the news and filings from the last 24 hours that could change the value of these companies. Lead with anything rated material, say what happened and why it matters, and skip routine items. Keep it under 300 words.",
    "symbols": ["NVDA.US", "ASML.AS", "TSM.US"],
    "recurrence": { "kind": "weekdays", "local_time": "07:30", "timezone": "Europe/London" }
  }'

The response contains the monitor’s id. It starts paused.

Enable it

POST /watchlists/{id}/control with {"action": "enable"}. Check that the response doesn’t say report_scheduling: "unavailable"; if it does, try again.

Run a first brief

To check it works without waiting for the morning, POST /watchlists/{id}/reports/run. GET /watchlists/{id}/active-execution shows the run in progress; when it finishes, GET /watchlists/{id}/reports/latest returns the brief.

Read the brief and the news feed

Each morning, GET /watchlists/{id}/reports/latest returns the newest brief. For the rated stories behind it, ask for the latest news, then read the news feed:

curl --fail-with-body --silent --show-error --request POST \
  'https://api.itoflow.ai/watchlists/MONITOR_ID/news/fetch' \
  --header "Authorization: Bearer $ITOFLOW_ACCESS_TOKEN"

curl --fail-with-body --silent --show-error \
  'https://api.itoflow.ai/watchlists/MONITOR_ID/news?limit=20' \
  --header "Authorization: Bearer $ITOFLOW_ACCESS_TOKEN"

Replace MONITOR_ID with the monitor’s id. The fetch returns 202 at once, and news is judged in the background, usually within a few minutes. Until you fetch, a new monitor’s feed stays empty. While feed.coverage.current is below feed.coverage.subjects, judging is still running: read the feed again every few seconds until they match. See Fetch, then poll.To fetch only new stories later, pass the last response’s feed.judged_through as since, with two safeguards:

If a response returns exactly limit items, some stories didn’t fit. Read the feed again without since and with a higher limit, up to 200, before you move your watermark on.
If feed.judged_through is null, nothing matched. Keep your previous watermark.

See News feed for every field.

Limits

Up to 100 symbols per monitor.
The news feed covers the last 24 hours and returns one page of up to 200 items.
Items rated notable or above are kept for 90 days, others for 14.
News is judged for a monitor when it fetches, paused or not.

Next steps

Search stored news across any symbols, up to 90 days back.
Monitor a portfolio: get a weighted news feed for a whole portfolio’s holdings.

Get started

Platform

Use cases

Features

HTTP API

Troubleshooting

Endpoints