{
  "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/alpha-opportunities",
      "/v1/covenant-stress/{ticker}",
      "/v1/covenant-stress",
      "/v1/top-stressed",
      "/v1/peer-ranking/{ticker}",
      "/v1/readiness",
      "/v1/risk-distribution",
      "/v1/daily-changes/latest"
    ],
    "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": "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": "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": "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 published SEC daily-changes snapshot with changed and new company lists.",
      "example": "/v1/daily-changes/latest",
      "path": "/v1/daily-changes/latest"
    },
    {
      "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": {
      "filing_source_date": "Mirrored companyfacts.zip date backing the current slice when recompute-only days advance the computed source_date.",
      "source_date": "Latest computed DeltaSignal slice date."
    }
  },
  "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."
    }
  }
}