Massive (formerly Polygon.io) Reference:news API

openapi: 3.2.0
info:
  description: The future of fintech.
  title: Polygon Reference:news API
  version: 1.0.0
servers:
- description: Polygon Platform API
  url: https://api.polygon.io
- description: Polygon Platform API (Staging)
  url: https://api.staging.polygon.io
security:
- apiKey: []
tags:
- name: reference:news
paths:
  /v2/reference/news:
    get:
      description: Get the most recent news articles relating to a stock ticker symbol, including a summary of the article and a link to the original source.
      operationId: ListNews
      parameters:
      - description: Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.
        in: query
        name: ticker
        schema:
          description: The exchange symbol that this item is traded under.
          type: string
        x-polygon-filter-field:
          range: true
      - description: Return results published on, before, or after this date.
        in: query
        name: published_utc
        schema:
          oneOf:
          - format: date-time
            type: string
          - format: date
            type: string
        x-polygon-filter-field:
          range: true
      - description: Search by ticker.
        in: query
        name: ticker.gte
        schema:
          description: The exchange symbol that this item is traded under.
          type: string
      - description: Search by ticker.
        in: query
        name: ticker.gt
        schema:
          description: The exchange symbol that this item is traded under.
          type: string
      - description: Search by ticker.
        in: query
        name: ticker.lte
        schema:
          description: The exchange symbol that this item is traded under.
          type: string
      - description: Search by ticker.
        in: query
        name: ticker.lt
        schema:
          description: The exchange symbol that this item is traded under.
          type: string
      - description: Search by published_utc.
        in: query
        name: published_utc.gte
        schema:
          oneOf:
          - format: date-time
            type: string
          - format: date
            type: string
      - description: Search by published_utc.
        in: query
        name: published_utc.gt
        schema:
          oneOf:
          - format: date-time
            type: string
          - format: date
            type: string
      - description: Search by published_utc.
        in: query
        name: published_utc.lte
        schema:
          oneOf:
          - format: date-time
            type: string
          - format: date
            type: string
      - description: Search by published_utc.
        in: query
        name: published_utc.lt
        schema:
          oneOf:
          - format: date-time
            type: string
          - format: date
            type: string
      - description: Order results based on the `sort` field.
        in: query
        name: order
        schema:
          enum:
          - asc
          - desc
          example: asc
          type: string
      - description: Limit the number of results returned, default is 10 and max is 1000.
        in: query
        name: limit
        schema:
          default: 10
          example: 10
          maximum: 1000
          minimum: 1
          type: integer
      - description: Sort field used for ordering.
        in: query
        name: sort
        schema:
          default: published_utc
          enum:
          - published_utc
          example: published_utc
          type: string
      responses:
        '200':
          content:
            application/json:
              example:
                count: 1
                next_url: https://api.polygon.io:443/v2/reference/news?cursor=eyJsaW1pdCI6MSwic29ydCI6InB1Ymxpc2hlZF91dGMiLCJvcmRlciI6ImFzY2VuZGluZyIsInRpY2tlciI6e30sInB1Ymxpc2hlZF91dGMiOnsiZ3RlIjoiMjAyMS0wNC0yNiJ9LCJzZWFyY2hfYWZ0ZXIiOlsxNjE5NDA0Mzk3MDAwLG51bGxdfQ
                request_id: 831afdb0b8078549fed053476984947a
                results:
                - amp_url: https://m.uk.investing.com/news/stock-market-news/markets-are-underestimating-fed-cuts-ubs-3559968?ampMode=1
                  article_url: https://uk.investing.com/news/stock-market-news/markets-are-underestimating-fed-cuts-ubs-3559968
                  author: Sam Boughedda
                  description: UBS analysts warn that markets are underestimating the extent of future interest rate cuts by the Federal Reserve, as the weakening economy is likely to justify more cuts than currently anticipated.
                  id: 8ec638777ca03b553ae516761c2a22ba2fdd2f37befae3ab6fdab74e9e5193eb
                  image_url: https://i-invdn-com.investing.com/news/LYNXNPEC4I0AL_L.jpg
                  insights:
                  - sentiment: positive
                    sentiment_reasoning: UBS analysts are providing a bullish outlook on the extent of future Federal Reserve rate cuts, suggesting that markets are underestimating the number of cuts that will occur.
                    ticker: UBS
                  keywords:
                  - Federal Reserve
                  - interest rates
                  - economic data
                  published_utc: '2024-06-24T18:33:53Z'
                  publisher:
                    favicon_url: https://s3.polygon.io/public/assets/news/favicons/investing.ico
                    homepage_url: https://www.investing.com/
                    logo_url: https://s3.polygon.io/public/assets/news/logos/investing.png
                    name: Investing.com
                  tickers:
                  - UBS
                  title: 'Markets are underestimating Fed cuts: UBS By Investing.com - Investing.com UK'
                status: OK
              schema:
                properties:
                  count:
                    description: The total number of results for this request.
                    type: integer
                  next_url:
                    description: If present, this value can be used to fetch the next page of data.
                    type: string
                  request_id:
                    description: A request id assigned by the server.
                    type: string
                  results:
                    description: An array of results containing the requested data.
                    items:
                      properties:
                        amp_url:
                          description: The mobile friendly Accelerated Mobile Page (AMP) URL.
                          type: string
                        article_url:
                          description: A link to the news article.
                          type: string
                        author:
                          description: The article's author.
                          type: string
                        description:
                          description: A description of the article.
                          type: string
                        id:
                          description: Unique identifier for the article.
                          type: string
                        image_url:
                          description: The article's image URL.
                          type: string
                        insights:
                          description: The insights related to the article.
                          items:
                            properties:
                              sentiment:
                                description: The sentiment of the insight.
                                enum:
                                - positive
                                - neutral
                                - negative
                                type: string
                              sentiment_reasoning:
                                description: The reasoning behind the sentiment.
                                type: string
                              ticker:
                                description: The ticker symbol associated with the insight.
                                type: string
                            required:
                            - ticker
                            - sentiment
                            - sentiment_reasoning
                            type: object
                          type: array
                        keywords:
                          description: 'The keywords associated with the article (which will vary depending on

                            the publishing source).'
                          items:
                            type: string
                          type: array
                        published_utc:
                          description: The UTC date and time when the article was published, formatted in RFC3339 standard (e.g. YYYY-MM-DDTHH:MM:SSZ).
                          format: date-time
                          type: string
                        publisher:
                          description: Details the source of the news article, including the publisher's name, logo, and homepage URLs. This information helps users identify and access the original source of news content.
                          properties:
                            favicon_url:
                              description: The publisher's homepage favicon URL.
                              type: string
                            homepage_url:
                              description: The publisher's homepage URL.
                              type: string
                            logo_url:
                              description: The publisher's logo URL.
                              type: string
                            name:
                              description: The publisher's name.
                              type: string
                          required:
                          - name
                          - logo_url
                          - homepage_url
                          type: object
                        tickers:
                          description: The ticker symbols associated with the article.
                          items:
                            description: The exchange symbol that this item is traded under.
                            type: string
                          type: array
                        title:
                          description: The title of the news article.
                          type: string
                      required:
                      - id
                      - publisher
                      - title
                      - author
                      - published_utc
                      - article_url
                      - tickers
                      type: object
                      x-polygon-go-type:
                        name: NewsArticleMetadata
                        path: github.com/polygon-io/go-lib-models/v2/globals
                    type: array
                    x-polygon-go-type:
                      name: ListNewsArticlesResults
                  status:
                    description: The status of this request's response.
                    type: string
                type: object
            text/csv:
              example: 'id,publisher_name,publisher_homepage_url,publisher_logo_url,publisher_favicon_url,title,author,published_utc,article_url,ticker,amp_url,image_url,description,keywords,sentiment,sentiment_reasoning

                8ec638777ca03b553ae516761c2a22ba2fdd2f37befae3ab6fdab74e9e5193eb,Investing.com,https://www.investing.com/,https://s3.polygon.io/public/assets/news/logos/investing.png,https://s3.polygon.io/public/assets/news/favicons/investing.ico,Markets are underestimating Fed cuts: UBS By Investing.com - Investing.com UK,Sam Boughedda,1719254033000000000,https://uk.investing.com/news/stock-market-news/markets-are-underestimating-fed-cuts-ubs-3559968,UBS,https://m.uk.investing.com/news/stock-market-news/markets-are-underestimating-fed-cuts-ubs-3559968?ampMode=1,https://i-invdn-com.investing.com/news/LYNXNPEC4I0AL_L.jpg,"UBS analysts warn that markets are underestimating the extent of future interest rate cuts by the Federal Reserve, as the weakening economy is likely to justify more cuts than currently anticipated.","Federal Reserve,interest rates,economic data",positive,"UBS analysts are providing a bullish outlook on the extent of future Federal Reserve rate cuts, suggesting that markets are underestimating the number of cuts that will occur."

                '
              schema:
                type: string
          description: An array of news articles.
        '401':
          description: Unauthorized - Check our API Key and account status
        '404':
          description: The specified resource was not found
      summary: Ticker News
      tags:
      - reference:news
      x-polygon-entitlement-data-type:
        description: Reference data
        name: reference
      x-polygon-paginate:
        order:
          example: desc
        sort:
          default: published_utc
          enum:
          - published_utc
          limit:
            default: 10
            maximum: 1000
            minimum: 1
