The Helious feed
get_feedThe Helious feed, newest first: the posts Helious publishes (kind post: releases with their surprise, auction results, board updates, the daily brief and live squawk lines) and the wire headlines it carries (kind headline: breaking news, geopolitics, official statements, central bank speakers, bank and business notes). Every item has a stable id, and items carry two score channels on a -10 to +10 scale: score and direction for bonds, equity_score and equity_direction for stocks. The same story can be bullish for bonds and bearish for stocks, so read the channel you trade. topic is what the item is about, the code the terminal prints on the row (equities, bonds, cb, geo, data, chatter); category is only the lane it came in on, so a stock story off the news wire has category news and topic equities. Most items carry helious_read, Helious's plain-English line on why it matters. A headline also carries carried_at (when Helious put it on the tape; created_at is when it was published) and a URL-free thread_id that stays the same when a story is retitled. No headline names its outlet, author or link. Depth follows the connected account for the permanent posts: releases, auctions, desk posts, the brief, the minutes. Headlines are kept 7 days whatever the plan (official statements and Fed speakers 400 days), as are squawk lines and the board lanes. Optional q filters by word; categories narrows to chosen lanes; kind narrows to headline or post; topics narrows to what items are about; since moves the window's start later. The filters search the whole window and matched counts every match. Where the account receives news an hour behind: a post from created_at, a headline from the later of created_at and carried_at. A headline names no outlet as its source: a trailing ' - Outlet', a 'via Outlet' credit and the wire's label are removed; a headline about an outlet, or about an index such as the Nikkei, can still mention one.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Filter word. | |
| kind | No | headline or post. Empty means both. | |
| fresh | No | Set true to ask for the live view of this one call, for 5 credits, where the connected account otherwise receives it an hour behind. Accepted and free where the account is already live. No effect without a key. | |
| limit | No | Most items to return. | |
| since | No | Only items published at or after this date (2026-10-30) or ISO 8601 time; never earlier than the plan's history (plan_limit says so when it asks for more). Empty, or a value that is not a date, means the whole window. | |
| topics | No | Comma-separated topics, like equities or bonds,cb: what the item is about, the terminal's row code. Matches the topic or the secondary_topic. One of cb, geo, bonds, data, equities, chatter, desk, narrative, energy, fx. Empty means all. | |
| categories | No | Comma-separated lanes, like release,auction or news,geo. Empty means all. |