Skip to content

Stocks · News and market map

Stocks news sentiment

Daily positive, negative and neutral article counts and a net score for a ticker.
GET/v1/stocks/news/sentimentstocksNewsSentiment
On this page

For each exchange date of the last days (1 to 30), oldest first, the articles that mention the ticker counted by the sentiment each carries for that ticker: positive, negative, neutral, or unscored when the article has no sentiment for it. net_score is (positive - negative) divided by the scored articles, from -1 to 1, null when none is scored. Dates without articles are listed with zero counts. At most 300 articles are read, newest first; when more remained, meta.coverage.truncated is true and meta.coverage.complete is false: the result is then partial and the oldest days may be short.

Example request

curl -sS --get "https://api.ordermap.si/v1/stocks/news/sentiment" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY" \
  --data-urlencode symbol=AAPL

Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.

Parameters

2 parameters, 1 required.

ParameterType and limitsDescription
symbolqueryrequiredstringat most 11 characterspattern ^[A-Za-z]{1,6}(\.[A-Za-z0-9]{1,4})?$Ticker symbol, for example AAPL.
daysqueryoptionalintegerdefault 7min 1max 30Number of exchange dates, ending today, 1 to 30.

Response

StatusMeaningBody
200Successful response.Schema below
400Invalid, unknown or repeated parameters, or an invalid cursor.Error object
401Missing or invalid API key.Error object
403The plan, dataset release or account state does not allow this request.Error object
422The request is valid but no data exists for it.Error object
429Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-AfterError object
500Internal error.Error object
503Data temporarily unavailable; retry after Retry-After seconds.Retry-AfterError object
504The request timed out.Error object

Authenticated responses carry the X-RateLimit-* headers (see rate limits); 429 and 503 add Retry-After.

200 response body

  • dataarray<object>required7 fields inside
    • articlesintegerrequiredAll articles that mention the ticker.
    • datestringdaterequiredExchange date.
    • negativeintegerrequiredArticles with negative sentiment.
    • net_scorenumber | nullrequired(positive - negative) / (positive + negative + neutral), -1 to 1.
    • neutralintegerrequiredArticles with neutral sentiment.
    • positiveintegerrequiredArticles with positive sentiment for the ticker.
    • unscoredintegerrequiredArticles without a sentiment for the ticker.
  • metaobjectrequiredMeta object

Example response

{
  "data": [
    {
      "articles": 6,
      "date": "2026-10-15",
      "negative": 1,
      "net_score": 0.4,
      "neutral": 1,
      "positive": 3,
      "unscored": 1
    }
  ],
  "meta": {
    "as_of": 1760659200123,
    "coverage": {
      "complete": true
    },
    "delay_ms": 0,
    "delayed": false,
    "request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
    "source": "sip"
  }
}

Values are illustrative. Missing values are null, never 0.