{
    "success": true,
    "project": "KepAIx",
    "endpoint": "reasoning",
    "name": "KepAIx Public Reasoning Context API",
    "version": "v1.2",
    "schema_version": "1.2.0",
    "access": "public",
    "status": "available",
    "type": "reasoning_context",
    "mode": "public_educational_api",
    "description": "Educational guidance for interpreting KepAIx public intelligence without exposing protected live reasoning or internal evidence.",
    "request_context": {
        "asset_requested": null,
        "asset_specific_reasoning_available": false,
        "message": "No supported asset-specific reasoning was requested or exposed."
    },
    "reasoning_framework": {
        "principles": [
            {
                "name": "Evidence Before Conclusion",
                "meaning": "KepAIx public conclusions should be interpreted only within the evidence, confidence, freshness, and limitations published with the response."
            },
            {
                "name": "Confidence Is Not Certainty",
                "meaning": "Confidence describes the strength of support for a public classification. It does not represent a guaranteed probability of future performance."
            },
            {
                "name": "Freshness Matters",
                "meaning": "Market conditions may change after a response is generated. Developers should review source timestamps and freshness labels before using an output."
            },
            {
                "name": "Broad State Is Not an Instruction",
                "meaning": "A regime, direction, liquidity state, derivatives state, or consensus label is educational context and is not a recommendation to buy, sell, hold, or allocate funds."
            },
            {
                "name": "Missing Evidence Remains Missing",
                "meaning": "KepAIx public APIs should return unavailable, unknown, or limited states rather than fabricate missing intelligence."
            },
            {
                "name": "Public Outputs Are Constrained",
                "meaning": "Free public APIs expose limited summaries and do not publish protected evidence weighting, internal decision modifiers, portfolio activity, or multi-layer synthesis."
            }
        ]
    },
    "public_terms": {
        "confidence_bands": {
            "HIGH": "The public classification has comparatively strong verified support, but remains uncertain and educational.",
            "MEDIUM": "The public classification has moderate verified support and should be interpreted with caution.",
            "LOW": "The public classification has limited verified support and should not be treated as a strong conclusion.",
            "UNAVAILABLE": "A supported confidence classification is not currently available."
        },
        "freshness_labels": {
            "LIVE": "The published source is within the endpoint\u2019s live freshness window.",
            "RECENT": "The source remains recent but is outside the shortest live window.",
            "STALE": "The source is older than the normal recent-data window and should be interpreted cautiously.",
            "UNKNOWN": "A valid source timestamp was not available."
        },
        "direction_labels": {
            "STRONG_UP": "A strongly upward public directional state.",
            "UP": "An upward public directional state.",
            "WEAK_UP": "A moderately upward public directional state.",
            "NEUTRAL": "No clear upward or downward public directional state.",
            "MIXED": "Verified public evidence does not support one consistent direction.",
            "WEAK_DOWN": "A moderately downward public directional state.",
            "DOWN": "A downward public directional state.",
            "STRONG_DOWN": "A strongly downward public directional state.",
            "UNKNOWN": "A supported public directional state is not currently available."
        },
        "regime_labels": {
            "RISK_ON": "The broad published environment is comparatively supportive of risk-taking behavior.",
            "RISK_OFF": "The broad published environment reflects comparatively defensive or cautious conditions.",
            "MIXED": "Broad market evidence is divided or inconsistent.",
            "NEUTRAL": "The broad market environment does not show a strong risk-on or risk-off classification.",
            "UNKNOWN": "A supported public regime classification is not currently available."
        }
    },
    "usage_guidance": {
        "recommended": [
            "Use public outputs for educational dashboards, comparison tools, research exercises, and developer experimentation.",
            "Display the response timestamp, freshness, confidence band, and limitations with the intelligence.",
            "Treat unavailable and low-confidence values as meaningful limitations.",
            "Use multiple public endpoints only for transparent educational comparison, not as a substitute for protected synthesis.",
            "Preserve the educational-use notice when redisplaying KepAIx intelligence."
        ],
        "not_supported": [
            "Automated trading instructions",
            "Personalized investment recommendations",
            "Portfolio allocation decisions",
            "Guaranteed predictions",
            "Reconstruction of protected Main Brain or Atlas methods",
            "Claims that a public label predicts future price movement"
        ]
    },
    "capability_boundary": {
        "included": [
            "public interpretation guidance",
            "confidence-band meaning",
            "freshness meaning",
            "direction terminology",
            "market-regime terminology",
            "responsible developer-use guidance",
            "public reasoning limitations"
        ],
        "not_included": [
            "current per-asset predictions",
            "current per-asset confidence",
            "raw Main Brain summaries",
            "internal reason strings",
            "price-change evidence",
            "bullish or bearish pressure components",
            "evidence weighting",
            "decision modifiers",
            "historical analogs",
            "cross-engine synthesis",
            "protected Main Brain reasoning",
            "protected Atlas reasoning",
            "portfolio activity",
            "personalized recommendations"
        ]
    },
    "developer_resources": {
        "documentation": {
            "title": "KepAIx API Documentation",
            "url": "https://kepaix.com/api-docs.php"
        },
        "verified_guide": {
            "title": "AI Market Intelligence API",
            "url": "https://kepaix.com/knowledge/ai-market-intelligence-api.php"
        },
        "data_methodology": {
            "title": "KepAIx Data and Methodology",
            "url": "https://kepaix.com/methodology.php"
        },
        "related_main_brain_api": {
            "name": "KepAIx Main Brain API",
            "url": "https://kepaix.com/api/main-brain.php",
            "purpose": "Limited public Main Brain state, confidence, regime, freshness, and aggregate educational performance."
        },
        "related_market_regime_api": {
            "name": "KepAIx Market Regime API",
            "url": "https://kepaix.com/api/market-regime.php",
            "purpose": "Compact public market-regime and confidence summary."
        }
    },
    "expanded_access": {
        "name": "x402 Market Regime Intelligence",
        "availability": "payment_required",
        "protocol": "x402",
        "url": "https://kepaix.com/api/x402-market-regime.php",
        "purpose": "Machine-payable access to expanded verified market intelligence for compatible developer and AI-agent workflows."
    },
    "truth_statement": "This endpoint explains the public KepAIx reasoning framework and interpretation boundaries. It does not publish current per-asset reasoning, internal evidence, protected synthesis, portfolio activity, or trading instructions.",
    "educational_notice": "KepAIx provides educational market intelligence only. This is not financial, investment, trading, tax, legal, betting, gambling, or fund-management advice.",
    "updated_utc": "2026-08-24T10:42:18Z"
}