Public API access
All News Feed endpoints require your app header:string
required
Your AGG app identifier.
Endpoint map
Available categories are
politics, geopolitics, world, finance, climate, and
entertainment.
What you get
- Article-first feeds for discovery pages and editorial-style layouts.
- Market-first feeds where each market carries its recent article timeline.
- On-demand related-news lookup for specific
venueMarketIdsorvenueEventIds. - Article metadata, publisher/source labels, images when available, publish timestamps, and links to original sources.
- LLM-generated market-impact summaries and relevance scores for ranking related articles.
- App-scoped filtering so disabled venues and categories do not leak into partner feeds.
Which call should I use?
UsegetMarketNews when the user is already looking at a specific market or event. This is the call
for “related news” modules on market detail pages.
Use getNewsFeed when you want a category news feed where articles are the main object.
Use getNewsFeedMarkets when you want a category feed where markets are the main object and each
market carries its recent article timeline.
Most partner integrations use both patterns:
- Category or homepage: call
getNewsFeed("finance")orgetNewsFeedMarkets("finance"). - Market detail page: call
getMarketNews({ venueMarketIds: [market.id] }). - Event detail page: collect the event’s market ids, then call
getMarketNewsfor the set.
Which id should I pass?
Choose a feed shape
Use the article feed for homepages, discovery rails, and editorial-style layouts:Pagination and refresh
Both feed shapes support the same query options:Get related news for one market
If your UI is rendering a market card or market detail page, you already have the AGG market id atvenueMarket.id. Pass that id as venueMarketIds.
Include matched venues
If your market object includesmatchedVenueMarkets, include those ids too. This lets a single
market detail page show related news for the same market across venues.
url before rendering if you merge results from multiple markets:
Get related news for an event
If the user is on an event detail page, fetch the event’s markets first, then request news for the markets you plan to render.venueEventIds directly.
For the exact body shape, use the
Get market news API reference.
You can pass venueMarketIds, venueEventIds, or both. The request accepts up to 10 ids total,
and limit is capped at 5 articles per result.
Use customQuery only when you want to bias the search toward a user-selected topic. Use tbs only
when you need to override the time window for a dedicated experience, such as “past 24 hours”.
Integration notes
- Feed endpoints are cached for 60 seconds per request and app scope. Do not poll more frequently unless the user explicitly refreshes.
- On-demand market-news requests accept up to 10 ids total across
venueMarketIdsandvenueEventIds. limitis capped at 5 articles per market-news result and 50 rows for feed pages.relevanceScoreis a ranking signal within the response, not an absolute quality score across unrelated markets or categories.- News summaries explain why an article may matter to a market; they are not a replacement for the linked source article.
Response fields to render
Render recommendations
Showsource, publishedAt, and url with each article so users can inspect the original source.
Treat summary as market-context copy: it explains why the article may matter to the linked market,
not a replacement for the article itself.
relevanceScore is a relative ranking signal. Use it to order or hide low-confidence links inside a
single response, but do not compare scores across unrelated pages as an absolute measure.
Error handling
If a category is disabled for your app, feed endpoints return an empty page with
data: [], nextCursor: null, and hasMore: false.
FAQ
Is News Feed just a list of article links?
No. News Feed links articles to specific prediction markets and includes market-impact summaries so apps can show why a story may matter to a tradeable market.Should I use article-first or market-first feeds?
Use article-first feeds when the news story is the main object, such as a homepage or discovery rail. Use market-first feeds when the market is the main object, such as a market page, event page, or category page built around trading opportunities.Can agents use News Feed?
Yes. Agents can use News Feed as structured market context: article metadata, market ids, summaries, relevance scores, and live linked-market prices are returned in API responses.Related
API Reference
View schemas and try the News Feed endpoints.
Building Market Views
Compose Discovery endpoints into category pages, market details, and event grids.