AION API REFERENCE ================== Base URL -------- https://api.aionanalytics.in The earlier host, api.aionanalytics.in, still responds during the domain migration. New integrations should use api.aionanalytics.in. Authentication -------------- Send your API key in the X-API-Key header. Example: X-API-Key: YOUR_API_KEY Hosted API keys are issued with a plan, free or paid. Choose one at https://aionanalytics.in/subscribe/indian-market-intelligence (see also https://aionanalytics.in/apis). A key is scoped to the model and plan it was issued for. A verified email and a passkey are required. Registration at /access/register is a separate path. It requires a referral code and is for approved dashboard and local-agent testers. It is not how hosted API keys are issued, and referral codes are not published. Versioning ---------- Current version is path-based: /v1/... Clients should pin to the versioned path and monitor release notes for future compatibility changes. Plans and Quotas (AION Indian Market Intelligence) -------------------------------------------------- Free INR 0, no card 10 requests per month, counted over a rolling 30 days Builder INR 999 per month 500 requests per billing period, up to 50 in any rolling 24 hours Professional INR 4,999 per month 5,000 requests per billing period, up to 500 in any rolling 24 hours The free plan needs no card. Each verified user can hold one free plan, and free keys are limited to one per device and two per network address in any 30 days. Only requests that complete successfully count against a quota. When the daily or billing-period quota is used up the API returns 429; the X-AION-Error-Code response header says which one (daily_quota_exceeded or period_quota_exceeded). Earlier plan generations remain in force for existing subscribers only and are not described here. The public demo at https://aionanalytics.in/demo allows three analyses per device. Endpoint -------- There is one hosted endpoint at /v1: Method: POST Path: /v1/analyze Purpose: Analyze a headline with AION Indian Market Intelligence (IMI). Returns a confidence score, a signed impact across 32 sectors, and stakeholder-specific readings. Request headers: - Content-Type: application/json - X-API-Key: YOUR_API_KEY Request body (JSON): - headline: Required. The headline text to analyze. - body: Optional. The article or release text. A short headline can be ambiguous on its own; the body often resolves it. Request example: { "headline": "RBI hikes repo rate by 25 bps" } Response example (status 200; abbreviated -- a real response lists all 32 sectors in sector_vector, and sectors with no modelled impact are 0.0): { "headline": "RBI hikes repo rate by 25 bps", "confidence": 0.4623, "macro_signal": -0.495, "vix_regime": "normal", "sector_vector": { "Banks": -0.5693, "Financial Services": -0.5693, "NBFC": -0.5693, "Automobile and Auto Components": -0.5693, "Realty": -0.6188, "FMCG": -0.4455, "IT": 0.3465, "...": 0.0 }, "top_positive_sectors": { "IT": 0.3465 }, "top_negative_sectors": { "Realty": -0.6188, "Financial Services": -0.5693, "Banks": -0.5693 }, "stakeholder_views": { "producer_view": { "winners": [ ... ], "losers": [ ... ] }, "trader_intermediary_view": { ... }, "investor_view": { ... }, "government_fiscal_view": { ... }, "international_trade_view": { ... } }, "cultural_context": { "detected": false, "explanation": "no known cultural/sovereign event detected" } } Field descriptions: - headline: The headline that was analyzed. - confidence: Confidence in how the headline was understood, from 0 to 1. A low value means the headline is ambiguous or outside what the model covers; sending the article text in "body" often helps. - macro_signal: Signed overall macro direction for the event. - vix_regime: Volatility regime at the time of analysis (for example "normal"). - sector_vector: Signed impact for each of the 32 AION taxonomy sectors. Negative is adverse, positive is favourable, 0.0 is no modelled impact. - top_positive_sectors / top_negative_sectors: The most favourably and most adversely affected sectors, with their values. - stakeholder_views: Five readings of the same event, one per participant type: producer_view (winners, losers), trader_intermediary_view (winners, losers, second_order_effects), investor_view (top_risers, top_fallers, cascade_timeline), government_fiscal_view (opportunities, risks, rebuild_signals) and international_trade_view (opportunities, risks, competitor_gains). Lists can be empty. Entries carry the sector, an impact value and, where relevant, a lag_days value and a short rationale. - cultural_context: Whether a known cultural or sovereign context applies to the headline (detected) and a plain-language explanation. The API does not return trade direction (long/short) signals, internal assignment records, or internal event and rule identifiers on any plan. The response can contain further fields that are not part of the supported contract. Ignore fields you do not recognise; do not depend on them. Informational output for research. Not investment advice. Error Codes ----------- 401 Unauthorized Returned when the API key is missing ("Missing API key") or not recognised ("Invalid API key."). The X-AION-Error-Code header carries a machine-readable code such as invalid_api_key. 403 Forbidden Returned when the key is recognised but cannot be used: the subscription or entitlement is not active, access has expired, the key belongs to a different model, or account verification is incomplete. The X-AION-Error-Code header says which. 422 Unprocessable Entity Returned when the request body is malformed or a required field is missing, for example no "headline". The response lists the field. 429 Too Many Requests Returned when the daily or billing-period quota for the plan is used up. 500 Internal Server Error Returned when the analysis could not be completed. Example error responses: 401: {"detail": "Missing API key"} 422: {"detail": [{"type": "missing", "loc": ["body", "headline"], "msg": "Field required"}]} Code Examples ------------- cURL: curl -X POST "https://api.aionanalytics.in/v1/analyze" \ -H "Content-Type: application/json" \ -H "X-API-Key: $AION_API_KEY" \ -d '{"headline": "RBI hikes repo rate by 25 bps"}' Python: import os import requests response = requests.post( "https://api.aionanalytics.in/v1/analyze", headers={"X-API-Key": os.environ["AION_API_KEY"]}, json={"headline": "RBI hikes repo rate by 25 bps"}, timeout=30, ) response.raise_for_status() result = response.json() print(result["confidence"], result["top_negative_sectors"]) Summary ------- The AION hosted API currently exposes one endpoint, POST /v1/analyze, for AION Indian Market Intelligence (IMI) headline analysis. It is versioned, key-authenticated, and designed for workflow integration rather than retail execution prompts. Changes ------- 1.4 (2026-09-21) - The top-level "event" field is no longer returned by /v1/analyze, for any plan. It held an internal event identifier. Clients that read it should stop; every other field in the response is unchanged. - cultural_context: internal diagnostic fields are no longer returned. The event name, match confidence, references, explanation and the conflicts_held records (artifact, sector, state, reason, resolution) are unchanged. - The same response shape is now returned by every route that serves IMI analysis, including the public demo. 1.3 (2026-09-20) - Free plan published: 10 requests per month, no card. The free-trial figure that version 1.0 gave was wrong and has been removed. - Internal diagnostic fields, and internal event and rule identifiers, are no longer returned by /v1/analyze, for any plan. - Free keys are limited to one per device and two per network address in any 30 days. 1.2 (2026-09-20) - Trade direction (long/short) signals are no longer returned by /v1/analyze, for any plan. 1.1 (2026-09-20) - Base URL is now https://api.aionanalytics.in. - Plan quotas corrected to the current Builder and Professional plans. - GET /v1/veritas/report and POST /v1/edge were listed in version 1.0 but are not served at /v1; they have been removed from this reference. - Response reference rewritten from a current response. The 1.0 example did not match it: it showed a "meta_factors" object and a sector_vector keyed by index names (NIFTYBANK, NIFTYIT), and used an event name the API does not return. - Error codes updated (403 and 422 added; 400 and 503 removed). - Product name corrected to AION Indian Market Intelligence (IMI). 1.0 (2026-06-08) - Initial version. Version ------- Document version: 1.4 Last updated: 2026-09-21 Base URL: https://api.aionanalytics.in