ADadanos
Finance Sentiment

Analyze finance sentiment

Changed on

Professional account required. Free and Hobby accounts cannot use this endpoint.

Returns the sentiment of one financial text, such as a news headline or a sentence about a company. Pass target (for example Apple or AAPL) to get the sentiment for that company. Scored by Adanos News Sentiment 5.5, our own model built for financial news.

post/analyze

Request

  • Base URL
    https://api.adanos.org (the document declares no server; this is the origin it was published from)
  • Auth
    API key in header X-API-Key

Request body

textstring required

Financial text to analyze, for example a news headline or a sentence about a company.

targetstring nullable

Optional: the company to judge the text for, as a name or ticker, for example Apple or AAPL. It should appear in the text; a company name works best. "Goldman Sachs cuts Apple price target" is negative for Apple and neutral for Goldman Sachs.

Example request

{
  "text": "Apple beats earnings estimates and raises its dividend",
  "target": "Apple"
}

Response

Successful Response

textstring required

Normalized input text that was analyzed

sentiment_scorenumber required

-1.0 bearish to +1.0 bullish

sentiment_label'positive' | 'neutral' | 'negative' required

Adanos three-class sentiment label, matching top_mentions payloads

Example response

{
  "text": "Apple beats earnings estimates and raises its dividend",
  "sentiment_score": 0.999,
  "sentiment_label": "positive",
  "components": {
    "engine_version": "5.5",
    "model_score": 0.9988,
    "emoji_score": 0,
    "phrase_adjustment": 0,
    "phrase_matches": [],
    "contextual_finance_matches": []
  }
}

Changes

  • 9a2daed05962Revision changes
    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status

    • info

      response property components/contextual_finance_matches deprecated

    • info

      response property components/emoji_score deprecated

    • info

      response property components/phrase_adjustment deprecated

    • info

      response property components/phrase_matches deprecated

    • info

      response property components/roberta_score deprecated

    • info

      response property components/vader_compound deprecated