components:
  securitySchemes:
    apiKey:
      in: query
      name: apiKey
      type: apiKey
x-polygon-order:
  crypto:
    market:
    - launchpad: shared
      paths:
      - /v2/aggs/ticker/{cryptoTicker}/range/{multiplier}/{timespan}/{from}/{to}
    - launchpad: exclusive
      paths:
      - /v1/summaries
    - paths:
      - /v2/aggs/grouped/locale/global/market/crypto/{date}
    - paths:
      - /v1/open-close/crypto/{from}/{to}/{date}
    - paths:
      - /v2/aggs/ticker/{cryptoTicker}/prev
    - paths:
      - /v3/trades/{cryptoTicker}
    - paths:
      - /v1/historic/crypto/{from}/{to}/{date}
    - paths:
      - /v1/last/crypto/{from}/{to}
    - group: Snapshots
      paths:
      - /v2/snapshot/locale/global/markets/crypto/tickers
      - /v2/snapshot/locale/global/markets/crypto/{direction}
      - /v2/snapshot/locale/global/markets/crypto/tickers/{ticker}
      - /v2/snapshot/locale/global/markets/crypto/tickers/{ticker}/book
      - /v3/snapshot
    - group: Technical Indicators
      paths:
      - /v1/indicators/sma/{cryptoTicker}
      - /v1/indicators/ema/{cryptoTicker}
      - /v1/indicators/macd/{cryptoTicker}
      - /v1/indicators/rsi/{cryptoTicker}
    reference:
    - paths:
      - /v3/reference/tickers
    - paths:
      - /v1/marketstatus/upcoming
    - paths:
      - /v1/marketstatus/now
    - paths:
      - /v3/reference/conditions
    - paths:
      - /v3/reference/exchanges
  fx:
    market:
    - launchpad: shared
      paths:
      - /v2/aggs/ticker/{forexTicker}/range/{multiplier}/{timespan}/{from}/{to}
    - launchpad: exclusive
      paths:
      - /v1/summaries
    - paths:
      - /v2/aggs/grouped/locale/global/market/fx/{date}
    - paths:
      - /v2/aggs/ticker/{forexTicker}/prev
    - paths:
      - /v3/quotes/{fxTicker}
    - paths:
      - /v1/historic/forex/{from}/{to}/{date}
    - paths:
      - /v1/last_quote/currencies/{from}/{to}
    - paths:
      - /v1/conversion/{from}/{to}
    - group: Snapshots
      paths:
      - /v2/snapshot/locale/global/markets/forex/tickers
      - /v2/snapshot/locale/global/markets/forex/{direction}
      - /v2/snapshot/locale/global/markets/forex/tickers/{ticker}
      - /v3/snapshot
    - group: Technical Indicators
      paths:
      - /v1/indicators/sma/{fxTicker}
      - /v1/indicators/ema/{fxTicker}
      - /v1/indicators/macd/{fxTicker}
      - /v1/indicators/rsi/{fxTicker}
    reference:
    - paths:
      - /v3/reference/tickers
    - paths:
      - /v1/marketstatus/upcoming
    - paths:
      - /v1/marketstatus/now
    - paths:
      - /v3/reference/conditions
    - paths:
      - /v3/reference/exchanges
  indices:
    market:
    - launchpad: shared
      paths:
      - /v2/aggs/ticker/{indicesTicker}/range/{multiplier}/{timespan}/{from}/{to}
    - paths:
      - /v2/aggs/ticker/{indicesTicker}/prev
    - paths:
      - /v1/open-close/{indicesTicker}/{date}
    - group: Technical Indicators
      paths:
      - /v1/indicators/sma/{indicesTicker}
      - /v1/indicators/ema/{indicesTicker}
      - /v1/indicators/macd/{indicesTicker}
      - /v1/indicators/rsi/{indicesTicker}
    - group: Snapshots
      paths:
      - /v3/snapshot/indices
      - /v3/snapshot
    reference:
    - paths:
      - /v3/reference/tickers
    - paths:
      - /v3/reference/tickers/types
    - paths:
      - /v1/marketstatus/upcoming
    - paths:
      - /v1/marketstatus/now
  options:
    market:
    - launchpad: shared
      paths:
      - /v2/aggs/ticker/{optionsTicker}/range/{multiplier}/{timespan}/{from}/{to}
    - launchpad: exclusive
      paths:
      - /v1/summaries
    - paths:
      - /v1/open-close/{optionsTicker}/{date}
    - paths:
      - /v2/aggs/ticker/{optionsTicker}/prev
    - paths:
      - /v3/trades/{optionsTicker}
    - paths:
      - /v2/last/trade/{optionsTicker}
    - paths:
      - /v3/quotes/{optionsTicker}
    - group: Snapshots
      paths:
      - /v3/snapshot/options/{underlyingAsset}/{optionContract}
      - /v3/snapshot/options/{underlyingAsset}
      - /v3/snapshot
    - group: Technical Indicators
      paths:
      - /v1/indicators/sma/{optionsTicker}
      - /v1/indicators/ema/{optionsTicker}
      - /v1/indicators/macd/{optionsTicker}
      - /v1/indicators/rsi/{optionsTicker}
    reference:
    - paths:
      - /v3/reference/options/contracts/{options_ticker}
    - paths:
      - /v3/reference/options/contracts
    - paths:
      - /v3/reference/tickers
    - paths:
      - /v1/meta/symbols/{stocksTicker}/company
    - paths:
      - /v3/reference/tickers/{ticker}
    - paths:
      - /v2/reference/news
    - paths:
      - /v3/reference/tickers/types
    - paths:
      - /v1/marketstatus/upcoming
    - paths:
      - /v1/marketstatus/now
    - paths:
      - /v3/reference/conditions
    - paths:
      - /v3/reference/exchanges
  stocks:
    market:
    - launchpad: shared
      paths:
      - /v2/aggs/ticker/{stocksTicker}/range/{multiplier}/{timespan}/{from}/{to}
    - launchpad: exclusive
      paths:
      - /v1/summaries
    - paths:
      - /v2/aggs/grouped/locale/us/market/stocks/{date}
    - paths:
      - /v1/open-close/{stocksTicker}/{date}
    - paths:
      - /v2/aggs/ticker/{stocksTicker}/prev
    - paths:
      - /v3/trades/{stockTicker}
    - paths:
      - /v2/ticks/stocks/trades/{ticker}/{date}
    - paths:
      - /v2/last/trade/{stocksTicker}
    - paths:
      - /v3/quotes/{stockTicker}
    - paths:
      - /v2/ticks/stocks/nbbo/{ticker}/{date}
    - paths:
      - /v2/last/nbbo/{stocksTicker}
    - group: Snapshots
      paths:
      - /v2/snapshot/locale/us/markets/stocks/tickers
      - /v2/snapshot/locale/us/markets/stocks/{direction}
      - /v2/snapshot/locale/us/markets/stocks/tickers/{stocksTicker}
      - /v3/snapshot
    - group: Technical Indicators
      paths:
      - /v1/indicators/sma/{stockTicker}
      - /v1/indicators/ema/{stockTicker}
      - /v1/indicators/macd/{stockTicker}
      - /v1/indicators/rsi/{stockTicker}
    reference:
    - paths:
      - /v3/reference/tickers
    - paths:
      - /v1/meta/symbols/{stocksTicker}/company
    - paths:
      - /v3/reference/tickers/{ticker}
    - paths:
      - /vX/reference/tickers/{id}/events
    - paths:
      - /v2/reference/news
    - paths:
      - /v3/reference/tickers/types
    - paths:
      - /vX/reference/tickers/taxonomies
    - paths:
      - /v1/marketstatus/upcoming
    - paths:
      - /v1/marketstatus/now
    - group: SEC Filings
      paths:
      - /v1/reference/sec/filings
      - /v1/reference/sec/filings/{filing_id}
      - /v1/reference/sec/filings/{filing_id}/files
      - /v1/reference/sec/filings/{filing_id}/files/{file_id}
    - paths:
      - /v3/reference/splits
    - paths:
      - /v3/reference/dividends
    - paths:
      - /vX/reference/financials
    - paths:
      - /v3/reference/conditions
    - paths:
      - /v3/reference/exchanges
    - paths:
      - /v1/related-companies/{ticker}
    - paths:
      - /vX/reference/ipos
    - paths:
      - /vX/reference/short-interest/{identifier_type}/{identifier}
    - paths:
      - stocks/vX/listings
      - stocks/vX/listing/{identifier_type}/{identifier}
      - stocks/vX/listings/updates