--- name: api.aitrailblazer.net description: api.aitrailblazer.net provides precomputed covenant stress analytics and alpha screening for public companies and crypto issuers, drawing on SEC EDGAR filings, XBRL data, and periodically refreshed crypto prices. It surfaces risk tier classifications, stress scores under multiple scenarios, and ranked alpha opportunities for equity and crypto issuers. All data is snapshot-based, not real-time streaming. host: api.aitrailblazer.net --- # api.aitrailblazer.net AITrailblazer serves quantitative analysts, portfolio risk teams, and automated research agents that need structured, filing-backed covenant stress metrics and alpha screening signals. Its DeltaSignal and ATLAS-7 datasets cover corporate debt covenant resilience, crypto issuer stress rankings, and aggregate risk distribution across tracked entities. It is distinct in combining SEC XBRL covenant data with live crypto price adjustments to produce stress scenarios at defined percentile thresholds. ## When to use this host Use this host when an agent needs SEC filing-backed covenant stress analysis, risk tier classification, or DeltaSignal alpha screening for public equities or crypto issuers. It is the right choice for portfolio risk triage workflows, longitudinal stress time-series analysis, and first-pass alpha screening that will be followed by deeper issuer drilldown. Do not use this host for real-time or intraday price feeds, OHLCV market data, or streaming trading signals — use a dedicated market data API (e.g., CoinGecko, Polygon, or similar) for those needs. It is also not suitable for ETF, trust, or fund-level covenant analysis without additional filtering, and should not be used as a standalone buy/sell signal engine — its outputs are screening inputs, not actionable trade recommendations. ## Capabilities ### Aggregate Risk Landscape Provides a top-level view of how covenant stress is distributed across all tracked entities, useful as an entry point for portfolio-level risk dashboards or triage workflows. - **`fetch-risk-distribution`** — Returns the latest covenant stress risk distribution snapshot, with count and percentage for each risk tier (CRITICAL, HIGH, MODERATE, LOW). ### Covenant Stress Screening Screens and retrieves detailed covenant stress metrics for public companies and crypto issuers, including stress scores at multiple scenario percentiles, risk tier classifications, and debt coverage status. - **`fetch-covenant-stress`** — Returns paginated covenant stress rows for public companies, including stress scores at 30/50/70 percentile scenarios, live crypto holdings, debt coverage status, and risk tier classifications. - **`fetch-top-stressed-crypto-issuers`** — Returns a ranked list of the most covenant-stressed crypto issuers from the DeltaSignal ATLAS-7 analysis, including stress scores, risk tiers, and live price-adjusted metrics. ### Alpha Opportunity Identification Ranks and filters equity issuers by DeltaSignal alpha scores, risk tier, and debt coverage status, providing a first-pass screened list for further issuer-level research. - **`fetch-alpha-opportunities`** — Returns a ranked list of DeltaSignal alpha-scored issuers filtered by risk tier, debt coverage status, and scoring date, with market regime and resilience percentiles. ### Historical Stress Time-Series Supplies precomputed historical Atlas stress records keyed by ticker and source_date, enabling time-series joins against mNAV or Mirror Pulse datasets for longitudinal stress analysis. - **`fetch-atlas-history`** — Returns historical Atlas (EDGAR-sourced crypto covenant stress precomputed) records for a given ticker symbol, with metadata for joining to mNAV or Mirror Pulse records by source_date. ## Workflows ### Portfolio Covenant Risk Triage *Use when an agent needs to move from a high-level risk snapshot down to specific stressed entities for deeper review.* 1. **`fetch-risk-distribution`** — Retrieve the current aggregate breakdown of CRITICAL, HIGH, MODERATE, and LOW risk tiers to understand the overall stress landscape. 2. **`fetch-covenant-stress`** — Filter by the risk tiers of concern (e.g., CRITICAL or HIGH) to retrieve per-entity covenant stress details, stress scores, and debt coverage status. 3. **`fetch-top-stressed-crypto-issuers`** — If crypto exposure is relevant, retrieve the ranked list of most-stressed crypto issuers to cross-reference against the broader covenant stress results. ### Alpha Screening to Stress Validation *Use when an agent needs to identify high-alpha equity candidates and then validate their covenant resilience before surfacing them for action.* 1. **`fetch-alpha-opportunities`** — Retrieve a ranked, filtered list of high-alpha issuers from DeltaSignal, optionally scoped by risk tier or debt coverage status. 2. **`fetch-covenant-stress`** — For tickers returned by the alpha screen, retrieve detailed covenant stress scores and scenario percentiles to confirm resilience before further drilldown. ### Longitudinal Stress Analysis *Use when an agent needs to analyze how covenant stress for a specific ticker has evolved over time and join it to other historical datasets.* 1. **`fetch-covenant-stress`** — Retrieve current or recent-period covenant stress snapshots for the target ticker to establish a baseline stress profile. 2. **`fetch-atlas-history`** — Pull the full historical Atlas stress record for the same ticker, keyed by source_date, to enable time-series comparison and joining against mNAV or Mirror Pulse records. ## Skill reference ### `fetch-atlas-history` **Atlas History** — Returns historical Atlas (EDGAR-sourced crypto covenant stress precomputed) records for a given ticker symbol, with metadata for joining to mNAV or Mirror Pulse records by source_date. *Use when:* Use when an agent needs time-series Atlas data for a specific crypto or equity ticker to join against mNAV or Mirror Pulse records by source_date for historical stress analysis. *Not for:* Do not use for real-time or live price feeds; this endpoint returns precomputed historical snapshots and should not be used to apply a single latest Atlas snapshot retroactively across history. **Inputs:** - `ticker` (string, required) — Ticker symbol for which to fetch historical Atlas data. Provided as a path parameter in the URL. **Returns:** Returns a JSON object with data (null or array of Atlas records), join_key ('source_date'), metadata with count/total/limit/offset/coverage/filters, payload_mode, requested/resolved ticker, source identifier, and a usage instruction string. **Example:** `GET https://api.aitrailblazer.net/v1/atlas-history/ETH` --- ### `fetch-alpha-opportunities` **Alpha Opportunities** — Returns a ranked list of DeltaSignal alpha-scored issuers filtered by risk tier, debt coverage status, and scoring date, with market regime and resilience percentiles. *Use when:* Use when an agent needs a screened, ranked list of high-alpha equity issuers from the DeltaSignal dataset, optionally filtered by risk tier or debt coverage status, as a first-pass screening step before deeper issuer drilldown. *Not for:* Do not use as a standalone buy/sell recommendation engine; each returned row requires further drilldown via alpha_signals, company_fundamentals, covenant_stress, or company_report before acting. Not suitable for ETF, trust, or fund vehicles unless include_funds filtering is applied separately. **Inputs:** - `limit` (integer) — Maximum number of rows to return. Defaults to 10, minimum 1, maximum 100. - `source_date` (string) — Optional scoring slice date in YYYY-MM-DD format. Defaults to the latest available DeltaSignal slice. - `risk_tier` (string) — Optional filter for the current risk tier. Allowed values: CRITICAL, HIGH, MODERATE, LOW, UNCLASSIFIED. - `debt_coverage_status` (string) — Optional filter for DeltaSignal debt coverage classification. Allowed values: legitimate_zero_debt, resolved_zero, resolved_nonzero, low_confidence_missing_debt. **Returns:** Returns a ranked opportunities array of alpha-scored issuers with ticker, alpha_score, risk_tier, resilience_percentile, and short_recommendation, plus market_regime, source_date, caveats, identity_summary, and issuer_type_summary. **Example:** `GET https://api.aitrailblazer.net/v1/alpha-opportunities?limit=10&risk_tier=LOW&debt_coverage_status=legitimate_zero_debt&source_date=2026-05-16` --- ### `fetch-covenant-stress` **Covenant Stress Check** — Returns paginated covenant stress rows for public companies, including stress scores at 30/50/70 percentile scenarios, live crypto holdings, debt coverage status, and risk tier classifications. *Use when:* Use when an agent needs to screen or analyze corporate covenant resilience under stress scenarios, filter by risk tier, debt coverage status, or minimum stress threshold, and retrieve XBRL-backed financial stress metrics for one or more filing periods. *Not for:* Do not use for real-time streaming price feeds or intraday trading signals; this endpoint returns computed stress snapshots based on SEC filing data and periodically refreshed crypto prices. **Inputs:** - `source_date` (string) — Optional import source date (YYYY-MM-DD). Defaults to the latest available source date. - `period` (string) — Optional filing period date filter (YYYY-MM-DD). - `risk_tier` (string) — Filter by risk tier. Allowed values: CRITICAL, HIGH, MODERATE, LOW, UNCLASSIFIED. - `quality_flag` (string) — Filter by data quality flag. Allowed values: High, Medium, Low. - `debt_coverage_status` (string) — Optional debt-resolution policy filter. Allowed values: resolved_nonzero, legitimate_zero_debt, low_confidence_missing_debt, resolved_zero. - `min_stress` (number) — Minimum stress_50pct value; only rows at or above this threshold are returned. - `linkbase_only` (boolean) — When true, only return rows where is_linkbase_backed=true. - `limit` (integer) — Maximum number of rows to return. Min 1, max 100, default 25. - `offset` (integer) — Pagination offset. Minimum 0, default 0. **Returns:** Returns a data array of covenant stress rows, each containing entity identifiers, filing-price and live-price stress scores at 30/50/70 percentile scenarios, covenant headroom, debt figures, crypto holdings, risk tier, charge level, and ATLAS model classifications. **Example:** `GET https://api.aitrailblazer.net/v1/covenant-stress?risk_tier=CRITICAL&debt_coverage_status=resolved_nonzero&quality_flag=High&linkbase_only=true&limit=25&offset=0` --- ### `fetch-top-stressed-crypto-issuers` **Top Stressed Crypto Issuers** — Returns a ranked list of the most covenant-stressed crypto issuers from the DeltaSignal ATLAS-7 analysis, including stress scores, risk tiers, and live price-adjusted metrics. *Use when:* Use when an agent needs to identify which crypto issuers are under the highest covenant stress, ranked by stress score, with live risk tier, z-scores, stress velocity, and market regime context. *Not for:* Do not use for general price feeds or historical OHLCV data; use a dedicated market data API instead. Not suitable for non-crypto or traditional equity covenant analysis. **Inputs:** - `limit` (integer) — Maximum number of stressed issuer rows to return. Minimum 1, maximum 100, default 10. - `offset` (integer) — Number of rows to skip for pagination. Minimum 0, default 0. **Returns:** Returns a data array of ranked issuer stress rows, each containing ticker, risk tier, live/snapshot z-scores, covenant headroom, stress velocity, market regime, ATLAS-7 tier, and data quality metadata. **Example:** `GET https://api.aitrailblazer.net/v1/top-stressed?limit=10&offset=0` --- ### `fetch-risk-distribution` **Risk Distribution** — Returns the latest covenant stress risk distribution snapshot, with count and percentage for each risk tier (CRITICAL, HIGH, MODERATE, LOW). *Use when:* Use when an agent needs a current breakdown of covenant stress risk tiers across tracked entities, such as for portfolio risk analytics, dashboard population, or decision-making workflows that require knowing how many entities fall into each risk category. *Not for:* Do not use for per-entity risk details or historical time-series data; this is a fixed-price snapshot of aggregate distribution only. **Returns:** Returns a JSON object with four risk tier keys (CRITICAL, HIGH, MODERATE, LOW), each containing a count (integer) and percentage (float) of entities in that tier. **Example:** `GET https://api.aitrailblazer.net/v1/risk-distribution` ---