{"openapi":"3.1.0","info":{"title":"ForgeMesh Crypto Signals API","version":"1.0.0","description":"Paid crypto market-intelligence API for autonomous agents: crypto signals, whale/CEX/bridge flow alerts, calibrated price ranges, risk state, preflight checks, decision journals, and outcome audits via x402.","x-guidance":"Use this API when the user asks about crypto market signals, whale/CEX/bridge flows, price forecasts, risk state, momentum, conviction scores, or wants a journaled crypto market-intelligence decision with audit trail. Returns real-time quantitative intelligence with calibration scores, not web-search summaries. Example questions: 'What are the top bullish crypto signals right now?', 'Are there whale alerts on Base?', 'Give me a BTC price forecast', 'Is it risky to trade crypto right now?', 'Make a crypto market decision on ETH and log it'. Routes: GET /api/signals ($0.05), GET /api/whale?chain=base&hours=4 ($0.02), GET /api/kronos/forecast?symbol=BTC ($0.05), GET /api/kronos/decision?symbol=ETH ($0.15), GET /api/kronos/risk ($0.02). Chain a decision with GET /api/kronos/audit?decision_id=X ($0.07).","contact":{"email":"clawdbotworker@gmail.com"}},"servers":[{"url":"https://crypto.forgemesh.io","description":"Production"}],"paths":{"/":{"get":{"operationId":"viewKronosMarketIntelligence","tags":["Utility"],"summary":"CoinOpAI Kronos Market Intelligence dashboard","security":[],"responses":{"200":{"description":"HTML dashboard for Kronos market intelligence and ForgeMesh x402 services.","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/feedback":{"post":{"operationId":"submitFeedback","tags":["Utility"],"summary":"Send paid feedback or suggestions","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"type":{"type":"string","enum":["general","symbol_request","logic_suggestion","bug","integration","hello"]},"message":{"type":"string","maxLength":2000},"symbol":{"type":"string","description":"Optional symbol, e.g. AAPL or BTC"},"endpoint":{"type":"string","description":"Optional endpoint this feedback is about"},"contact":{"type":"string","description":"Optional contact handle/email"}}}}}},"responses":{"200":{"description":"Feedback accepted into a write-only inbox","content":{"application/json":{"schema":{"type":"object","properties":{"feedback_id":{"type":"string"},"status":{"type":"string"}}}}}},"400":{"description":"Invalid feedback payload"},"402":{"description":"Payment Required"}}}},"/api/kronos/signals":{"get":{"operationId":"getKronosSignals","tags":["Trading","Crypto","Intelligence"],"summary":"Latest Kronos market context","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Current crypto and stock market context. Directional values are observations for research and decision support only. Includes per-symbol score_details and data_quality where available.","content":{"application/json":{"schema":{"type":"object","properties":{"response_schema_version":{"type":"string"},"compliance_mode":{"type":"string"},"generated_for":{"type":"string"},"ts":{"type":"string"},"timeframe":{"type":"string"},"signals":{"type":"object"},"score_details":{"type":"object","description":"Per-symbol scoring breakdown keyed by symbol","additionalProperties":{"type":"object","properties":{"kronos_pct":{"type":"number","description":"Raw Kronos signal percentage"},"conviction":{"type":"number","description":"Weighted conviction score 0-100"},"tech_score":{"type":"number"},"inst_score":{"type":"number"},"macro_mod":{"type":"number"},"component_weights":{"type":"object","description":"Nominal reference weights (always 40/30/20/10)"},"effective_weights":{"type":"object","description":"Actual weights used — redistributed when a component is unavailable (e.g. crypto: 55/0/30/15)","properties":{"kronos":{"type":"number"},"institutional":{"type":"number"},"technical":{"type":"number"},"macro":{"type":"number"}}},"component_availability":{"type":"object","description":"Which scoring components had data for this asset","properties":{"kronos":{"type":"boolean"},"institutional":{"type":"boolean"},"technical":{"type":"boolean"},"macro":{"type":"boolean"}}},"reweight_reason":{"type":"string","description":"Human-readable explanation when weights were redistributed; absent when standard weights apply"},"component_contributions":{"type":"object"},"thresholds":{"type":"object"},"interpretation":{"type":"string"},"decision_basis":{"type":"string"}}}},"data_quality":{"type":"object"},"top_k":{"type":"array"},"signal_age_hours":{"type":"number"},"data_freshness":{"type":"string"},"risk_disclosure":{"type":"object"}}}}}},"402":{"description":"Payment Required"}}}},"/api/kronos/risk":{"get":{"operationId":"getKronosRisk","tags":["Trading","Crypto"],"summary":"Current market risk state","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Risk state: NORMAL/HALTED/COOLDOWN","content":{"application/json":{"schema":{"type":"object","properties":{"response_schema_version":{"type":"string"},"compliance_mode":{"type":"string"},"generated_for":{"type":"string"},"state":{"type":"string"},"signal_streak":{"type":"object"},"cooldown":{"type":"object"},"last_updated":{"type":"string"},"data_freshness":{"type":"string"},"why_not_high":{"type":"array","items":{"type":"string"}},"risk_disclosure":{"type":"object"}}}}}},"402":{"description":"Payment Required"}}}},"/api/kronos/history":{"get":{"operationId":"getKronosHistory","tags":["Trading","Crypto","Intelligence"],"summary":"Recent Kronos context history","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"hours","in":"query","description":"Hours of history (max 168)","schema":{"type":"integer","default":24,"maximum":168}}],"responses":{"200":{"description":"Context history array for research and decision support","content":{"application/json":{"schema":{"type":"object","properties":{"response_schema_version":{"type":"string"},"compliance_mode":{"type":"string"},"generated_for":{"type":"string"},"count":{"type":"integer"},"hours":{"type":"integer"},"signals":{"type":"array"},"risk_disclosure":{"type":"object"}}}}}},"402":{"description":"Payment Required"}}}},"/api/kronos/decision":{"get":{"operationId":"getKronosDecision","tags":["Trading","Crypto","Forecast","Intelligence"],"summary":"Market-intelligence decision journal with anomaly, calibration, verification, disclaimers, and decision_id","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.150000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","description":"Crypto or stock symbol, e.g. BTC, ETH, AAPL, SPY, NVDA","schema":{"type":"string","default":"BTC"}}],"responses":{"200":{"description":"Market-intelligence journal entry with anomaly scoring, calibrated confidence, rule verification, hard liability disclaimers, and an accountability ID for later audit. No field is a market activity instruction.","content":{"application/json":{"schema":{"type":"object","properties":{"response_schema_version":{"type":"string"},"compliance_mode":{"type":"string"},"generated_for":{"type":"string"},"decision_id":{"type":"string"},"symbol":{"type":"string"},"market_intelligence_only":{"type":"boolean"},"directional_bias":{"type":"string","enum":["upward","downward","neutral"]},"raw_directional_bias":{"type":"string","enum":["upward","downward","neutral"]},"anomaly_review_label":{"type":"string","description":"Review/gating label for downstream market-intelligence workflows."},"exposure_context":{"type":"object","description":"Reference exposure context, not a market activity instruction."},"legacy_fields":{"type":"object"},"confidence":{"type":"number"},"anomaly_score":{"type":"number"},"anomaly_level":{"type":"string"},"agreement_score":{"type":"number"},"verified":{"type":"boolean"},"calibrated_confidence":{"type":"number"},"signal_safety":{"type":"object"},"risk_disclosure":{"type":"object"},"why_not_high":{"type":"array","items":{"type":"string"}},"regime":{"type":"string"},"score_details":{"type":"object"},"data_quality":{"type":"object"},"observation_thresholds":{"type":"object"},"action_thresholds":{"type":"object","description":"Legacy compatibility object.","deprecated":true},"decision_explanation":{"type":"string"},"signal_age_hours":{"type":"number"},"next_step":{"type":"object"}}}}}},"402":{"description":"Payment Required"}}}},"/api/kronos/preflight":{"get":{"operationId":"getKronosPreflight","tags":["Trading","Crypto"],"summary":"Market-state preflight check","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","description":"Crypto or stock symbol, e.g. BTC, ETH, AAPL, SPY, NVDA","schema":{"type":"string","default":"BTC"}}],"responses":{"200":{"description":"Market-state, risk-state, review-level, and data-freshness context","content":{"application/json":{"schema":{"type":"object","properties":{"response_schema_version":{"type":"string"},"compliance_mode":{"type":"string"},"generated_for":{"type":"string"},"symbol":{"type":"string"},"allowed":{"type":"boolean","description":"Legacy gate flag; not a market activity instruction."},"review_level":{"type":"string"},"directional_bias":{"type":"string"},"market_state":{"type":"string"},"risk_state":{"type":"string"},"in_cooldown":{"type":"boolean"},"signal_strength":{"type":"string"},"score_details":{"type":"object"},"data_quality":{"type":"object"},"observation_thresholds":{"type":"object"},"action_thresholds":{"type":"object","deprecated":true},"decision_explanation":{"type":"string"},"warnings":{"type":"array","items":{"type":"string"}},"risk_disclosure":{"type":"object"}}}}}},"402":{"description":"Payment Required"}}}},"/api/kronos/audit":{"get":{"operationId":"getKronosAudit","tags":["Trading","Crypto","Intelligence"],"summary":"Audit market-intelligence outcome against real prices","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.070000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"decision_id","in":"query","required":true,"description":"UUID from /api/kronos/decision","schema":{"type":"string"}},{"name":"window","in":"query","description":"Evaluation window","schema":{"type":"string","enum":["1h","4h","24h"],"default":"4h"}}],"responses":{"200":{"description":"Outcome audit with verdict and compliance metadata","content":{"application/json":{"schema":{"type":"object","properties":{"response_schema_version":{"type":"string"},"compliance_mode":{"type":"string"},"generated_for":{"type":"string"},"decision_id":{"type":"string"},"symbol":{"type":"string"},"directional_bias":{"type":"string"},"legacy_fields":{"type":"object"},"verdict":{"type":"string","enum":["GOOD_DECISION","BAD_DIRECTION","NOISE","NO_ACTION_TAKEN","PENDING"]},"outcome":{"type":"object"},"risk_disclosure":{"type":"object"}}}}}},"402":{"description":"Payment Required"},"404":{"description":"decision_id not found"}}}},"/api/kronos/forecast":{"get":{"operationId":"getKronosForecast","tags":["Trading","Crypto","Forecast"],"summary":"Conformally-calibrated price forecast with an honest 80% range","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","description":"Symbol: BTC, ETH, SOL, XRP, ADA","schema":{"type":"string","default":"BTC"}}],"responses":{"200":{"description":"Calibrated 80% prediction interval (range_80, ~0.80 empirical coverage) plus point return and upside probability. Directional bias is supporting context; the calibrated range is the product.","content":{"application/json":{"schema":{"type":"object","properties":{"response_schema_version":{"type":"string"},"compliance_mode":{"type":"string"},"generated_for":{"type":"string"},"symbol":{"type":"string"},"horizon":{"type":"string"},"current_price":{"type":"number"},"point_return":{"type":"number"},"upside_probability":{"type":"number"},"range_80":{"type":"object","properties":{"low":{"type":"number"},"high":{"type":"number"},"coverage_target":{"type":"number"},"method":{"type":"string"}}},"data_freshness":{"type":"string"},"why_not_high":{"type":"array","items":{"type":"string"}},"liability_disclaimer":{"type":"object"}}}}}},"402":{"description":"Payment Required"}}}},"/api/signals":{"get":{"operationId":"getCryptoSignals","tags":["Crypto","Intelligence"],"summary":"Current crypto market-intelligence signals","description":"Canonical ForgeMesh Crypto endpoint for current BTC, ETH, SOL, XRP, and ADA signal context. Legacy compatibility path: /api/kronos/signals.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Current crypto market context, score details, top signals, freshness, and market-intelligence disclaimers.","content":{"application/json":{"schema":{"type":"object","properties":{"response_schema_version":{"type":"string"},"compliance_mode":{"type":"string"},"generated_for":{"type":"string"},"ts":{"type":"string"},"timeframe":{"type":"string"},"signals":{"type":"object"},"score_details":{"type":"object"},"data_quality":{"type":"object"},"top_k":{"type":"array"},"signal_age_hours":{"type":"number"},"data_freshness":{"type":"string"},"risk_disclosure":{"type":"object"},"_canonical":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}},"/signal/{symbol}":{"get":{"operationId":"getSingleCryptoSignal","tags":["Crypto","Intelligence"],"summary":"Single-symbol crypto signal lookup","description":"Compatibility alias for agents that guess RESTful /signal/BTCUSDT paths. Prefer canonical GET /api/signals for the full market snapshot.","deprecated":true,"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"symbol","in":"path","required":true,"description":"Symbol such as BTC, BTCUSD, BTCUSDT, or BTC/USD","schema":{"type":"string"}}],"responses":{"200":{"description":"Single-symbol signal, score details, data quality, freshness, and canonical route pointer.","content":{"application/json":{"schema":{"type":"object","properties":{"response_schema_version":{"type":"string"},"compliance_mode":{"type":"string"},"generated_for":{"type":"string"},"symbol":{"type":"string"},"signal_state":{"type":"number"},"signal":{"type":"number","deprecated":true},"legacy_fields":{"type":"object"},"score_details":{"type":"object"},"data_quality":{"type":"object"},"ts":{"type":"string"},"regime":{"type":"string"},"data_freshness":{"type":"string"},"signal_age_hours":{"type":"number"},"risk_disclosure":{"type":"object"},"_canonical":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}},"/api/whale":{"get":{"operationId":"getCryptoWhaleAlerts","tags":["Crypto","Onchain","Intelligence"],"summary":"Whale, CEX, bridge, and stablecoin flow alerts","description":"Crypto-facing alias over the ForgeMesh anomaly event collector. Returns monitored whale-scale transfers, exchange flows, bridge flows, and stablecoin issuer events by chain and lookback window.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"chain","in":"query","description":"Chain to inspect","schema":{"type":"string","enum":["ethereum","base","arbitrum"],"default":"base"}},{"name":"hours","in":"query","description":"Lookback window in hours, 1-168","schema":{"type":"integer","default":4,"minimum":1,"maximum":168}}],"responses":{"200":{"description":"Whale, exchange, bridge, and stablecoin flow alerts collected from Blockscout-backed anomaly monitoring.","content":{"application/json":{"schema":{"type":"object","properties":{"response_schema_version":{"type":"string"},"compliance_mode":{"type":"string"},"generated_for":{"type":"string"},"source":{"type":"string"},"source_endpoint":{"type":"string"},"chain":{"type":"string"},"window_hours":{"type":"integer"},"alert_count":{"type":"integer"},"alerts":{"type":"array"},"risk_disclosure":{"type":"object"}}}}}},"400":{"description":"Invalid chain or lookback"},"402":{"description":"Payment Required"}}}}},"x-x402":{"network":"eip155:8453","payTo":"0x93A1F57D2e0DBE4cc882b5DbAEbe7F0F16443338","facilitator":"https://x402.xyz/facilitate","extensions":{"bazaar":{"status":"live","purpose":"Agent marketplace discovery with input/output examples and schemas on all paid routes."},"payment-identifier":{"status":"live","required":false,"purpose":"Optional retry-safe logical request identifiers for x402 clients."},"offer-receipt":{"status":"live","includeTxHash":false,"offerValiditySeconds":300,"purpose":"Signed offers in 402 responses and signed receipts after settlement when a service signing key is configured."},"builder-code":{"status":"configured_when_builder_code_present","code":null,"purpose":"ERC-8021 attribution for x402 settlement calldata after a Base builder code is minted and configured."},"sign-in-with-x":{"status":"not_needed_for_one_shot_paid_outputs"},"eip2612-gas-sponsoring":{"status":"not_exported_by_installed_extensions_package"},"erc20-approval-gas-sponsoring":{"status":"not_exported_by_installed_extensions_package"}}}}