Settings & data sources

Free official data (US/global markets, crude, USD/INR, some India macro and rates) is fetched from FRED automatically. NSE/BSE prices, breadth, FII/DII flows and option chains require a licensed market-data source — this app never scrapes NSE. Two ways to connect one:

• Provider adapter: Dhan (set DHAN_ACCESS_TOKEN and DHAN_CLIENT_ID) and Twelve Data (set TWELVE_DATA_API_KEY) are bundled. For another vendor, implement MarketDataProvider in src/dashboards/india-sentiment/lib/data/providers/, read its credentials from server-side environment variables, and register it in provider.ts. The scheduled refresh then pulls it.
• Ingestion API: push series observations and full option chains to POST /api/india-sentiment/ingest (requires ADMIN_TOKEN). Use this for RBI, AMFI, MOSPI, SEBI, NSDL/CDSL and Ministry of Finance releases too. Series are merged by date; option chains update the chain view, intraday pressure and the derived daily option series.
• Official-series job: the RBI policy repo rate is imported daily from the BIS policy-rate statistics (source: Reserve Bank of India) by /api/cron/india-official or npm run official. BIS publishes India with a lag of several weeks, so a newer RBI decision can still be pushed through the ingestion API. The other RBI series, G-Sec yields and market USD/INR have no source that is machine-readable and permitted for automated download (RBI data files sit behind a bot challenge; FBIL and CCIL data need a licence); each series' notes say why.

Option chains: send every strike and expiry with LTP, previous close, volume (contracts), OI, change in OI, IV, previous IV, bid/ask, timestamp and the lot size in force on that date.

curl -X POST $HOST/api/india-sentiment/ingest \
  -H "x-admin-token: $ADMIN_TOKEN" -H "Content-Type: application/json" \
  -d '{
  "source": "my-broker-script",
  "series": [
    { "key": "idx:NIFTY50", "observations": [{ "date": "2026-09-30", "value": 25310.4 }] },
    { "key": "flow:fii_cash", "observations": [{ "date": "2026-09-30", "value": -1834.2 }] },
    { "key": "breadth:adv", "observations": [{ "date": "2026-09-30", "value": 1402 }] }
  ],
  "optionChains": [{
    "underlying": "NIFTY", "spot": 25310.4, "timestamp": "2026-09-30T15:30:00+05:30",
    "volumeUnit": "contracts",
    "records": [{ "underlying": "NIFTY", "expiry": "2026-10-06", "strike": 25300, "type": "CE",
      "ltp": 142.5, "prevClose": 131.0, "volume": 812345, "oi": 9123450, "changeInOi": 402150,
      "iv": 11.8, "prevIv": 11.2, "bid": 142.3, "ask": 142.6,
      "timestamp": "2026-09-30T15:30:00+05:30", "lotSize": 75 }]
  }]
}'