Built like it has to be right.
Marketing pages usually ask for trust. This one shows its working: the invariants our continuous integration enforces, the gates that run on every change, and the ledger that maps each claim on this site to the code that keeps it true.
Six invariants, enforced by CI — not by intentions
Five were baked in from day one; the sixth was added the day it was needed. Each exists because the failure it prevents is silent, and each has a check that fails the build when it is violated.
One source of charge math
All brokerage, STT/CTT, stamp and GST math lives in one package. The sandbox and the backtester both import it and must agree to the paisa — in CI, on every change.
One source of wire types
Tick, candle and order schemas are defined once as JSON Schema; the TypeScript and Python types are generated from them, never hand-copied.
One source of compliance copy
Disclaimer wording and the banned-language list live in one compliance package. A lint scans every product surface — including every word on this website — against it on every change.
One source of market time
Exchange sessions, holidays and expiries live in one calendar. Nothing else may answer “is the market open” — a year with no loaded holiday circular raises an error rather than guessing.
One wire format for ticks
The tick contract is 49 bytes between services that deploy independently, so CI pins the exact bytes of a golden frame. A refactor that reorders a field fails the build, not the market open. (CL-011)
One source of portfolio math
Drawdown, Sharpe and period returns live in one shared module — added after two processes computed them differently and disagreed. This invariant earned its place the way the first five did: by being violated once.
The gates that run on every change
Each is a runnable module — the same command works on a laptop and in CI. None of them can be skipped on the way to a deploy.
- python -m alphaedge_compliance
- Banned-language lint over every product and marketing surface; missing-disclaimer scan (REG-03).
- python -m alphaedge_agent_evals
- Eight adversarial researcher failures injected and all eight must be caught; clean baseline must pass. (CL-015)
- python -m alphaedge_data_platform
- Tick wire format byte-pinned; exchange calendar loaded for the current year; medallion and market-context readiness.
- python -m alphaedge_ml
- Feature contracts, lookahead control, the charges cost floor, and model promotion gates.
- python -m alphaedge_news
- Embedding contract, source tiers, syndication dedupe, entity refusal, point-in-time retrieval.
- python -m alphaedge_risk_analytics
- Return gaps never zero-filled; correlation pruning reported; VaR publisher and consumer agree.
- python -m alphaedge_platform
- 52 infrastructure checks: India-only regions, private access, digest-only images, audit-before-publish, deploy freeze on trading days. (CL-013)
The audit chain a research call lives on
Every step lands on a hash-linked, append-only record before anything is served, and the chain is re-verified on read. Deleting a bad call is not an operation the system has. (CL-007, CL-010)
- Draftfive analysts + CIO sizing
- Compliance lintblocking, pre-publication
- Human RA gateapprove, veto, or drop
- Hash chainanchored before serving
- Publishor it never leaves
- Scoreto its exit, losers included
The stack, end to end
As architected and declared in code — the same layout the 52 infrastructure checks lint on every change. The cloud deployment has not yet been applied, and we say so rather than borrow credibility from a logo. (CL-013)
- Vendor feedsNSE · BSE · MCX · AMFI
- Event Hubsstreaming backbone
- AKS servicesgateway, sandbox, risk, recs
- Databricks lakehousemedallion Delta, ML, evals
- Postgres · Redisserving stores
- Your terminalone WebSocket, one truth
The claims ledger, in full
Every claim id used on this site resolves to a row here, and a CI check fails if one ever doesn't — or if a receipt file stops existing. This table is rendered from the ledger itself at build time, pending rows included: a claim marked pending is one we are not allowed to make yet.
| Id | Claim | Receipt | Status |
|---|---|---|---|
| CL-001 | "Capability claims trace to code and CI checks in our repository" | This ledger + python -m alphaedge_compliance in CI (.github/workflows/ci.yml); website surfaces declared in packages/compliance/src/alphaedge_compliance/linter.py | verified 2026-08-03 |
| CL-002 | "Money is integer paise in code and storage — never a float" | CLAUDE.md conventions; root README invariant 1; packages/charges/src/alphaedge_charges/engine.py (Fraction rates, integer half-up); website/app/src/lib/money.ts | verified 2026-08-03 |
| CL-003 | "Orders walk the book and pay market impact; ticks round against you; an order outside the session or circuit band is refused" | services/orders-sim/src/orders_sim/engine/fill.py:29-75; engine/tradeability.py | verified 2026-08-03 |
| CL-004 | "Brokerage, STT or CTT, exchange transaction charges, SEBI fee, stamp duty, GST — computed to the paisa by the same engine our backtester uses" | packages/charges (7 charge lines, effective-dated YAML); lakehouse/backtesting Ledger imports it; equality re-derived in CI by python -m alphaedge_ml (cost-floor check) | verified 2026-08-03 |
| CL-005 | "Eleven pre-trade checks that report which of them actually ran; session-scoped breakers; VaR that refuses to print a number it cannot compute; limits you can only tighten" | services/risk/src/svc_risk/engine.py:8-44 (checks + SKIPPED), var.py (VarUncomputable), store.py:31-46 (tighten-only) | verified 2026-08-03 |
| CL-006 | "30 indicators from one canonical spec — the chart, the alert engine, and the backtester provably compute the same line" | packages/indicators/indicators.yaml (25 client + 5 server); tests/integration/test_indicator_spec.py (cross-language drift gate) | verified 2026-08-03 |
| CL-007 | "Five specialist analysts and a CIO produce a daily report; a human analyst approves it or it is not published; every step lands on an immutable audit chain" | services/recs/src/svc_recs/pipeline.py (5 analysts, fusion, no auto-publish), api/recs.py:187-198 (ra.reviewer role), audit.py:163-169 (persist-before-publish, DB trigger immutability) | verified 2026-08-03 |
| CL-008 | "Walk-forward validation, Deflated Sharpe, Monte-Carlo drawdowns — and watermarks you cannot dismiss when a result has not earned publication" | lakehouse/backtesting/src/alphaedge_backtesting/validation/ (walkforward, dsr, montecarlo, plateau); publish.py (gate: OOS + costs + DSR ≥ 0.95 + ≥ 100 trades) | verified 2026-08-03 |
| CL-009 | "Every real order requires your explicit confirmation — that line keeps this outside SEBI's retail algo perimeter" | services/broker-bridge/src/svc_broker_bridge/consent.py:243-270 (four gates, confirmation defaults absent); api/live.py:83-111 (refusal text names the Feb-2025 framework) | verified in code 2026-08-03; regulatory characterisation flagged for counsel sign-off before launch |
| CL-010 | "Corrections attach to the published record; nothing is rewritten and nothing disappears" | services/recs/src/svc_recs/correction.py; api/recs.py:231-236 (pull keeps serving with correction attached); audit chain UPDATE/DELETE refused by DB trigger | verified 2026-08-03 |
| CL-011 | "49 bytes — the tick wire contract; CI pins the exact bytes of a golden frame" | lakehouse/data-platform/src/alphaedge_data_platform/wire.py (tickv1, struct.Struct("<IqqqiqqB") = 49 bytes); python -m alphaedge_data_platform gate checks wire.struct_size + wire.golden_frame | verified 2026-08-03 |
| CL-012 | "Hit rate is counted over triggered calls only (a win is the first target or beyond); same-tick stop/target collisions are scored as the stop; P&L is net of the full charge stack per ₹1,00,000; hit rates carry a Wilson 95% confidence interval" | services/recs/src/svc_recs/scorecard.py (wilson 139-148, core_stats 270-305 triggered-only, _pnl_per_lakh 238-259 via alphaedge_charges); services/recs/src/svc_recs/followup.py:172-176 (stop evaluated first on collision; scorer replays the same state machine); one definition reused by lakehouse/agent-evals/src/alphaedge_agent_evals/metrics.py | verified 2026-08-03 |
| CL-013 | "52 infrastructure checks — India-only regions, private access, audit-before-publish ordering, deploy freeze on trading days" | platform/src/alphaedge_platform (52 checks, per root README + platform/README); python -m alphaedge_platform in CI; 86 tests break each invariant (count re-verified by running the suite 2026-08-03) | verified 2026-08-03 |
| CL-014 | SEBI F&O loss-rate statistic (intended for homepage act 3) | SEBI, "Analysis of Profit and Loss of Individual Traders dealing in equity Futures and Options" (Sept 2024) — exact figure + year must be pinned from the primary PDF before first use | pending — not in copy |
| CL-015 | "8 adversarial researcher failures injected on every CI run — all eight must be caught" | lakehouse/agent-evals/src/alphaedge_agent_evals/guardrails.py (8 cases: banned language, hallucinated ticker, wrong-side stop, R:R mismatch, size over cap, missing risk factor, RA field on draft, stale-data abort); python -m alphaedge_agent_evals fails CI on any miss + clean-baseline false-positive guard | verified 2026-08-03 |
| CL-016 | "Each monthly transparency report is content-hashed (SHA-256 over canonical contents) and anchored to the append-only audit record before it is served" | services/recs/src/svc_recs/transparency.py:154-166 (report_content_hash, deterministic, excludes generated_at); services/recs/src/svc_recs/api/recs.py:347-363 (publish is RA-gated and audit-anchored before serving) | verified 2026-08-03 |
| CL-017 | "4 hash-chained audit logs — research, risk, billing, AI chat — integrity re-verified on read" | services/recs/src/svc_recs/audit.py; services/risk/src/svc_risk/audit.py; services/billing/src/svc_billing/admin_audit.py; services/ai-orchestrator/src/svc_ai_orchestrator/audit.py — each exposes an integrity proof on its read endpoint | verified 2026-08-03 |
| CL-018 | "This page renders from the same anonymous, public transparency API anyone can query" | services/recs/src/svc_recs/api/recs.py:276-344 (scorecard/track-record/transparency GETs have no auth dependency; tier defaults to free); services/recs/tests/test_transparency.py:102-131 (tokenless access asserted) | verified 2026-08-03 |
| CL-019 | "Trailing stops in three modes that only ratchet; regime shifts reparameterise but never below the initial stop; setup-invalidation exits on bar close; R-progress alerts and correlation warnings that name the exposure — events and sandbox orders only" | services/alerts/src/svc_alerts/trailing.py (_tighter 49-55 ratchet gate, reparameterize 90-113 clamps at initial_stop_paise); services/alerts/src/svc_alerts/regime.py (regime→mode map + hysteresis); services/alerts/src/svc_alerts/invalidation.py + services/alerts/src/svc_alerts/positions.py:222-267 (bar-close exit); services/alerts/src/svc_alerts/progress.py (R bands; "events, never commands" 9-15); services/alerts/src/svc_alerts/correlation.py (alert_copy 304-326 — the "Bank Nifty down 0.80% — your HDFCBANK long is exposed" shape) | verified 2026-08-03 |
| CL-020 | The per-tier quota matrix on /pricing | website/app/src/lib/quotas.ts — each row cites the enforcing file (gateway entitlements, alerts config, watchlists, ai-orchestrator config, strategy-lab lab.py, recs redaction, billing apikeys) | verified 2026-08-03 |
| CL-021 | "Thirteen alert conditions; indicator rules evaluated on bar close; delivered to verified contacts only; quiet hours never mute a trailing stop-loss or an invalidation exit" | services/alerts/src/svc_alerts/rules.py:31-45 (WEB_CONDITIONS, exactly 13); services/alerts/src/svc_alerts/engine.py (price rules on ticks, indicator rules on bars — module docstring); services/notify/src/svc_notify/contacts.py:188-206 (resolve returns nothing for unverified); services/notify/src/svc_notify/dispatcher.py:66-67 + services/notify/src/svc_notify/events.py:24-28 (quiet-hours gate; is_critical exempts exactly system trailing_sl/invalidation — which is why the site claims those two and not "risk alerts") | verified 2026-08-03 |
| CL-022 | "Every sandbox trade journaled automatically: entries/exits tagged by what the order did to the position, wins and losses net of charges, forced exits marked with their reason, hold times blank when unknowable, emotions from a closed vocabulary" | services/orders-sim/src/orders_sim/api/journal.py (tagging ~245-274; _FORCED_EVENTS 67-73; hold_seconds None-not-zero 60-63; free-text emotion refused 303-307); services/orders-sim/src/orders_sim/annotations.py (8-value Emotion enum, never defaulted) | verified 2026-08-03 |
| CL-023 | "Leaderboard: opt-in, pseudonymous (HMAC handles), benchmarked against the NIFTY 50 total-return index, floors of twenty closed trades and thirty active days, consent re-checked on every read" | services/orders-sim/src/orders_sim/leaderboard.py:478-491 (serve-time consent filter, fails closed); services/orders-sim/src/orders_sim/api/leaderboard.py (participation PUT); packages/py-common/src/alphaedge_common/pseudonym.py (HMAC handle, refuses weak salt); services/orders-sim/src/orders_sim/benchmark.py:38-42 + lakehouse/data-platform/src/alphaedge_data_platform/leaderboard.py:72-81 (NIFTY50_TRI; MIN_CLOSED_TRADES = 20, MIN_ACTIVE_DAYS = 30) | verified 2026-08-03 |
| CL-024 | "AMFI NAVs with honest gaps; SIP allotment forward-looking, never a nearby NAV substituted; an XIRR that returns nothing rather than a guess" | services/mf/src/svc_mf/amfi.py (N.A. parsed as absent, 12-16); services/mf/src/svc_mf/source.py (ingest failures recorded, not raised through); services/mf/src/svc_mf/store.py:128-152 (nav_for_allotment forward-only, None when absent); services/mf/src/svc_mf/api/mf.py:139-181 ("Nothing is estimated"); apps/web/src/lib/sip.ts (xirr(): number | null`, bisection, null on unbracketable) |
| CL-025 | "API keys hashed at rest with two active slots so rotation has no downtime; webhooks signed with timestamped HMAC and a retry ladder that ends; seat offboarding revokes the member's keys in the same call" | services/billing/src/svc_billing/apikeys.py (SHA-256 at rest; MAX_ACTIVE_KEYS = 2 with the no-downtime rationale; SCOPE_DENYLIST keeps keys off billing/live/broker routes); services/notify/src/svc_notify/webhooks.py (t=,v1= HMAC signature 11-17; RETRY_LADDER 1m→6h then disable 43-50; breaker at 5); services/billing/src/svc_billing/orgs.py:182-199 (remove_member → revoke_all_for); docs/11-apis.md §4.2, §7.1 | verified 2026-08-03 |
| CL-026 | "Personal-advice questions are refused before the model runs; the homepage quotes the product's refusal copy word for word; every answer and refusal carries a hash-chained audit id; no buy/sell buttons in chat" | services/ai-orchestrator/src/svc_ai_orchestrator/data/refusals.yaml v1.1 (personal_advice message quoted whole — v1.0's premature registration claim was fixed upstream 2026-08-03, docs/18 finding 3); services/ai-orchestrator/src/svc_ai_orchestrator/api/chat.py (refusal path returns before the engine is invoked; audit_id attached on both paths); services/ai-orchestrator/src/svc_ai_orchestrator/guardrails.py (deterministic classifier, most-specific-first); services/ai-orchestrator/src/svc_ai_orchestrator/audit.py (ChatAuditChain, CHAT_ANSWER/CHAT_REFUSAL); apps/web chat page renders no order controls | verified 2026-08-03 |
| CL-027 | "Dockable panels with saved workspaces; A/B/C panel linking; Ctrl-K palette; a voice grammar that pre-fills and cannot submit; Simplicity Mode below 1024 px" | apps/web/src/components/command-center.tsx (dockview) + apps/web/src/panels/registry.ts (one panel registry, both compositions); apps/web/src/stores/workspace.ts (saveLayout, persisted ae.workspace.*); apps/web/src/stores/link.ts (LinkGroup = "A" | "B" |
| CL-028 | "Free is 15-minute delayed with a badge and a canvas watermark; one shared socket per browser; snapshot-on-subscribe; five-level depth on Pro, top-20 on Elite" | services/market-gateway/src/market_gateway/entitlements.py (tier/mode matrix, delayed); apps/web/src/lib/entitlements.tsx:171-179 (DelayedBadge); apps/web/src/components/price-chart.tsx:301-319 (watermark drawn on canvas, "a DOM badge alone is insufficient"); apps/web/public/workers/market-shared.js + apps/web/src/hooks/use-market-stream.ts (SharedWorker owns the one socket; refuses raw-socket fallback); services/market-gateway/src/market_gateway/registry.py (_send_snapshots on subscribe); services/market-gateway/src/market_gateway/config.py:45-49 + services/market-gateway/src/market_gateway/dispatch.py (depth 5 full / top-20 truncation) | verified 2026-08-03 |
| CL-029 | "Thirty minutes idle and the session is revoked at the server" | services/identity/src/svc_identity/store.py (idle_timeout_minutes=30 114-122; revoke-on-idle 368-379); services/identity/src/svc_identity/config.py:39-41; enforced at resolve in services/identity/src/svc_identity/api/identity.py:55-67; asserted in services/identity/tests/test_identity_api.py | verified 2026-08-03 |
| CL-030 | "Staff authenticate against a separate directory; the role that publishes research is not the role that operates the platform; production refuses rather than degrades" | packages/py-common/src/alphaedge_common/staff.py (separate staff tenant/client 21-27; prod refusal 36-42; ROLE_RA_REVIEWER vs ROLE_PLATFORM_ADMIN — publish vs stop); docs/14-security-compliance.md (tenant table + role matrix). Site copy deliberately does NOT claim dual control — docs/14 records it as not implemented | verified 2026-08-03 |
| CL-031 | "Broker tokens envelope-encrypted: AES-256-GCM under a Key Vault key, bound to their database row, rotation window built in; production refuses the dev cipher" | services/broker-bridge/src/svc_broker_bridge/sessions.py (AesGcmCipher 127-196: AAD row-binding, v1.<key id> format, previous-DEK read window 132-134; InsecureCipherInProduction 36-37; DevCipher self-labels "NOT ENCRYPTION"); services/broker-bridge/tests/test_cipher.py | verified 2026-08-03 |
| CL-032 | "Zerodha discontinued bracket orders; a sandbox BO graduates to a GTT-OCO with a user-visible note about the different risk shape; the adapter declines to claim bracket support" | services/broker-bridge/src/svc_broker_bridge/adapters/kite.py (docstring 10-12 names the risk-shape difference; mapping + note 196-215); services/broker-bridge/src/svc_broker_bridge/adapters/base.py:17-21 ("the user believes they have a bracket and they do not" named as the failure mode); services/broker-bridge/tests/test_kite_adapter.py:130-144 (BO→GTT-OCO with note), :186-190 (no bracket capability claimed) | verified 2026-08-03 |
| CL-033 | "A timed-out live order is marked UNKNOWN and never retried; reconciliation against the broker's own book is required before another attempt — by us or by you" | services/broker-bridge/src/svc_broker_bridge/idempotency.py (docstring 13-22: timeout does not retry, callers cannot route around reconcile; ReconcileRequired 35; UNKNOWN guard ~92-102) | verified 2026-08-03 |
Receipts reference paths in our repository. Public excerpts of the engineering docs ship with the developer platform at launch; until then, the paths are the pointer and this page is the index.
The honesty rules, as engineering principles
- No fabricated data, ever — no invented users, testimonials, or numbers, on the product or on this site.
- Unavailable is not empty. A screen that cannot know says it cannot know; it never renders a zero it did not compute.
- A check that did not run reports SKIPPED, with the reason. Silence is never evidence of safety.
- Refusals are visible. When the platform declines — an order outside the band, an advice question to the AI — it names the gate that stopped it.
- One source per fact. Prices render from the billing service, disclaimers from the compliance registry, limits from the code that enforces them.
- Screenshots are builds: captured from the running terminal by a pipeline, committed as taken, provenance printed under every frame.
The measured outcome of all of this — every research call scored to its exit — lives on the track record page.