---
title: "SEC Sentiment Analysis"
method: GET
path: "/stock/filings-sentiment"
tags: ["Default"]
---

# SEC Sentiment Analysis

`GET /stock/filings-sentiment`

## Request

- Base URL: `https://finnhub.io/api/v1`
- URL: `https://finnhub.io/api/v1/stock/filings-sentiment`
- Auth: API key in query parameter `token`

Get sentiment analysis of 10-K and 10-Q filings from SEC. An abnormal increase in the number of positive/negative words in filings can signal a significant change in the company's stock price in the upcoming 4 quarters. We make use of <a href= "https://sraf.nd.edu/textual-analysis/resources/" target="_blank">Loughran and McDonald Sentiment Word Lists</a> to calculate the sentiment for each filing.

## Query parameters

- `accessNumber` string, required

## Response `200`

successful operation

- SECSentimentAnalysis
  - `accessNumber` string: Access number.
  - `symbol` string: Symbol.
  - `cik` string: CIK.
  - `sentiment` FilingSentiment
    - `negative` number, float: % of negative words in the filing.
    - `positive` number, float: % of positive words in the filing.
    - `polarity` number, float: % of polarity words in the filing.
    - `litigious` number, float: % of litigious words in the filing.
    - `uncertainty` number, float: % of uncertainty words in the filing.
    - `constraining` number, float: % of constraining words in the filing.
    - `modal-weak` number, float: % of modal-weak words in the filing.
    - `modal-strong` number, float: % of modal-strong words in the filing.
    - `modal-moderate` number, float: % of modal-moderate words in the filing.

## Changes

- **2021-07-23** `a148c0b2d583`: 1 info
  - endpoint added
- **2020-05-26** `c5b8e420b78c`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/changes/stock/filings-sentiment/get.md)

---

[API](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api.md) - [All operations](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/revisions/415b27331384?raw)