{
  "access_model": {
    "api_key_bypass": "Internal or pre-authorized clients can use x-api-key or mcp-api-key.",
    "paid_data_routes": [
      "/v1/company-fundamentals/{ticker}",
      "/v1/alpha-signals/{ticker}",
      "/v1/spectra-field-map/{ticker}",
      "/v1/alpha-opportunities",
      "/v1/alpha-opportunities/audit",
      "/v1/covenant-stress/{ticker}",
      "/v1/covenant-stress",
      "/v1/top-stressed",
      "/v1/top-stressed/natural",
      "/v1/peer-ranking/{ticker}",
      "/v1/readiness",
      "/v1/risk-distribution",
      "/v1/daily-changes/latest",
      "/v1/daily-changes/evidence"
    ],
    "payment": "When x402 is enabled, unauthenticated /v1 paid data routes return 402 Payment Required with the route price, network, asset, resource URL, and seller payTo address. When MPP is enabled, matching /mpp/v1 paid data routes return an MPP challenge in WWW-Authenticate and emit Payment-Receipt on verified requests.",
    "public_support_routes": [
      "/help",
      "/openapi.json",
      "/health",
      "/companies"
    ]
  },
  "atlas_tiers": {
    "Coil": "Basic data quality suitable for initial screening.",
    "Oscillator": "Good resonance and linkbase coverage; suitable for most agent workflows.",
    "Tower": "Highest data quality with the strongest issuer-specific linkbase support."
  },
  "available_endpoints": [
    {
      "auth": "x-api-key or x402 payment or MPP payment",
      "description": "Get the latest provenance-rich company fundamentals extracted from the issuer's SEC XBRL filing.",
      "example": "/v1/company-fundamentals/MARA",
      "path": "/v1/company-fundamentals/{ticker}"
    },
    {
      "auth": "x-api-key or x402 payment or MPP payment",
      "description": "Get deterministic Phase 1 alpha, resilience, treasury-strength, and regime-fit signals for a single issuer using the current DeltaSignal slice.",
      "example": "/v1/alpha-signals/BMNR",
      "path": "/v1/alpha-signals/{ticker}"
    },
    {
      "auth": "x-api-key or x402 payment or MPP payment",
      "description": "Get the SPECTRA field-map contract for one issuer, including real source lineage plus derived pressure, stored energy, price echo, filing choreography, and chart read labels. For ATLAS-derived contracts, canonical stress/headroom/fair-value fields are preserved in the response.",
      "example": "/v1/spectra-field-map/RIOT",
      "path": "/v1/spectra-field-map/{ticker}"
    },
    {
      "auth": "x-api-key or x402 payment or MPP payment",
      "description": "Rank the current DeltaSignal slice by deterministic Phase 1 alpha score, including visible data-quality notes and resilience percentile context.",
      "example": "/v1/alpha-opportunities?limit=10",
      "path": "/v1/alpha-opportunities"
    },
    {
      "auth": "x-api-key or x402 payment or MPP payment",
      "description": "Explain the alpha-opportunity board's issuer-type, identity, quality, and board-rank gates, including samples of rows excluded from the default operating-company view or demoted below raw alpha rank.",
      "example": "/v1/alpha-opportunities/audit?limit=10",
      "path": "/v1/alpha-opportunities/audit"
    },
    {
      "auth": "x-api-key or x402 payment or MPP payment",
      "description": "Get covenant stress under Bitcoin price shocks with ATLAS semantic fields such as charge_level, resonance_status, discharge_risk, live-adjusted overlay fields, and daily stress-velocity context.",
      "example": "/v1/covenant-stress/RIOT",
      "path": "/v1/covenant-stress/{ticker}"
    },
    {
      "auth": "x-api-key or x402 payment or MPP payment",
      "description": "Screen covenant stress rows by source date, risk tier, quality flag, minimum stress, and linkbase backing. Rows include both filing-static and live-overlay fields.",
      "example": "/v1/covenant-stress?risk_tier=HIGH\u0026min_stress=0.7\u0026linkbase_only=true\u0026limit=10",
      "path": "/v1/covenant-stress"
    },
    {
      "auth": "x-api-key or x402 payment or MPP payment",
      "description": "List the most stressed issuers in the current DeltaSignal slice using live-adjusted stress when daily BTC/ETH price overlay coverage is available, including 24h/7d movement context.",
      "example": "/v1/top-stressed?limit=5",
      "path": "/v1/top-stressed"
    },
    {
      "auth": "x-api-key or x402 payment or MPP payment",
      "description": "Render the Top Stressed screen into audit-grade Markdown with preserved ranks, stress values, caveats, billing metadata, and raw evidence hash.",
      "example": "/v1/top-stressed/natural?limit=5\u0026style=professional",
      "path": "/v1/top-stressed/natural"
    },
    {
      "auth": "x-api-key or x402 payment or MPP payment",
      "description": "Get peer covenant ranking with system-wide Mirror Pulse resonance context. Ranking is derived from the latest precomputed slice and inherits live-overlay stress ordering when available.",
      "example": "/v1/peer-ranking/MARA",
      "path": "/v1/peer-ranking/{ticker}"
    },
    {
      "auth": "x-api-key or x402 payment or MPP payment",
      "description": "Get the latest risk-tier distribution for the current DeltaSignal slice.",
      "example": "/v1/risk-distribution",
      "path": "/v1/risk-distribution"
    },
    {
      "auth": "x-api-key or x402 payment or MPP payment",
      "description": "Check freshness and readiness of the current precomputed DeltaSignal slice, including Wardenclyffe coherence, BTC momentum, market regime, live-price overlay coverage, and latest_day, latest_week, and latest_month coverage windows.",
      "example": "/v1/readiness",
      "path": "/v1/readiness"
    },
    {
      "auth": "x-api-key or x402 payment or MPP payment",
      "description": "Get the latest compact Daily Monitoring snapshot with changed and new company lists, freshness fields, and evidence references.",
      "example": "/v1/daily-changes/latest",
      "path": "/v1/daily-changes/latest"
    },
    {
      "auth": "x-api-key or x402 payment or MPP payment",
      "description": "Get paginated raw Company Facts tag evidence for one issuer from the daily-change proof layer. Requires ticker or CIK.",
      "example": "/v1/daily-changes/evidence?ticker=ARKB\u0026source_date=2026-05-08\u0026limit=100",
      "path": "/v1/daily-changes/evidence"
    },
    {
      "description": "List the currently supported DeltaSignal issuer universe from the latest covered source_date slice, with optional search and limit filters.",
      "example": "/companies?search=MARA\u0026limit=25",
      "path": "/companies"
    },
    {
      "description": "This help page with ATLAS framing, example questions, and endpoint guidance.",
      "path": "/help"
    },
    {
      "description": "Full machine-readable OpenAPI specification for agents and integrations.",
      "path": "/openapi.json"
    }
  ],
  "core_metaphor": {
    "key_concepts": [
      "Charge (ST) - stored balance-sheet tension",
      "Resonance (MP) - system alignment between scarcity and issuer stress",
      "Discharge - release events such as covenant pressure, liquidation, or forced deleveraging"
    ],
    "meaning": "ATLAS models stored balance-sheet stress as charge, system alignment as resonance, and sharp downside realization as discharge.",
    "name": "Markets as Tesla Coils"
  },
  "description": "Provenance-rich company fundamentals, covenant stress, peer ranking, and readiness signals for crypto public companies using SEC XBRL data, issuer-specific Calculation Linkbases where available, and a persisted daily BTC/ETH momentum-aware live-price overlay.",
  "documentation": {
    "help": "https://api.aitrailblazer.net/help",
    "openapi": "https://api.aitrailblazer.net/openapi.json"
  },
  "example_questions": [
    "Which companies are currently supported by DeltaSignal?",
    "What is RIOT's covenant stress if Bitcoin drops 50%?",
    "Which crypto public companies currently rank highest on DeltaSignal Phase 1 alpha?",
    "Show me BMNR's Alpha Signals breakdown and treasury narrative.",
    "Which crypto issuer currently has the highest discharge risk?",
    "Is MARA's coil critically charged right now?",
    "Are the coils resonating for CLSK?",
    "Show me the top 5 most stressed crypto issuers."
  ],
  "field_glossary": {
    "atlas_fields": {
      "atlas_tier": "Data quality tier for the resolved issuer view. Tower is the strongest structural support.",
      "charge_level": "ATLAS interpretation of how stressed the balance sheet is under the current scenario set.",
      "discharge_risk": "Expected downside release risk if the issuer's balance-sheet stress resolves abruptly.",
      "mp_z": "Mirror Pulse z-score used to summarize system resonance.",
      "resonance_status": "Whether issuer-specific stress and broader system conditions are reinforcing each other."
    },
    "data_source_values": {
      "direct_facts_fallback": "Fallback direct-facts path used when linkbase support is insufficient.",
      "linkbase_rollup": "Totals assembled through recursive XBRL calculation-linkbase rollup.",
      "linkbase_rooted_facts": "Totals pulled from explicit rooted facts linked to trusted concepts."
    },
    "debt_coverage_status": {
      "legitimate_zero_debt": "The issuer is treated as structurally zero-debt rather than unresolved.",
      "low_confidence_missing_debt": "Debt evidence is too weak, sparse, or conflicting to classify confidently.",
      "resolved_nonzero": "A credible debt root was resolved and debt is non-zero.",
      "resolved_zero": "A debt root was resolved but the resulting balance is zero."
    },
    "live_price_fields": {
      "btc_24h_change_pct": "BTC/USD percentage change versus the persisted 24-hour reference point used by the momentum layer.",
      "btc_7d_change_pct": "BTC/USD percentage change versus the persisted 7-day reference point used by the momentum layer.",
      "crypto_units_basis": "Whether BTC/ETH units came from reported quantity facts or from a filing-period fair-value estimate.",
      "live_mp_z": "Mirror Pulse recomputed from the live-overlay stress inputs.",
      "live_price_coverage_count": "Number of resolved issuers in the current readiness slice that are covered by the live-price overlay.",
      "live_prices_active": "Readiness-level flag showing whether the current slice has any issuers covered by the live-price overlay.",
      "live_stress_50pct": "Stress ratio under a 50% crypto price shock after repricing holdings with the daily BTC/ETH snapshot.",
      "live_stress_delta_24h": "Change in live_stress_50pct versus the implied 24-hour-prior BTC/ETH price state.",
      "live_stress_delta_7d": "Change in live_stress_50pct versus the implied 7-day-prior BTC/ETH price state.",
      "market_regime": "Deterministic market regime classification combining BTC momentum, Wardenclyffe coherence, and stress concentration.",
      "price_last_updated": "UTC timestamp of the persisted BTC/ETH snapshot used for the live overlay.",
      "price_source": "Market-data source used for the most recent persisted BTC/ETH snapshot.",
      "reference_price_date": "Filing-period date used when BTC/ETH units were estimated from reported fair value instead of direct quantity facts.",
      "stress_velocity": "rising, stable, or falling based on the 24-hour live stress delta.",
      "uses_live_prices": "True when BTC/ETH holdings were repriced using the daily persisted market snapshot."
    },
    "provenance_fields": {
      "extension_root_concepts": "Extension concepts that participated in the winning root path. Always an array.",
      "mapping_hit_count": "Count of issuer-specific root mappings applied during resolution.",
      "root_resolution_details": "Compact provenance trail for the selected roots. Always an array, empty when no detail applies.",
      "root_resolution_method": "Primary resolver path used to select the winning debt or crypto root."
    },
    "readiness_fields": {
      "companyfacts_delta_window": "Azure Blob CompanyFacts delta artifacts for every available date between the latest meaningful tracked-issuer delta day and the latest computed source date.",
      "filing_source_date": "Mirrored companyfacts.zip date backing the current slice when recompute-only days advance the computed source_date.",
      "source_date": "Promoted daily-change snapshot date for the served issuer-delta story. Use latest_computed_source_date and latest_companyfacts_delta_source_date for compute/artifact freshness."
    }
  },
  "framework": "ATLAS (Tesla Coil Electrodynamic Model)",
  "how_to_use": "Pay close attention to atlas_tier, charge_level, resonance_status, discharge_risk, and peer_rank. Data routes accept the existing x-api-key path and can also be exposed through x402 when the paid access layer is enabled.",
  "service": "DeltaSignal - Crypto Corporate Risk Intelligence",
  "time_windows": {
    "latest_day": "The most recent source_date slice.",
    "latest_month": "Coverage summary for the last 30 source_date values relative to the latest available slice.",
    "latest_week": "Coverage summary for the last 7 source_date values relative to the latest available slice."
  },
  "version": "1.5.1",
  "wardenclyffe": {
    "description": "Wardenclyffe is the system-level coherence layer above individual issuer coils. Phase 1 measures synchronization across the resolved issuer field without claiming directional contagion.",
    "phase": "phase_1_coherence",
    "scope": "resolved_nonzero high-stress issuers from the latest readiness slice",
    "status_values": {
      "building": "Stress synchronization is developing across the resolved issuer field.",
      "insufficient_data": "Fewer than the minimum high-stress issuer sample are available for a stable coherence reading.",
      "isolated": "Stress appears concentrated in a small or weakly synchronized subset of issuers.",
      "synchronized": "A larger stressed subset is moving in tighter resonance and deserves systemic attention."
    }
  }
}