fintopic.

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.

Endpoints

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, repeatable

    Symbol, 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, repeatable

    GICS sector, e.g. Energy (see /v2/meta for the 11). Repeatable.

  • theme_idstring
  • topic_idstring
  • sentimentstring, repeatable

    bullish, bearish, neutral. Repeatable.

  • importance_minstring

    Minimum importance: low, medium, high, ultra

  • source_typestring, repeatable

    news, speculative, reddit. Repeatable. Default: all.

  • sincestring

    Post time >= (ISO-8601)

  • untilstring

    Post time < (ISO-8601)

  • has_imageboolean
  • limitinteger · default 50 · min 1 · max 100
  • cursorstring

    next_cursor from the previous page

data[]: fields

  • idstring
  • statementstring
  • published_atstring (date-time)

    Post time of the source article

  • indexed_atstring (date-time) | null

    When the statement entered the API (null for older rows)

  • sentimentSentiment
  • importanceImportance
  • source_typeSourceType
  • source_urlstring | null
  • source_domainstring
  • image_urlstring | null

    The 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_idstring
  • topic_namestring | null
  • theme_idstring | null
curl
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"
Response · captured 2 Oct 2026 10:46 UTC
{
  "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

  • idstring
  • statementstring
  • published_atstring (date-time)

    Post time of the source article

  • indexed_atstring (date-time) | null

    When the statement entered the API (null for older rows)

  • sentimentSentiment
  • importanceImportance
  • source_typeSourceType
  • source_urlstring | null
  • source_domainstring
  • image_urlstring | null

    The 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_idstring
  • topic_namestring | null
  • theme_idstring | null
curl
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, repeatable

    Symbol, 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, repeatable

    GICS sector, e.g. Energy (see /v2/meta for the 11). Repeatable.

  • theme_idstring
  • topic_idstring
  • sentimentstring, repeatable

    bullish, bearish, neutral. Repeatable.

  • importance_minstring

    Minimum importance: low, medium, high, ultra

  • source_typestring, repeatable

    news, speculative, reddit. Repeatable. Default: all.

  • limitinteger · default 50 · min 1 · max 100
  • cursorstring

    next_cursor from the previous page

data[]: fields

  • idstring
  • statementstring
  • published_atstring (date-time)

    Post time of the source article

  • indexed_atstring (date-time) | null

    When the statement entered the API (null for older rows)

  • sentimentSentiment
  • importanceImportance
  • source_typeSourceType
  • source_urlstring | null
  • source_domainstring
  • image_urlstring | null

    The 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_idstring
  • topic_namestring | null
  • theme_idstring | null
curl
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"
Response · captured 2 Oct 2026 10:46 UTC
{
  "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

  • symbolstring
  • sectorstring
  • theme_idstring
  • topic_idstring
  • intervalstring · default day · one of hour, day
  • sincestring
  • untilstring
  • source_typestring, repeatable

    news, speculative, reddit. Repeatable. Default: all.

  • importance_minstring

    Minimum importance: low, medium, high, ultra

data: fields

  • entitySeriesEntity
  • intervalstring
  • bucketsSeriesBucket[]
curl
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"
Response · captured 1 Oct 2026 11:34 UTC
{
  "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 · default w · one of d, w, window
  • sortstring · default mentions · one of mentions, sources, score, change
  • sectorstring

    Only symbols named on statements of this sector

  • kindstring, repeatable

    Entity kinds, e.g. equity,etf. Repeatable.

  • min_mentionsinteger · default 3 · min 1
  • limitinteger · default 500 · min 1 · max 20000

data[]: fields

  • idstring

    The symbol or sector

  • kindequity | etf | index | rate | fx | crypto | commodity | org | private | country | null

    Symbols: the entity's kind

  • namestring | null

    Symbols: the entity's name

  • mentionsinteger
  • topicsinteger
  • sourcesinteger
  • bullishinteger
  • bearishinteger
  • neutralinteger
  • scorenumber | null
  • mentions_prev_periodinteger | null
  • changeinteger | null

    mentions - mentions_prev_period

  • last_seenstring (date-time) | null
curl
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"
Response · captured 1 Oct 2026 13:37 UTC
{
  "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 · default w · one of d, w, window
  • sortstring · default mentions · one of mentions, sources, score, change

data[]: fields

  • idstring

    The symbol or sector

  • kindequity | etf | index | rate | fx | crypto | commodity | org | private | country | null

    Symbols: the entity's kind

  • namestring | null

    Symbols: the entity's name

  • mentionsinteger
  • topicsinteger
  • sourcesinteger
  • bullishinteger
  • bearishinteger
  • neutralinteger
  • scorenumber | null
  • mentions_prev_periodinteger | null
  • changeinteger | null

    mentions - mentions_prev_period

  • last_seenstring (date-time) | null
curl
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"
Response · captured 1 Oct 2026 11:34 UTC
{
  "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_idstring
  • symbolstring, repeatable

    Symbol, 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
  • idsstring

    Comma-separated topic ids, up to 50

  • updated_sincestring

    Last statement at or after (ISO-8601)

  • min_statementsinteger · default 1 · min 1
  • sortstring · default recent · one of recent, size, oldest, velocity
  • limitinteger · default 50 · min 1 · max 100
  • cursorstring

    next_cursor from the previous page

data[]: fields

  • idstring
  • namestring
  • theme_idstring | null
  • created_atstring (date-time)
  • updated_atstring (date-time)
  • statementsinteger

    Statements in the API's window

  • total_statementsinteger

    Statements the topic has ever held

  • sourcesinteger

    Distinct source domains in the window

  • statements_24hinteger
  • statements_4hinteger
  • sentimentSentimentCounts
  • sentiment_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 | null
  • statements_7dinteger

    Statements of the last 7 days

  • revisionstring | null

    Changes 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
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"
Response · captured 2 Oct 2026 10:46 UTC
{
  "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

  • idstring
  • namestring
  • theme_idstring | null
  • created_atstring (date-time)
  • updated_atstring (date-time)
  • statementsinteger

    Statements in the API's window

  • total_statementsinteger

    Statements the topic has ever held

  • sourcesinteger

    Distinct source domains in the window

  • statements_24hinteger
  • statements_4hinteger
  • sentimentSentimentCounts
  • sentiment_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 | null
  • statements_7dinteger

    Statements of the last 7 days

  • revisionstring | null

    Changes 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_mixobject

    Statements per source_type

  • statements_pageStatement[]

    Newest statements (first page)

  • statements_cursorstring | null

    Continue with /v2/statements?topic_id=..&cursor=..

curl
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"
Response · captured 2 Oct 2026 10:46 UTC
{
  "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, repeatable

    Symbol, 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, repeatable

    GICS sector, e.g. Energy (see /v2/meta for the 11). Repeatable.

  • sortstring · default size · one of size, topics, recent, velocity

    size (statements), topics, recent (last statement), velocity (24 h)

data[]: fields

  • idstring
  • namestring
  • created_atstring (date-time)
  • updated_atstring (date-time)
  • topicsinteger
  • statementsinteger
  • total_topicsinteger
  • total_statementsinteger
  • sourcesinteger
  • statements_24hinteger
  • statements_4hinteger
  • sentimentSentimentCounts
  • sentiment_scorenumber | null
  • 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

curl
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"
Response · captured 2 Oct 2026 10:46 UTC
{
  "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

  • idstring
  • namestring
  • created_atstring (date-time)
  • updated_atstring (date-time)
  • topicsinteger
  • statementsinteger
  • total_topicsinteger
  • total_statementsinteger
  • sourcesinteger
  • statements_24hinteger
  • statements_4hinteger
  • sentimentSentimentCounts
  • sentiment_scorenumber | null
  • 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

  • top_topicsTopic[]

    Largest topics; more via /v2/topics?theme_id=

curl
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"

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

  • dataobject
  • snapshotSnapshot
curl
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"
Response · captured 1 Oct 2026 11:34 UTC
{
  "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
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"