Market-data APIs — FII/DII Activity + Tickertape MMI as standalone repos (GH Actions + GH Pages)

decision Sun Jun 21 2026 00:00:00 GMT+0000 (Coordinated Universal Time) decisionarchitectureapimarket-datagithub-actionsgithub-pagesindiafree-tier

Reactivated 2026-06-22 under a different mechanism. The original body below described two Cloudflare Workers (flow-fii-dii.api.oriz.in, mmi.api.oriz.in) backed by KV. That design was first replaced by an aggregator repo (oriz-market-data, see ), then reverted same-day to the current shape: each API stays in its own repo, scraped by GH Actions, served via GitHub Pages + raw.githubusercontent.com. See market-data-per-repo for the current canonical decision. The CF Worker body below is preserved for audit trail and as the historical alternative — the repo slugs and product surfaces it locked are unchanged.

Market-data APIs — FII/DII Activity + Tickertape MMI

Decision

Two new India-market data APIs land as standalone Cloudflare Workers (not folded into the api.oriz.in umbrella) — each per its own subdomain, each with its own KV cache binding, each serving public JSON with CORS *:

API	Subdomain	Upstream	Cache TTL
FII/DII net activity	`flow-fii-dii.api.oriz.in`	NSE India (primary) + Moneycontrol (fallback)	24h per date / range
Market Mood Index mirror	`mmi.api.oriz.in`	Tickertape (`api.tickertape.in/mmi/now`)	1h on `/current`, 24h on `/history`

Both use Hono router, single CACHE KV binding, Linux-only CI, wrangler deploy on push to main via CLOUDFLARE_API_TOKEN + CLOUDFLARE_ACCOUNT_ID org secrets. No auth, 60 req/min/IP via Cloudflare built-in rate-limit.

Why standalone Workers, not folded into `api.oriz.in`

Each gets its own 100K req/day free envelope per cf-worker-quota-mitigation step 4 ("split Workers by domain") — adding these to the umbrella Worker would burn a single shared envelope on third-party-data routes that aren't directly tied to oriz product code. Separate subdomain keeps them addressable, separately rate-limitable, and independently redeployable. KV gets its own namespace per Worker — clean blast radius if one upstream changes shape.

Implications

2 new submodules under repos/oriz/own/svc/api/ — already wired into .gitmodules.
DNS: 2 new CNAME records under oriz.in zone pointing at *.workers.dev — set via Cloudflare API on first deploy (handled by wrangler deploy --custom-domain).
Both Workers fit the easy-free-tier catalog — CF Workers free 100K req/day + KV 1K writes/day + 100K reads/day per namespace, no card on file.
Upstream resilience: FII/DII has NSE → Moneycontrol fallback in-Worker; MMI is single-upstream (Tickertape) — if Tickertape drops, we serve stale-while-error from KV until manual intervention.
Tests scaffolded with @cloudflare/vitest-pool-workers, one happy-path per endpoint, per the tests-parallel rule.
License MIT per the MIT relicense lock.

Cross-refs