Data API's

live news headline

Fetch the latest news headlines as of now, filterable by category and stock, capped at limit (max 50) items.

post/data/newsheadline

Headers

access-tokenstring required

Request body

dhanClientIdstring required

User specific identification generated by Dhan

categoriesstring[] required

News category filter. ALL returns all categories, unfiltered. Mandatory - cannot be null, omitted, or an empty array.

limitinteger required

Max number of news items to return, counted from the current date/time backwards. Allowed range is 1 to 50.
For eg. 50

universe'PORTFOLIO' | 'WATCHLIST' | 'PORTFOLIO' | 'WATCHLIST'

Scopes the news to the caller's portfolio or watchlist. Optional - omit for no scoping (must be a string, not null , not empty).

stockListstring[]

Security IDs to filter news by specific stocks. Empty array or omitted means no stock filter. Optional, but if included must be an array (null is not allowed) and cannot contain null entries.

Example request

{
  "categories": [
    "ALL"
  ],
  "limit": 1,
  "stockList": []
}

Response

Successful operation

Example response

{
  "data": {
    "latestNews": [
      {
        "newsObject": {
          "overallSentiment": "positive",
          "title": "Magellanic Cloud wins Rs 12.13 crore order from Western Railway",
          "text": "Magellanic Cloud secures Rs 12.13 crore work order from Western Railway for telecom infrastructure."
        },
        "category": "companies",
        "subCategory": "orders-deals",
        "publishDate": "2026-08-24",
        "stockName": "MAGELLANIC CLOUD LIMITED",
        "isinCode": "INE613C01026",
        "smSymbol": "MCLOUD",
        "nseScripCode": 29482,
        "bseScripCode": 538891,
        "displaySymbol": "Magellanic Cloud",
        "tickSize": 0.01,
        "lotSize": 1
      }
    ]
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.