Skip to content

Stocks · News and market map

Stocks news

Ticker news, newest first.
On this page

News articles with title, summary, publisher, link and the tickers each concerns, newest first, paged back in time with cursor_id. Each insight gives the sentiment (positive, neutral or negative) the article carries for one ticker with the reasoning. Without symbol the market-wide feed is returned. The feed is refreshed continuously and cached for a minute; without start_time it reaches back as far as your plan's history allows.

Example request

curl -sS --get "https://api.ordermap.si/v1/stocks/news" \
  -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

5 parameters, none required.

ParameterType and limitsDescription
symbolqueryoptionalstringat most 11 characterspattern ^[A-Za-z]{1,6}(\.[A-Za-z0-9]{1,4})?$Only articles that mention this ticker symbol.
start_timequeryoptionalintegerunix-msmin 946684800000max 4102444800000Inclusive earliest publication time.
end_timequeryoptionalintegerunix-msmin 946684800000max 4102444800000Exclusive latest publication time.
limitqueryoptionalintegerdefault 20min 1max 100Maximum rows to return.
cursor_idqueryoptionalstringat most 1024 charactersOpaque cursor returned as pagination.next_cursor_id; resumes the same query on the next page.

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>required16 fields inside
    • authorstring | nullrequiredAuthor.
    • descriptionstring | nullrequiredSummary of the article.
    • idstringrequiredArticle id.
    • image_urlstring | nullrequiredLink to the article image.
    • insightsarray<object>requiredSentiment per ticker.3 fields inside
      • reasoningstringrequiredWhy the article carries this sentiment.
      • sentimentstringrequiredSentiment.positiveneutralnegative
      • symbolstringrequiredTicker symbol.
    • keywordsarray<string>requiredKeywords.
    • publisherobject | nullrequiredThe publishing outlet.2 fields inside
      • homepage_urlstring | nullrequiredOutlet website.
      • namestringrequiredOutlet name.
    • symbolsarray<string>requiredTickers the article mentions.
    • timestampintegerunix-msrequiredPublication time. Unix epoch milliseconds (UTC).
    • titlestringrequiredHeadline.
    • urlstring | nullrequiredLink to the article at the publisher.
  • metaobjectrequiredMeta object
  • paginationobjectrequiredPagination object

Example response

{
  "data": [
    {
      "author": "A. Reporter",
      "description": "The company introduced its next-generation processor.",
      "id": "8ec638777ca03b553ae516761c2a22ba2fdd2f37befae3ab6fdab74e9e5193eb",
      "image_url": null,
      "insights": [
        {
          "reasoning": "The new chip raises expected margins.",
          "sentiment": "positive",
          "symbol": "AAPL"
        }
      ],
      "keywords": [
        "chips"
      ],
      "publisher": {
        "homepage_url": "https://example.com",
        "name": "Example News"
      },
      "symbols": [
        "AAPL"
      ],
      "timestamp": 1792071000000,
      "title": "Apple unveils new chip",
      "url": "https://example.com/apple-chip"
    }
  ],
  "meta": {
    "as_of": 1760659200123,
    "coverage": {
      "complete": true
    },
    "delay_ms": 0,
    "delayed": false,
    "request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
    "source": "sip"
  },
  "pagination": {
    "count": 1,
    "has_more": false,
    "limit": 20,
    "next_cursor_id": null,
    "next_url": null
  }
}

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