Y2 Elite workspaces are rolling out for teams
Y2Y2Docs
News Terminal

Topics and Feeds

Reference for the News Signal Feed topic catalog and identifiers

Y2 currently defines 40 News feeds in a shared source registry. The app and API use the IDs on this page to select topic caches.

The feed catalog is configuration-driven. Use GET /api/v1/news/feeds when an integration needs to discover the current list at runtime instead of storing a copy.

Feed catalog

Politics and Geopolitics: 4 feeds

FeedIDCoverage
GeopoliticsgeopoliticsAlliances, wars, sanctions, and diplomatic flashpoints
US Politicspolitics_usFederal politics, elections, Congress, and major policy shifts
DefensedefenseMilitary operations, NATO, weapons programs, and security policy
Sanctions & Tradesanctions_tradeExport controls, tariffs, sanctions, and industrial policy

Macro and Markets: 5 feeds

FeedIDCoverage
MacromacroHigh-impact macroeconomic and geopolitical events with market relevance
EquitiesequitiesGlobal equity markets, earnings, indices, and market structure
Rates & FXrates_fxInterest rates, currencies, central banks, and yield curves
CommoditiescommoditiesEnergy, metals, agriculture, and commodity-market shocks
Banking & Regulationbanking_regBanking stress, financial regulation, and financial stability

Industry Verticals: 7 feeds

FeedIDCoverage
EnergyenergyOil and gas, power markets, grids, nuclear, and renewables
CybercyberAttacks, ransomware, vulnerabilities, infrastructure, and threat actors
SemiconductorssemiconductorsChip manufacturing, foundries, accelerators, and supply chains
Biotech & HealthbiotechPharma, biotech, health alerts, and life-science market events
Logistics & MaritimelogisticsPorts, shipping, chokepoints, supply chains, and disruptions
Critical Mineralscritical_mineralsRare earths, lithium, copper, mining, and battery materials
Telecomtelecom5G, submarine cables, satellite broadband, and network infrastructure

Regional Desks: 6 feeds

FeedIDCoverage
MENAregion_menaMiddle East and North Africa political, conflict, and economic signals
Europeregion_europeEuropean politics, EU policy, security, and regional economics
Asia-Pacificregion_asiapacChina, Indo-Pacific security, ASEAN, and regional political economy
Latin Americaregion_latamPolitics, security, crime, and economic signals in Latin America
Africaregion_africaPolitics, conflict, resources, and regional economic developments
North Americaregion_namericaUS, Canada, and Mexico cross-border political and economic signals

AI and Technology: 5 feeds

FeedIDCoverage
AIaiLLMs, infrastructure, model launches, and major partnerships
AI Agentsai_agentsAgent frameworks, incentives, ecosystems, and launches
DatadatsData, analytics, and infrastructure developments
Machine Learningmachine_learningAcademic, industry, and open-source ML developments
TechtechSoftware, semiconductors, regulation, and AI infrastructure

Crypto and Digital Assets: 13 feeds

FeedIDCoverage
BasebaseBase L2 network and ecosystem developments
BitcoinbitcoinNetwork upgrades, ETF flows, miners, and adoption
CryptocryptoBroad markets, launches, infrastructure, and protocols
DeFidefiProtocols, yield markets, governance, and infrastructure
EthereumethereumProtocol upgrades, scaling, validators, and ecosystem changes
HyperliquidhyperliquidHYPE, governance, perps liquidity, and ecosystem projects
On-Chain Whaleson_chain_whaleLarge transactions, wallets, and whale activity
PerpsperpsPerpetual futures, derivatives, leverage, and trading platforms
RipplerippleXRP, XRPL, Ripple Labs, and related legal developments
RWArwaTokenized real-world assets, issuers, platforms, and regulation
SolanasolanaProtocol, validator, outage, and core-network developments
Token Listingstoken_listingsExchange additions, token listings, and launches
VirtualsvirtualsVirtuals Protocol, GAME, agents, commerce, and tokenomics

Every topic in the current registry uses a 12-hour recap window.

Select feeds in the app

Follow Monitor selected topics. The app restores your saved selection. It does not apply the API's default topic list.

Choose a useful combination

Start narrow, then add broader feeds only when they contribute different coverage.

  • Market and policy: macro, equities, rates_fx, geopolitics
  • Technology supply chain: ai, semiconductors, critical_minerals, energy
  • Cyber risk: cyber, defense, telecom, geopolitics
  • Digital assets: crypto, bitcoin, ethereum, defi

Broad and narrow topics can overlap. For example, crypto can include events also found under bitcoin or ethereum. More feeds increase coverage and can also increase duplicate context.

Use topic IDs with the API

The topics query parameter accepts comma-separated IDs from the catalog above. If omitted, it defaults to crypto,geopolitics,macro,equities,ai,energy. Unknown IDs return 400 Bad Request.

Use List news for requests and pagination. Use List feeds to discover the current catalog at runtime.

Next steps