# Trade Chakra — Vedic Terminal SBC Trader Timing Utility

> Deterministic Vedic Sarvatobhadra Chakra (SBC) timing terminal and intraday Hora resolution for active equity and derivatives traders, powered by Swiss Ephemeris Lahiri calculations.

## Overview
Trade Chakra bridges 2,000-year-old classical Vedic timing principles with modern intraday trading execution. Unlike lagging technical indicators (e.g., RSI, moving averages), Trade Chakra calculates an independent temporal conviction frame prior to market open, mapping planetary transits across an 81-cell matrix to evaluate 7 sensitive nakshatra points and intraday planetary Horas.

## Markets Supported
- **NSE** (National Stock Exchange of India): Regular Trading Hours 09:15–15:30 IST (Asia/Kolkata).
- **US** (NYSE / NASDAQ): Regular Trading Hours 09:30–16:00 EST (America/New_York).

## Core API Endpoints
- `GET /about`: Canonical 8-section entity record and machine-readable `<dl>` facts block.
- `POST /mcp`: Streamable HTTP / JSON-RPC 2.0 MCP server (`sbc_health`, `sbc_calc_nakshatra`, `sbc_session`, `sbc_feed_today`, `skills_list_tool`, `read_skill`).
- `GET /api/session?star={star}&market={NSE|US}&date={YYYY-MM-DD}`: Returns deterministic session verdict (GO, CAUTION, AVOID), composite score (-6 to +6), active Vedha rays, and hourly Hora breakdowns.
- `GET /api/calc-nakshatra?dob={YYYY-MM-DD}&tob={HH:MM}&tz={offset}`: Calculates Janma Nakshatra, Pada, and exact Moon longitude from birth date/time via Swiss Ephemeris Lahiri.
- `GET /api/stars`: Returns the list of 27 classical birth stars with grid coordinates and abbreviation mappings.
- `GET /api/market-status?market={NSE|US}`: Real-time bell status, open/closed state, and countdown to next session.
- `GET /api/geo-pricing`: Multi-currency payment links (US Stripe & India UPI/Razorpay).
- `GET /api/feed/today.json`: Syndicated machine-readable daily verdict feed for all 27 birth stars.
- `GET /star/{slug}`: Dynamic landing page for each of the 27 nakshatras.
- `GET /embed/star/{slug}`: Lightweight embeddable iframe widget for financial blogs and Substack newsletters.

## Core Rules & Architecture
1. **Zero Hallucination / Deterministic**: All planetary coordinates and Vedha rays are calculated directly with Swiss Ephemeris Lahiri ayanamsa. No generative AI or LLMs in the calculation loop.
2. **27 Birth Stars Only**: Abhijit is an intercalary transit star used in grid ray casting, but is strictly disallowed as a birth star.
3. **Session Postures**:
   - `GO`: Score >= +2 with no severe malefic affliction to Janma or Karma nakshatras. Strong classical benefic ray support.
   - `CAUTION`: Mixed benefic and malefic rays, or score between -1 and +1. Moderate cyclical friction and crossed ray influences.
   - `AVOID`: Score <= -2 or direct malefic affliction to Janma/Vainashika. Concentrated malefic Vedha obstruction.