AION INDIAN MARKET INTELLIGENCE USER GUIDE
==========================================

What This Product Does
----------------------
AION Indian Market Intelligence provides hosted Indian market
financial event intelligence. It helps teams turn Indian financial
headlines into structured JSON for market monitoring, sector impact
analysis, policy impact review, dashboards, AI agents, and analyst
workflows.

This public guide covers API usage only. It does not disclose private
methodology, non-public runtime details, private resources, calibration
artifacts, or model weights.


How to Call the API
-------------------
Endpoint:

    POST https://api.aiondashboard.site/v1/analyze

Authentication:

    X-API-Key: YOUR_API_KEY

Request:

    {
      "headline": "RBI hikes repo rate by 25 bps"
    }

Example cURL:

    curl -X POST "https://api.aiondashboard.site/v1/analyze" \
      -H "Content-Type: application/json" \
      -H "X-API-Key: YOUR_API_KEY" \
      -d '{"headline":"RBI hikes repo rate by 25 bps"}'

Example Python:

    import requests

    response = requests.post(
        "https://api.aiondashboard.site/v1/analyze",
        headers={"X-API-Key": "YOUR_API_KEY"},
        json={"headline": "RBI hikes repo rate by 25 bps"},
        timeout=30,
    )
    response.raise_for_status()
    print(response.json())


Python SDK
----------
Install:

    pip install aion-indian-market-intelligence

Use:

    from aion_indian_market_intelligence import analyze

    result = analyze("RBI hikes repo rate by 25 bps")
    print(result["sector_vector"])


MCP Usage
---------
Run:

    uvx aion-indian-market-intelligence-mcp

Set:

    export AION_API_KEY="YOUR_API_KEY"

The MCP wrapper calls the hosted API. It does not include local model
weights, any other model internals or offline inference logic.


Public Response Fields
----------------------
The canonical sector output key is:

    sector_vector

Responses may include:

- headline
- event
- confidence
- vix_regime
- top_positive_sectors
- top_negative_sectors
- sector_directional_bias
- stakeholder_views
- raw_assignment

Optional fields can vary by entitlement and API version.


Supported Public Use Cases
--------------------------
- market monitoring
- financial event intelligence
- financial news classification
- sector exposure review
- policy impact analysis
- dashboard integrations
- AI agent workflows
- MCP integrations
- internal analyst workflows
- fintech SaaS integrations


Search Intent Examples
----------------------
- How RBI repo hikes affect Indian sectors
- Sector effects of crude oil spikes
- Monsoon failure and Indian market impact
- Budget policy sector impact in India
- Rupee depreciation sector effects
- Export ban sector impact analysis
- Import duty change sector impact


Important Limits
----------------
AION Indian Market Intelligence is not investment advice, price
prediction, broker execution, order routing, or a replacement for human
review. It provides structured market intelligence through the hosted API.


Version
-------
Document version: 1.1
Last updated: 2026-06-15
Primary endpoint: POST /v1/analyze