Generate daily portfolio summary

POST /v1/daily-summary/

Analyzes submitted stock symbols and optional portfolio weights to produce a focused digest of relevant market news, updates, and key events. Intraday and News modes can include up to seven calendar days of prior context.

When to use it

Use this endpoint for portfolio digests, advisor dashboards, and end-of-day summary workflows. Increase context_window_days when an intraday move or news catalyst may have started before today.

Authentication and billing

Requires X-API-Key or api_key.
Credit cost: 5 credits / request. Bills 5 credits only when a summary is generated. Failed and no-news/no-signal responses are not charged.
See pricing for plan allowances and full billing details.

Request

Body: JSON body with one of portfolio (legacy holdings), symbols (watchlist shorthand), or items (canonical symbol set). Set optional mode to exposure, intraday_movements, or news_context. For Intraday and News modes, context_window_days accepts 1 to 7 and defaults to 1.

Field	Location	Required	Notes
`portfolio`	body	No	Legacy holdings array with `{ symbol, exposure?, label? }` items. Provide this, `symbols`, or `items`.
`symbols`	body	No	Watchlist shorthand: an array of stock symbols. Provide this, `portfolio`, or `items`.
`items`	body	No	Canonical array of `{ symbol, exposure?, label? }` items. Provide this, `portfolio`, or `symbols`.
`mode`	body	No	Optional mode: `exposure`, `intraday_movements`, or `news_context`.
`context_window_days`	body	No	Optional context window for `intraday_movements` and `news_context`. Set an integer from `1` to `7`; defaults to `1`. Days are Asia/Kolkata calendar days, inclusive of today.
`X-Alpha-Content-Retention`	header	No	Optional. Set `none` to opt out of retained request content when your account policy permits it.
`api_key`	query	No	Optional alternative to the `X-API-Key` header. Prefer the header for server-side applications.

Response

Returns status, generated markdown summary, optional request details, and error when applicable. details.context_window_days reports the effective window used.

Show Schema

Successful Responseapplication/json

{
  "details": {
    "context_window_days": 3,
    "input_type": "watchlist",
    "mode": "intraday_movements",
    "portfolio_size": 3,
    "request_id": "req_7f91ab2c",
    "submitted_symbol_count": 3,
    "symbols_processed": 3
  },
  "status": "success",
  "summary": "- **TCS**: Guidance reaffirmed; AI deal wins noted. Closed yesterday at +0.8%, currently at +1.2%.\n- **RELIANCE**: Jio ARPU trend positive. Closed yesterday at -0.4%, currently at +0.9%.\n"
}

Request pattern

curl "https://developers.manasija.in/v1/daily-summary/" \
  -H "X-API-Key: $DRISHTI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbols":["TCS","RELIANCE"],"mode":"intraday_movements","context_window_days":3}'

JavaScript / TypeScript SDK

const summary = await client.postDailySummary({
  body: { symbols: ["TCS", "RELIANCE"], mode: "news_context", context_window_days: 7 },
})

Python SDK

summary = client.post_daily_summary(
    request={"symbols": ["TCS", "RELIANCE"], "mode": "news_context", "context_window_days": 7},
)

Interactive reference

Use the Scalar API client for executable requests, schemas, and the full OpenAPI contract.