Skip to main content
AGG News Feed connects real-world news to tradeable prediction markets. Use it to power category feeds, market detail pages, related-news modules, and agent workflows with articles that are already linked to markets and summarized for market impact. Instead of showing generic news links, partner apps can show why a story may matter to a specific prediction market. News Feed is an app-tier Discovery API for market-aware articles, live market links, and market-impact summaries.

Public API access

All News Feed endpoints require your app header:
string
required
Your AGG app identifier.
No user JWT is required. App venue and category settings are applied automatically, so responses only include markets your app is configured to show.

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 venueMarketIds or venueEventIds.
  • 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?

Use getMarketNews 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:
  1. Category or homepage: call getNewsFeed("finance") or getNewsFeedMarkets("finance").
  2. Market detail page: call getMarketNews({ venueMarketIds: [market.id] }).
  3. Event detail page: collect the event’s market ids, then call getMarketNews for the set.

Which id should I pass?

Choose a feed shape

Use the article feed for homepages, discovery rails, and editorial-style layouts:
Use the market feed for market pages, event pages, and category views where the market is the main object:

Pagination and refresh

Both feed shapes support the same query options:
For repeated refreshes of the same feed or market request, poll no more than once per minute unless the user explicitly asks for a manual refresh. If your UI is rendering a market card or market detail page, you already have the AGG market id at venueMarket.id. Pass that id as venueMarketIds.
The response is grouped by market. For a single market, render the first result:
In the UI, label this module as related news for the market question:
For request and response details, use the Get market news API reference.

Include matched venues

If your market object includes matchedVenueMarkets, include those ids too. This lets a single market detail page show related news for the same market across venues.
Deduplicate articles by url before rendering if you merge results from multiple markets:
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.
Render each group under its market question:
If you only have the event id and do not need market-level control, pass 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 venueMarketIds and venueEventIds.
  • limit is capped at 5 articles per market-news result and 50 rows for feed pages.
  • relevanceScore is 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

Show source, 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.

API Reference

View schemas and try the News Feed endpoints.

Building Market Views

Compose Discovery endpoints into category pages, market details, and event grids.