---
title: "Analyze finance sentiment"
method: POST
path: "/analyze"
tags: ["Finance Sentiment"]
---

# Analyze finance sentiment

`POST /analyze`

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

Analyze a single financial or trading text using the Adanos finance-tuned sentiment engine.

## Request body

- SentimentAnalyzeRequest — Direct text sentiment analysis request.
  - `text` string, required — Financial or trading text to analyze.

## Response `200`

Successful Response

- SentimentAnalyzeResponse — Direct text sentiment analysis response.
  - `text` string, required — Normalized input text that was analyzed
  - `sentiment_score` number, required — -1.0 bearish to +1.0 bullish
  - `sentiment_label` 'positive' | 'neutral' | 'negative', required — Adanos three-class sentiment label, matching top_mentions payloads
  - `components` SentimentComponents, required — Whitelisted sentiment engine components exposed publicly.
    - `engine_version` string, required — Sentiment engine version
    - `vader_compound` number, nullable — VADER compound score after finance lexicon tuning
    - `roberta_score` number, nullable — RoBERTa ONNX sentiment score when ensemble inference runs
    - `emoji_score` number, required — Emoji-derived sentiment score
    - `phrase_adjustment` number, required — Directional finance phrase adjustment
    - `phrase_matches` SentimentPhraseMatch[] — Directional finance phrases matched by the engine
      - `phrase` string, required — Matched finance phrase
      - `score` number, required — Internal phrase sentiment score
    - `contextual_finance_matches` string[] — Contextual finance phrases that dampened or informed scoring

## Other responses

- `401` — Authentication failed
- `403` — Professional account required
- `422` — Request body validation failed
- `429` — Rate limit exceeded
- `503` — Sentiment inference service unavailable

---

[API](https://skmtc.net/adanos/apis/adanos-finance-sentiment-api.md) · [All operations](https://skmtc.net/adanos/apis/adanos-finance-sentiment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adanos/adanos-finance-sentiment-api/versions/f3fee2023a3f/schema)