Skip to content

Source Catalog ​

Tables on this page are generated from the published @xbbg/xnews 0.2.2 package (providerCapabilities, FIXED_FEEDS, and each source factory's provider/dataset). Access requirements and rate limits are on Provider Policies.

News providers ​

NewsProvider has 104 ids: 32 query providers, 68 fixed feeds, and 4 ids that exist for data and channel APIs but cannot serve company or topic subjects.

Query providers ​

These call an upstream endpoint per subject (or, where noted, filter a publisher-wide list locally). Company feeds default to sec-edgar, yahoo-finance, google-news, and finviz; topic feeds default to google-news. Everything else is opt-in through sources. A provider whose capability or company requirement does not match the subject reports unsupported.

ProviderReadsCapabilitiesCompany subject needsDefault for
yahoo-financeYahoo Finance per-symbol RSScompanytickercompany
google-newsGoogle News search RSScompany, topiccompanyName or tickercompany, topic
sec-edgarSEC EDGAR company Atom feed (secForms)company, filingticker or CIKcompany
finvizFinviz quote-page news tablecompanytickercompany
bing-newsBing News search RSS (redirect links unwrapped)company, topiccompanyName or tickeropt-in
gdeltGDELT DOC 2.0 API (about 1 request per 5 s per IP)company, topiccompanyName or tickeropt-in
tickertickTickerTick API (10 requests per minute per IP)companytickeropt-in
hacker-newsAlgolia Hacker News search APIcompany, topiccompanyName or tickeropt-in
yahoo-searchYahoo Finance search APIcompany, topiccompanyName or tickeropt-in
sec-fulltextSEC EDGAR full-text search (secForms)company, topic, filingcompanyName or tickeropt-in
sec-currentSEC EDGAR latest-filings stream (secForms; topics filtered locally)company, topic, filingcompanyNameopt-in
federal-registerFederal Register documents APIcompany, topiccompanyNameopt-in
courtlistenerCourtListener opinion search feedcompany, topiccompanyNameopt-in
msrb-emmaMSRB EMMA continuing disclosures, filtered locally (msrbAcceptTermsOfUse)company, topic, filingcompanyNameopt-in
nasdaqNasdaq per-symbol RSScompanytickeropt-in
seeking-alphaSeeking Alpha per-symbol RSScompanytickeropt-in
hf-transcriptsEarnings-call transcripts from a Hugging Face dataset snapshotcompanytickeropt-in
arxivarXiv legacy Atom search (arxivCategories)company, topiccompanyName or tickeropt-in
openalexOpenAlex Works API (openAlexApiKey required)company, topiccompanyName or tickeropt-in
bis-researchBIS Working Papers snapshot, filtered locally (bisInstitutions)company, topiccompanyName or tickeropt-in
bis-research-hubBIS Central Bank Research Hub recent additions (bisInstitutions)company, topiccompanyName or tickeropt-in
nberNBER working-paper listing with native searchcompany, topiccompanyName or tickeropt-in
ssrnSSRN newest papers per network, title matching (ssrnNetworks)company, topiccompanyName or tickeropt-in
crossrefCrossref Works search (crossrefFilters)company, topiccompanyName or tickeropt-in
world-bankWorld Bank Documents & Reports (worldBankDocTypes)company, topiccompanyName or tickeropt-in
biorxivbioRxiv recent preprints, filtered locally (bioRxivCategories)company, topiccompanyName or tickeropt-in
medrxivmedRxiv recent preprints, filtered locally (bioRxivCategories)company, topiccompanyName or tickeropt-in
europe-pmcEurope PMC search over PubMed, PMC, and preprintscompany, topiccompanyName or tickeropt-in
hf-papersHugging Face daily papers, filtered locallycompany, topiccompanyName or tickeropt-in
osf-preprintsOSF preprints, filtered locally (osfProviders)company, topiccompanyName or tickeropt-in
ofacOFAC recent sanctions actions, filtered locallycompany, topiccompanyName or tickeropt-in
who-outbreaksWHO Disease Outbreak News, filtered locallycompany, topiccompanyName or tickeropt-in

since/until are forwarded upstream by gdelt, sec-fulltext, federal-register, courtlistener, arxiv, openalex, crossref, europe-pmc, world-bank, biorxiv/medrxiv, and osf-preprints, and enforced locally for every provider.

Fixed market, business, and regulator feeds ​

Fixed feeds are downloaded whole and filtered locally against the subject (see Topic Feeds & Subjects). Every fixed feed supports both company and topic subjects. "Inferred per item" means each item is classified as press-release, filing, analysis, or article from its source, title, and link.

ProviderFeedKindFeed URLsSuggested min poll
marketwatchMarketWatchinferred per item45 min
wsjThe Wall Street Journalinferred per item25 min
cnbcCNBCinferred per item35 min
pr-newswirePR Newswirepress-release15 min
globenewswireGlobeNewswirepress-release15 min
federal-reserveFederal Reservepress-release110 min
sec-pressSEC Newsroompress-release110 min
ffiecFFIECpress-release110 min
fdicFDICpress-release210 min
occOCCpress-release210 min
cfpbCFPBpress-release110 min
coindeskCoinDeskinferred per item15 min
cointelegraphCointelegraphinferred per item15 min
benzingaBenzingainferred per item15 min
investing-comInvesting.cominferred per item15 min
upiUPIinferred per item110 min
oilpriceOilPrice.cominferred per item110 min
nytThe New York Timesinferred per item310 min
bbcBBC Newsinferred per item110 min
nprNPRinferred per item110 min
guardianThe Guardianinferred per item110 min
ftFinancial Timesinferred per item110 min
economistThe Economistinferred per item210 min
fortuneFortuneinferred per item110 min
forbesForbesinferred per item110 min
washington-postThe Washington Postinferred per item110 min

The 42 central-bank feeds are listed on Central Banks.

Non-subject providers ​

youtube, cftc-cot, ffiec-cdr, dtcc-sdr are valid NewsProvider ids but report unsupported in feeds. Use fetchYoutubeSubscriptions/fetchYoutubeChannelVideos, fetchCotReport, fetchFfiecCallReport, and the DTCC functions instead.

Data sources ​

Use with fetchDataRelease and createDataReleaseWatcher (Economic Data Releases). Several factories derive dataset from their arguments; the example column shows one value.

FactoryproviderExample dataset
fredDataSource(seriesId, { apiKey })fredUNRATE
cotDataSource(family, options?)cftc-cottff_futures_only
ffiecCallDataSource(options?)ffiec-cdrcall-single-period
dtccSliceDataSource(options?)dtcc-sdrcftc-credits-slices
dtccCumulativeDataSource(options?)dtcc-sdrcftc-credits-eod
hmdaDataSource(year, filters)hmdaaggregations:2023:states=DC
craDataSource(kind, options?)ffiec-craaggregate-flat-file
ffiecCensusDataSource(year, options?)ffiec-censuscensus-flat-file-2026
nicDataSource(product?, options?)ffiec-nicrelationships
ffiec002DataSource({ rssdId, reportingDate })ffiec-002112819
fry9DataSource(report, options?)ffiec-fry9fry9c
ffiecE16DataSource(options?)ffiec-e16country-exposure
usaSpendingDataSource(...)usaspendingawards
grantsGovDataSource(...)grants-govopportunities
worldBankIndicatorDataSource(...)world-bank-indicatorsinflation
noaaOniDataSource(...)noaa-onioceanic-nino-index
droughtMonitorDataSource(...)us-drought-monitorarea-percent
noaaCo2DataSource(...)noaa-co2co2-trend-global
nasaGistempDataSource(...)nasa-gistempglobal-temp-anomaly
carbonIntensityDataSource(...)uk-carbon-intensitygeneration-mix
caisoFuelMixDataSource(...)caiso-fuel-mixfuel-source
cisaKevDataSource(...)cisa-kevknown-exploited-vulnerabilities
iodaDataSource(...)ioda-outagescountry-outages
ooniDataSource(...)ooni-censorshipanomaly-aggregation
wikipediaPageviewsDataSource(...)wikipedia-pageviewstop-articles
wikipediaCongressEditsDataSource(...)wikipedia-congress-editshistorical-edits
cdcWastewaterDataSource(...)cdc-wastewaterwastewater-activity
unhcrDataSource(...)unhcr-displacementpopulation
hungerMapDataSource(...)wfp-hungermapfood-security

Event sources ​

Use with fetchEventSnapshot, fetchEventsAcross, and createEventWatcher (Live Markets & World Data).

Factoryproviderdataset
nwsAlertsSource()nws-alertsactive-alerts
nhcStormsSource()nhc-stormscurrent-storms
gdacsSource()gdacsevent-list
usgsVolcanoesSource()usgs-volcanoeselevated-volcanoes
noaaTsunamiSource()noaa-tsunamiwarning-center-messages
glofasFloodSource()glofas-floodmajor-basin-outlook
gdeltEventsSource()gdelt-eventsgdelt-v2-events
faaStatusSource()faa-statusairport-status
safecastSource()safecast-radiationmeasurements
sondeHubSource()sondehub-balloonstelemetry
wikipediaCongressRecentChangesSource()wikipedia-congress-editsrecent-public-changes

Works catalogs ​

CatalogFactoryOrigin
open-libraryopenLibrarySource(options?)Official API
internet-archiveinternetArchiveSource(options?)Official API
libgenlibgenSource({ mirrors })Caller-supplied mirrors
annas-archiveannasArchiveSource({ mirrors })Caller-supplied mirrors

See Catalogs & Documents.

Current-state functions ​

FunctionReturns
fetchYahooQuote, fetchYahooBarsLatest quote; OHLCV bars
fetchKalshiMarkets, fetchPolymarketMarkets, fetchManifoldMarketsPredictionMarketQuote[] with YES probability in 0–1
fetchTrafficCamerasNYC, London TfL, Delaware, and New Zealand camera directories
fetchDeepStateMapFrontlineTerritorial-control polygons

xbbg is independent open-source software and is not affiliated with, endorsed by, sponsored by, or approved by Bloomberg Finance L.P.