Finance Pulse API · reference
Endpoints
Every request goes to https://finance-pulse.p.rapidapi.com with your X-RapidAPI-Key and
X-RapidAPI-Host: finance-pulse.p.rapidapi.com headers. All endpoints are GET. New here? Start with the
quick start.
Statements
#GET/v2/statementsv2
Search statements across all topics
Extracted statements, newest first by the article's post time, filtered by any combination of symbol, sector, theme, topic, sentiment, importance, source type, time range and image. Cursor-paged.
Parameters
symbolstring, repeatableSymbol, e.g. NVDA (see /v2/symbols). Repeat or comma-separate for several (OR), up to 10. Common aliases resolve: NVIDIA and NVDA match the same statements.
sectorstring, repeatableGICS sector, e.g. Energy (see /v2/meta for the 11). Repeatable.
theme_idstringtopic_idstringsentimentstring, repeatablebullish, bearish, neutral. Repeatable.
importance_minstringMinimum importance: low, medium, high, ultra
source_typestring, repeatablenews, speculative, reddit. Repeatable. Default: all.
sincestringPost time >= (ISO-8601)
untilstringPost time < (ISO-8601)
has_imagebooleanlimitinteger · default50· min 1 · max 100cursorstringnext_cursor from the previous page
data[]: fields
idstringstatementstringpublished_atstring (date-time)Post time of the source article
indexed_atstring (date-time) | nullWhen the statement entered the API (null for older rows)
sentimentSentimentimportanceImportancesource_typeSourceTypesource_urlstring | nullsource_domainstringimage_urlstring | nullThe article's image as published (hotlink); null if none
symbolsstring[]Canonical codes of the entities named: tickers for equities and ETFs (NVDA, 0700.HK), curated codes otherwise (FED, US10Y, CRUDE, SPACEX)
entitiesEntity[]The symbols with their kind and name
sectorsstring[]GICS sectors (the 11), assigned per statement
topic_idstringtopic_namestring | nulltheme_idstring | null
curl -G "https://finance-pulse.p.rapidapi.com/v2/statements" \
--data-urlencode "symbol=NVDA" \
--data-urlencode "importance_min=high" \
--data-urlencode "limit=3" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: finance-pulse.p.rapidapi.com"
{
"data": [
{
"id": "c3341069-59d6-562d-8a9e-935cdc514665",
"statement": "Amazon is reportedly seeking investors for an $8 billion financing structure for Nvidia chips",
"published_at": "2026-10-02T10:29:29Z",
"indexed_at": "2026-10-02T10:42:04.715725Z",
"sentiment": "bullish",
"importance": "high",
"source_type": "news",
"source_url": "https://finance.yahoo.com/technology/ai/articles/amazon-reportedly-seeks-investors-8-102929408.html",
"source_domain": "finance.yahoo.com",
"image_url": "https://s.yimg.com/ny/mysterio/api/01795bc4f58861436819644f026638cbfdd2437e6e71782cc8c2e46b97cf9a8a/ynews/resizefill_w1200/https://media.zenfs.com/en/investorshub_458/35437a5a165ffeadb112d825c6043626.png",
"symbols": ["AMZN", "NVDA"],
"entities": [
{
"code": "AMZN",
"kind": "equity",
"name": "Amazon.com Inc",
"exchange": "NASDAQ",
"country": "USA"
},
{
"code": "NVDA",
"kind": "equity",
"name": "NVIDIA Corporation",
"exchange": "NASDAQ",
"country": "USA"
}
],
"sectors": ["InformationTechnology"],
"topic_id": "f14f34e4-ebdc-407a-a189-a1d6ad9134a6",
"topic_name": "Amazon offloads $8 billion of Nvidia chips to investors",
"theme_id": "7059ad1e-8ecb-52cc-99fd-c8457a534fda"
},
… 2 more
],
"next_cursor": "WzE3OTA5MzM4MjAsImMyZmE0YWU3LWQwNDEtNWEwZi1iNzc1LWNkYjMxYmY2NTlmYyJd",
"snapshot": {
"built_at": "2026-10-02T10:45:28.835156+00:00",
"anchor": "2026-10-02T10:45:28.835156+00:00",
"window_start": "2026-08-01T10:45:28.835156+00:00",
"lag_days": 0.0
}
}
#GET/v2/statements/{statement_id}v2
One statement
One statement by id, with its topic and theme.
Parameters
statement_idstring · required
data: fields
idstringstatementstringpublished_atstring (date-time)Post time of the source article
indexed_atstring (date-time) | nullWhen the statement entered the API (null for older rows)
sentimentSentimentimportanceImportancesource_typeSourceTypesource_urlstring | nullsource_domainstringimage_urlstring | nullThe article's image as published (hotlink); null if none
symbolsstring[]Canonical codes of the entities named: tickers for equities and ETFs (NVDA, 0700.HK), curated codes otherwise (FED, US10Y, CRUDE, SPACEX)
entitiesEntity[]The symbols with their kind and name
sectorsstring[]GICS sectors (the 11), assigned per statement
topic_idstringtopic_namestring | nulltheme_idstring | null
curl -G "https://finance-pulse.p.rapidapi.com/v2/statements/<statement id>" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: finance-pulse.p.rapidapi.com"
#GET/v2/feedv2
New statements since your last call
Statements in the order they ENTERED the API (oldest first), with the same filters as /v2/statements. Store next_cursor and pass it on the next call: nothing is missed or repeated, including articles that arrive late. Without a cursor the feed starts 24 hours back. next_cursor is always set; a new snapshot is built about every 2.5 minutes, so polling more often returns nothing new.
Parameters
symbolstring, repeatableSymbol, e.g. NVDA (see /v2/symbols). Repeat or comma-separate for several (OR), up to 10. Common aliases resolve: NVIDIA and NVDA match the same statements.
sectorstring, repeatableGICS sector, e.g. Energy (see /v2/meta for the 11). Repeatable.
theme_idstringtopic_idstringsentimentstring, repeatablebullish, bearish, neutral. Repeatable.
importance_minstringMinimum importance: low, medium, high, ultra
source_typestring, repeatablenews, speculative, reddit. Repeatable. Default: all.
limitinteger · default50· min 1 · max 100cursorstringnext_cursor from the previous page
data[]: fields
idstringstatementstringpublished_atstring (date-time)Post time of the source article
indexed_atstring (date-time) | nullWhen the statement entered the API (null for older rows)
sentimentSentimentimportanceImportancesource_typeSourceTypesource_urlstring | nullsource_domainstringimage_urlstring | nullThe article's image as published (hotlink); null if none
symbolsstring[]Canonical codes of the entities named: tickers for equities and ETFs (NVDA, 0700.HK), curated codes otherwise (FED, US10Y, CRUDE, SPACEX)
entitiesEntity[]The symbols with their kind and name
sectorsstring[]GICS sectors (the 11), assigned per statement
topic_idstringtopic_namestring | nulltheme_idstring | null
curl -G "https://finance-pulse.p.rapidapi.com/v2/feed" \
--data-urlencode "importance_min=high" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: finance-pulse.p.rapidapi.com"
{
"data": [
{
"id": "968d9741-d0e4-513c-b2b0-b9a09bca16c7",
"statement": "Nidec's new chief blames expansion drive and profit chase for write-downs",
"published_at": "2026-10-01T09:59:17Z",
"indexed_at": "2026-10-01T10:45:40.036283Z",
"sentiment": "bearish",
"importance": "high",
"source_type": "news",
"source_url": "https://asia.nikkei.com/business/companies/nidec-s-new-chief-blames-expansion-drive-profit-chase-for-write-downs",
"source_domain": "asia.nikkei.com",
"image_url": null,
"symbols": [],
"entities": [],
"sectors": ["Industrials"],
"topic_id": "2eb7ae7f-4b83-420d-a242-c5bd24dad40c",
"topic_name": "Nidec shares face downward pressure from accounting impairment and unending turmoil",
"theme_id": "c758f392-2a2d-56bb-9ab5-90913bce34d3"
},
… 1 more
],
"next_cursor": "WzI2NjU0NCwiOGM0ZDkzYjctMDI5ZC01YjVhLWJmNjEtZTNhNGU2Yjc2ZGNlIl0"
}
Signals
#GET/v2/seriesv2
Statement volume and sentiment over time
Hourly or daily buckets (UTC, zero-filled) of statement counts, sentiment counts, importance counts and distinct sources for exactly one of: symbol, sector, theme_id, topic_id. interval=hour covers at most 14 days.
Parameters
symbolstringsectorstringtheme_idstringtopic_idstringintervalstring · defaultday· one ofhour,daysincestringuntilstringsource_typestring, repeatablenews, speculative, reddit. Repeatable. Default: all.
importance_minstringMinimum importance: low, medium, high, ultra
data: fields
entitySeriesEntityintervalstringbucketsSeriesBucket[]
curl -G "https://finance-pulse.p.rapidapi.com/v2/series" \
--data-urlencode "symbol=NVDA" \
--data-urlencode "interval=day" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: finance-pulse.p.rapidapi.com"
{
"data": {
"entity": {
"type": "symbol",
"id": "NVDA",
"name": null
},
"interval": "day",
"buckets": [
{
"t": "2026-09-17T00:00:00Z",
"count": 22,
"bullish": 13,
"bearish": 3,
"neutral": 6,
"by_importance": {
"low": 4,
"medium": 8,
"high": 10,
"ultra": 0
},
"sources": 11,
"score": 0.4545
},
{
"t": "2026-09-18T00:00:00Z",
"count": 8,
"bullish": 4,
"bearish": 1,
"neutral": 3,
"by_importance": {
"low": 0,
"medium": 2,
"high": 6,
"ultra": 0
},
"sources": 3,
"score": 0.375
},
… 13 more
]
}
}
#GET/v2/symbolsv2
Symbols, with mention and sentiment statistics
Every entity mentioned in the period (tickers, indices, rates, currencies, crypto, commodities, organisations, private companies), with its kind and name, statements (mentions), topics, distinct sources, sentiment counts and the change against the period before. kind= narrows to some kinds (kind=equity,etf for tradable tickers); countries only appear when asked for. period: d = last 24 hours, w = last 7 days, window = everything the API holds.
Parameters
periodstring · defaultw· one ofd,w,windowsortstring · defaultmentions· one ofmentions,sources,score,changesectorstringOnly symbols named on statements of this sector
kindstring, repeatableEntity kinds, e.g. equity,etf. Repeatable.
min_mentionsinteger · default3· min 1limitinteger · default500· min 1 · max 20000
data[]: fields
idstringThe symbol or sector
kindequity | etf | index | rate | fx | crypto | commodity | org | private | country | nullSymbols: the entity's kind
namestring | nullSymbols: the entity's name
mentionsintegertopicsintegersourcesintegerbullishintegerbearishintegerneutralintegerscorenumber | nullmentions_prev_periodinteger | nullchangeinteger | nullmentions - mentions_prev_period
last_seenstring (date-time) | null
curl -G "https://finance-pulse.p.rapidapi.com/v2/symbols" \
--data-urlencode "period=d" \
--data-urlencode "sort=change" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: finance-pulse.p.rapidapi.com"
{
"data": [
{
"id": "MU",
"kind": "equity",
"name": "Micron Technology Inc",
"mentions": 60,
"topics": 20,
"sources": 24,
"bullish": 45,
"bearish": 5,
"neutral": 10,
"score": 0.6667,
"mentions_prev_period": 21,
"change": 39,
"last_seen": "2026-10-01T12:54:56Z"
},
{
"id": "US10Y",
"kind": "rate",
"name": "US 10-year Treasury yield",
"mentions": 28,
"topics": 10,
"sources": 14,
"bullish": 0,
"bearish": 27,
"neutral": 1,
"score": -0.9643,
"mentions_prev_period": 11,
"change": 17,
"last_seen": "2026-10-01T13:30:01Z"
},
… 60 more
],
"period": "d"
}
#GET/v2/sectorsv2
GICS sectors, with mention and sentiment statistics
The 11 GICS sectors with mentions, topics, distinct sources, sentiment counts and the change against the previous period (period=d|w|window).
Parameters
periodstring · defaultw· one ofd,w,windowsortstring · defaultmentions· one ofmentions,sources,score,change
data[]: fields
idstringThe symbol or sector
kindequity | etf | index | rate | fx | crypto | commodity | org | private | country | nullSymbols: the entity's kind
namestring | nullSymbols: the entity's name
mentionsintegertopicsintegersourcesintegerbullishintegerbearishintegerneutralintegerscorenumber | nullmentions_prev_periodinteger | nullchangeinteger | nullmentions - mentions_prev_period
last_seenstring (date-time) | null
curl -G "https://finance-pulse.p.rapidapi.com/v2/sectors" \
--data-urlencode "period=d" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: finance-pulse.p.rapidapi.com"
{
"data": [
{
"id": "Financials",
"mentions": 1038,
"topics": 773,
"sources": 130,
"bullish": 156,
"bearish": 348,
"neutral": 534,
"score": -0.185,
"mentions_prev_period": 898,
"change": 140,
"last_seen": "2026-10-01T11:20:32Z"
},
… 10 more
],
"period": "d"
}
Developments
#GET/v2/topicsv2
Topics (developments)
sort: recent (last statement), size (statements), oldest, velocity (statements in the last 24 h). ids= fetches up to 50 topics by id, e.g. the ones a feed page refers to.
Parameters
theme_idstringsymbolstring, repeatableSymbol, e.g. NVDA (see /v2/symbols). Repeat or comma-separate for several (OR), up to 10. Common aliases resolve: NVIDIA and NVDA match the same statements.
sectorstringidsstringComma-separated topic ids, up to 50
updated_sincestringLast statement at or after (ISO-8601)
min_statementsinteger · default1· min 1sortstring · defaultrecent· one ofrecent,size,oldest,velocitylimitinteger · default50· min 1 · max 100cursorstringnext_cursor from the previous page
data[]: fields
idstringnamestringtheme_idstring | nullcreated_atstring (date-time)updated_atstring (date-time)statementsintegerStatements in the API's window
total_statementsintegerStatements the topic has ever held
sourcesintegerDistinct source domains in the window
statements_24hintegerstatements_4hintegersentimentSentimentCountssentiment_scorenumber | null(bullish - bearish) / statements
symbolsstring[]Canonical codes of the entities named: tickers for equities and ETFs (NVDA, 0700.HK), curated codes otherwise (FED, US10Y, CRUDE, SPACEX)
entitiesEntity[]The symbols with their kind and name
sectorsstring[]GICS sectors (the 11), assigned per statement
latest_statementLatestStatement | nullstatements_7dintegerStatements of the last 7 days
revisionstring | nullChanges whenever the topic's name, counts, symbols, sectors or sentiment, or any of its last-7-day statements, change: compare it to skip refetching unchanged topics. Null if unavailable.
curl -G "https://finance-pulse.p.rapidapi.com/v2/topics" \
--data-urlencode "sort=velocity" \
--data-urlencode "limit=20" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: finance-pulse.p.rapidapi.com"
{
"data": [
{
"id": "5590ee87-9ed2-47e7-aeee-9104793eddcd",
"name": "Nike faces worst stock performance in decades",
"theme_id": "c758f392-2a2d-56bb-9ab5-90913bce34d3",
"created_at": "2026-05-03T04:50:42Z",
"updated_at": "2026-10-02T10:11:09Z",
"statements": 85,
"total_statements": 139,
"sources": 26,
"statements_24h": 38,
"statements_4h": 11,
"sentiment": {
"bullish": 1,
"bearish": 82,
"neutral": 2
},
"sentiment_score": -0.9529,
"symbols": ["NKE", "JPM"],
"entities": [
{
"code": "NKE",
"kind": "equity",
"name": "Nike Inc",
"exchange": "NYSE",
"country": "USA"
},
{
"code": "JPM",
"kind": "equity",
"name": "JPMorgan Chase & Co",
"exchange": "NYSE",
"country": "USA"
}
],
"sectors": ["ConsumerDiscretionary", "Financials"],
"latest_statement": {
"id": "a81a57dd-68ed-5480-a170-f293980b8aff",
"statement": "Nike shares are likely to continue falling as the company reports falling revenue and plans to lay off staff.",
"published_at": "2026-10-02T10:11:09Z",
"sentiment": "bearish",
"source_domain": "cnbc.com",
"image_url": null
},
"statements_7d": 49,
"revision": "5b7e4ebc7fd22f759f7af128049e3f14d7c66256aa1fdcb01a7b3cfdc966205b"
}
],
"next_cursor": "WzM4LCI1NTkwZWU4Ny05ZWQyLTQ3ZTctYWVlZS05MTA0NzkzZWRkY2QiXQ"
}
#GET/v2/topics/{topic_id}v2
One topic, its source mix and newest statements
One topic (development): counts, distinct sources, velocity, sentiment, its source mix, and its 20 newest statements with a cursor for the rest.
Parameters
topic_idstring · required
data: fields
idstringnamestringtheme_idstring | nullcreated_atstring (date-time)updated_atstring (date-time)statementsintegerStatements in the API's window
total_statementsintegerStatements the topic has ever held
sourcesintegerDistinct source domains in the window
statements_24hintegerstatements_4hintegersentimentSentimentCountssentiment_scorenumber | null(bullish - bearish) / statements
symbolsstring[]Canonical codes of the entities named: tickers for equities and ETFs (NVDA, 0700.HK), curated codes otherwise (FED, US10Y, CRUDE, SPACEX)
entitiesEntity[]The symbols with their kind and name
sectorsstring[]GICS sectors (the 11), assigned per statement
latest_statementLatestStatement | nullstatements_7dintegerStatements of the last 7 days
revisionstring | nullChanges whenever the topic's name, counts, symbols, sectors or sentiment, or any of its last-7-day statements, change: compare it to skip refetching unchanged topics. Null if unavailable.
source_mixobjectStatements per source_type
statements_pageStatement[]Newest statements (first page)
statements_cursorstring | nullContinue with /v2/statements?topic_id=..&cursor=..
curl -G "https://finance-pulse.p.rapidapi.com/v2/topics/<topic id>" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: finance-pulse.p.rapidapi.com"
{
"data": {
"id": "9206f8af-20b6-4c61-8548-00eacb11668e",
"name": "Eurozone inflation hits 3.8%",
"theme_id": "2f496e28-5742-517d-9805-c28ed1cc9135",
"created_at": "2026-06-02T16:40:42Z",
"updated_at": "2026-10-02T10:26:50Z",
"statements": 48,
"total_statements": 59,
"sources": 29,
"statements_24h": 35,
"statements_4h": 33,
"sentiment": {
"bullish": 0,
"bearish": 44,
"neutral": 4
},
"sentiment_score": -0.9167,
"symbols": ["EUR"],
"entities": [
{
"code": "EUR",
"kind": "fx",
"name": "Euro",
"exchange": null,
"country": null
}
],
"sectors": ["Energy"],
"latest_statement": {
"id": "a17a50bf-e04c-599f-8b95-7f18cfa1feba",
"statement": "Inflation in the eurozone increased by 3.8% in September compared to the same month last year.",
"published_at": "2026-10-02T10:26:50Z",
"sentiment": "bearish",
"source_domain": "df.cl",
"image_url": null
},
"statements_7d": 46,
"revision": "207aa498fa2424b1a39ed2774e65531f9dd23b0cab201670be477b5cc177abb3",
"source_mix": {
"news": 48
},
"statements_page": [
{
"id": "a17a50bf-e04c-599f-8b95-7f18cfa1feba",
"statement": "Inflation in the eurozone increased by 3.8% in September compared to the same month last year.",
"published_at": "2026-10-02T10:26:50Z",
"indexed_at": "2026-10-02T10:35:04.274090Z",
"sentiment": "bearish",
"importance": "high",
"source_type": "news",
"source_url": "https://www.df.cl/internacional/ft/la-inflacion-de-la-eurozona-se-dispara-en-septiembre-a-su-nivel-mas-alto-en",
"source_domain": "df.cl",
"image_url": null,
"symbols": [],
"entities": [],
"sectors": [],
"topic_id": "9206f8af-20b6-4c61-8548-00eacb11668e",
"topic_name": "Eurozone inflation hits 3.8%",
"theme_id": "2f496e28-5742-517d-9805-c28ed1cc9135"
},
… 19 more
],
"statements_cursor": "WzE3OTA5MzIyOTgsIjE2NTBmMmE3LTgwOTEtNTE0ZS05MGNlLTViNDY2ODc5MmQzYiJd"
}
}
#GET/v2/themesv2
Themes, optionally filtered by symbol or sector
All 19 themes with topic and statement counts, distinct sources, velocity and sentiment.
Parameters
symbolstring, repeatableSymbol, e.g. NVDA (see /v2/symbols). Repeat or comma-separate for several (OR), up to 10. Common aliases resolve: NVIDIA and NVDA match the same statements.
sectorstring, repeatableGICS sector, e.g. Energy (see /v2/meta for the 11). Repeatable.
sortstring · defaultsize· one ofsize,topics,recent,velocitysize (statements), topics, recent (last statement), velocity (24 h)
data[]: fields
idstringnamestringcreated_atstring (date-time)updated_atstring (date-time)topicsintegerstatementsintegertotal_topicsintegertotal_statementsintegersourcesintegerstatements_24hintegerstatements_4hintegersentimentSentimentCountssentiment_scorenumber | nullsymbolsstring[]Canonical codes of the entities named: tickers for equities and ETFs (NVDA, 0700.HK), curated codes otherwise (FED, US10Y, CRUDE, SPACEX)
entitiesEntity[]The symbols with their kind and name
sectorsstring[]GICS sectors (the 11), assigned per statement
curl -G "https://finance-pulse.p.rapidapi.com/v2/themes" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: finance-pulse.p.rapidapi.com"
{
"data": [
{
"id": "7059ad1e-8ecb-52cc-99fd-c8457a534fda",
"name": "Companies & earnings",
"created_at": "2026-05-01T00:05:42Z",
"updated_at": "2026-10-02T10:36:19Z",
"topics": 5945,
"statements": 14489,
"total_topics": 12520,
"total_statements": 52882,
"sources": 253,
"statements_24h": 962,
"statements_4h": 160,
"sentiment": {
"bullish": 6640,
"bearish": 2815,
"neutral": 5034
},
"sentiment_score": 0.264,
"symbols": ["NVDA", "MU", "META", "BRK-B", "AMZN", "AAPL", "PLTR", "MSFT"],
"entities": [
{
"code": "NVDA",
"kind": "equity",
"name": "NVIDIA Corporation",
"exchange": "NASDAQ",
"country": "USA"
},
{
"code": "MU",
"kind": "equity",
"name": "Micron Technology Inc",
"exchange": "NASDAQ",
"country": "USA"
},
{
"code": "META",
"kind": "equity",
"name": "Meta Platforms Inc.",
"exchange": "NASDAQ",
"country": "USA"
},
{
"code": "BRK-B",
"kind": "equity",
"name": "Berkshire Hathaway Inc",
"exchange": "NYSE",
"country": "USA"
},
{
"code": "AMZN",
"kind": "equity",
"name": "Amazon.com Inc",
"exchange": "NASDAQ",
"country": "USA"
},
{
"code": "AAPL",
"kind": "equity",
"name": "Apple Inc",
"exchange": "NASDAQ",
"country": "USA"
},
{
"code": "PLTR",
"kind": "equity",
"name": "Palantir Technologies Inc. Class A Common Stock",
"exchange": "NYSE",
"country": "USA"
},
{
"code": "MSFT",
"kind": "equity",
"name": "Microsoft Corporation",
"exchange": "NASDAQ",
"country": "USA"
}
],
"sectors": ["InformationTechnology", "Financials", "ConsumerDiscretionary", "HealthCare", "Energy", "Industrials", "CommunicationServices", "RealEstate"]
},
… 18 more
]
}
#GET/v2/themes/{theme_id}v2
One theme and its largest topics
One theme with its statistics and its 20 largest topics.
Parameters
theme_idstring · required
data: fields
idstringnamestringcreated_atstring (date-time)updated_atstring (date-time)topicsintegerstatementsintegertotal_topicsintegertotal_statementsintegersourcesintegerstatements_24hintegerstatements_4hintegersentimentSentimentCountssentiment_scorenumber | nullsymbolsstring[]Canonical codes of the entities named: tickers for equities and ETFs (NVDA, 0700.HK), curated codes otherwise (FED, US10Y, CRUDE, SPACEX)
entitiesEntity[]The symbols with their kind and name
sectorsstring[]GICS sectors (the 11), assigned per statement
top_topicsTopic[]Largest topics; more via /v2/topics?theme_id=
curl -G "https://finance-pulse.p.rapidapi.com/v2/themes/<theme id>" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: finance-pulse.p.rapidapi.com"
#GET/v2/trendingv2
What is popping up now
The developments the most outlets picked up: the live list (last 2 hours), then the top 10 per 2-hour UTC slot over the last 7 days, each with its labels, sources, velocity and newest statement. One response, at most 300 topics.
Parameters
theme_idstringsymbolstringkindstring · one oflive,slot
data[]: fields
idstringnamestringtheme_idstring | nullcreated_atstring (date-time)updated_atstring (date-time)statementsintegerStatements in the API's window
total_statementsintegerStatements the topic has ever held
sourcesintegerDistinct source domains in the window
statements_24hintegerstatements_4hintegersentimentSentimentCountssentiment_scorenumber | null(bullish - bearish) / statements
symbolsstring[]Canonical codes of the entities named: tickers for equities and ETFs (NVDA, 0700.HK), curated codes otherwise (FED, US10Y, CRUDE, SPACEX)
entitiesEntity[]The symbols with their kind and name
sectorsstring[]GICS sectors (the 11), assigned per statement
latest_statementLatestStatement | nullstatements_7dintegerStatements of the last 7 days
revisionstring | nullChanges whenever the topic's name, counts, symbols, sectors or sentiment, or any of its last-7-day statements, change: compare it to skip refetching unchanged topics. Null if unavailable.
positionintegertrendingTrendingLabel[]
curl -G "https://finance-pulse.p.rapidapi.com/v2/trending" \
--data-urlencode "kind=live" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: finance-pulse.p.rapidapi.com"
{
"data": [
{
"id": "9206f8af-20b6-4c61-8548-00eacb11668e",
"name": "Eurozone inflation hits 3.8%",
"theme_id": "2f496e28-5742-517d-9805-c28ed1cc9135",
"created_at": "2026-06-02T16:40:42Z",
"updated_at": "2026-10-02T10:26:50Z",
"statements": 48,
"total_statements": 59,
"sources": 29,
"statements_24h": 35,
"statements_4h": 33,
"sentiment": {
"bullish": 0,
"bearish": 44,
"neutral": 4
},
"sentiment_score": -0.9167,
"symbols": ["EUR"],
"entities": [
{
"code": "EUR",
"kind": "fx",
"name": "Euro",
"exchange": null,
"country": null
}
],
"sectors": ["Energy"],
"latest_statement": {
"id": "a17a50bf-e04c-599f-8b95-7f18cfa1feba",
"statement": "Inflation in the eurozone increased by 3.8% in September compared to the same month last year.",
"published_at": "2026-10-02T10:26:50Z",
"sentiment": "bearish",
"source_domain": "df.cl",
"image_url": null
},
"statements_7d": 46,
"revision": "207aa498fa2424b1a39ed2774e65531f9dd23b0cab201670be477b5cc177abb3",
"position": 1,
"trending": [
{
"kind": "live",
"slot_start": null,
"rank": 1,
"sources": 25,
"statements": 32
},
{
"kind": "slot",
"slot_start": "2026-10-02T08:00:00+00:00",
"rank": 1,
"sources": 23,
"statements": 27
}
]
},
… 9 more
]
}
Utility
#GET/v2/metav2
Counts, window and the accepted values
The window the API covers, counts, freshness (lag_days), how often data is rebuilt, and every accepted filter value (sentiments, importances, source types, sectors, entity kinds, themes).
Parameters
No parameters.
fields
dataobjectsnapshotSnapshot
curl -G "https://finance-pulse.p.rapidapi.com/v2/meta" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: finance-pulse.p.rapidapi.com"
{
"data": {
"anchor": "2026-10-01T11:32:53.957423+00:00",
"built_at": "2026-10-01T11:32:53.957423+00:00",
"lag_days": "0.00",
"newest_statement": "2026-10-01T11:29:02+00:00",
"statements": 75026,
"themes": 19,
"topics": 31490,
"window_days": 62,
"window_start": "2026-07-31T11:32:53.957423+00:00",
"build_interval_seconds": 150,
"incidents": [
{
"kind": "outage",
"started_at": "2026-08-20T11:58:00+00:00",
"ended_at": "2026-09-16T12:55:00+00:00",
"scope": "news ingestion",
"summary": "News sources were not collected; only Reddit, arXiv and PubMed items exist for this period."
},
{
"kind": "delay",
"started_at": "2026-09-26T06:00:00+00:00",
"ended_at": "2026-09-27T15:00:00+00:00",
"scope": "statement extraction",
"summary": "News was collected on time but turned into statements up to ~26 hours late."
},
{
"kind": "delay",
"started_at": "2026-09-29T07:20:00+00:00",
"ended_at": "2026-09-29T10:40:00+00:00",
"scope": "topic clustering",
"summary": "Statements were extracted but joined topics up to ~3 hours late."
},
{
"kind": "delay",
"started_at": "2026-09-30T14:00:00+00:00",
"ended_at": "2026-09-30T15:00:00+00:00",
"scope": "statement extraction",
"summary": "Some news turned into statements up to ~3 hours late while newly added sources were backfilled."
}
]
}
}
Health
#GET/health
Check API health
200 when the API has data to serve, 503 otherwise. No key required. Data freshness is reported by /v2/meta (lag_days), not here.
Parameters
No parameters.
curl -G "https://finance-pulse.p.rapidapi.com/health" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: finance-pulse.p.rapidapi.com"