Latest News
Fetches recent company news articles for a single NSE/BSE listed company. Upstox returns articles published in the last 7 days, including a headline, summary, thumbnail, source link, and published timestamp.
Fincrux syncs news from Upstox every 30 minutes into its own database and Redis cache. Requests are served from that local store and never call Upstox directly. There is no per-request refresh or force_update option.
The sync is idempotent: each company has exactly one news record, and duplicate articles are removed by article_link before storage and when serving.
Rate Limits
Request
GET /api/news/{company_symbol}
| Parameter | Description | Priority | Type |
|---|---|---|---|
| api_key | User Generated API Key. Generate Here | required | string |
| page_number | Page number (1–100). Default 1 | optional | integer |
| page_size | Records per page (1–100). Default 20 | optional | integer |
Status codes: 200 success, 400 invalid parameters, 401/403 authentication, 404 unknown company, 503 news has not been synced yet. Error responses contain a message field; the success key is not used in this API.
Response
| Field | Description | Type |
|---|---|---|
| company | Name of the company | string |
| trading_symbol | NSE / BSE trading symbol | string |
| instrument_key | Upstox instrument key used for the news sync | string |
| data | List of news articles | array |
| data.heading | News headline | string |
| data.summary | Short summary of the article | string |
| data.thumbnail | Thumbnail image URL | string |
| data.article_link | Link to the full article | string |
| data.published_time | Published time as a Unix timestamp in ms | integer |
| metadata | Pagination metadata | object |
| fetched_at | Time of the most recent successful news sync | string |
Example
curl -X GET \ -H "Content-Type: application/json" \ --url 'https://api.fincrux.org/api/news/RELIANCE?api_key={api_key}'