Skip to main content
GET
/
v1
/
companies
/
{cik}
/
sentiment
/
trend
Sentiment trend for a company over time
curl --request GET \
  --url https://api.ivory.finance/v1/companies/{cik}/sentiment/trend \
  --header 'X-API-Key: <api-key>'
{
  "cik": "<string>",
  "granularity": "<string>",
  "series": [
    {
      "period": "2023-11-07T05:31:56Z",
      "filings_count": 123,
      "avg_v_negative": 123,
      "avg_negative": 123,
      "avg_neutral": 123,
      "avg_positive": 123,
      "avg_v_positive": 123,
      "avg_sentiment_score": 123,
      "dominant_label": "<string>"
    }
  ],
  "company_name": "<string>",
  "ticker": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.ivory.finance/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-API-Key
string
header
required

Path Parameters

cik
string
required

Query Parameters

granularity
string
default:month

Bucketing period: day | week | month | quarter | year

form_type
string | null

Filter by form type, e.g. 10-K, 10-Q

from_date
string | null

Start date YYYY-MM-DD

to_date
string | null

End date YYYY-MM-DD

Response

Successful Response

cik
string
required
granularity
string
required
series
FilingSentimentTrendBucket · object[]
required
company_name
string | null
ticker
string | null