Default

Market News

Changed on

Get latest market news.

get/news

Request

  • Base URL
    https://finnhub.io/api/v1
  • URL
    https://finnhub.io/api/v1/news
  • Auth
    API key in query parameter token

Query parameters

categorystring required

This parameter can be 1 of the following values <code>general, forex, crypto, merger</code>.

minIdinteger

Use this field to get only news after this ID. Default to 0

Response

successful operation

categorystring

News category.

datetimeinteger

Published time in UNIX timestamp.

headlinestring

News headline.

idinteger

News ID. This value can be used for <code>minId</code> params to get the latest news only.

imagestring

Thumbnail image URL.

relatedstring

Related stocks and companies mentioned in the article.

sourcestring

News source.

summarystring

News summary.

urlstring

URL of the original article.

Example response

[
  {
    "summary": "summary",
    "image": "image",
    "datetime": 0,
    "related": "related",
    "id": 6,
    "source": "source",
    "category": "category",
    "headline": "headline",
    "url": "url"
  }
]

Changes

  • b9cd697cee6dRevision changes
    • breaking

      for the query request parameter minId, the type changed from string to integer, and format from no format to int64

  • a148c0b2d583Revision changes
    • info

      api operation id general-news removed and replaced with market-news

    • info

      api tag Default added