DHdhan
Data API's

live news headline

Changed on

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

post/data/newsheadline

Request

  • Base URL
    https://api.dhan.co/v2
  • URL
    https://api.dhan.co/v2/data/newsheadline
  • Auth
    none declared. Required headers: access-token

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