{"openapi":"3.1.0","info":{"title":"Kronos by ForgeMesh API","version":"1.0.0","description":"Kronos by ForgeMesh is a paid market-intelligence API for autonomous agents: live crypto signals, 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. Typical agent tasks: get a current Bitcoin market snapshot, check Ethereum upside probability before a trade decision, pull a calibrated 80% price range instead of a point guess, run a pre-trade risk gate, catch a whale-scale exchange inflow on Base, or log a crypto decision with a decision_id for later audit. 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://kronos.forgemesh.io","description":"Production"}],"paths":{"/":{"get":{"operationId":"viewKronosMarketIntelligence","tags":["Utility"],"summary":"Kronos by ForgeMesh 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":{}},{"mpp":{}}],"offers":[{"intent":"charge","method":"evm","amount":"5000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]},"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":{}},{"mpp":{}}],"offers":[{"intent":"charge","method":"evm","amount":"50000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]},"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","description":"Current crypto market risk state (NORMAL/HALTED/COOLDOWN) with per-symbol signal streaks and active cooldown timers for BTC, ETH, SOL, XRP, and ADA. Use it as a pre-trade risk gate before a trading agent acts, to check whether a symbol is in cooldown after a recent flip, to confirm streak length for momentum context, or to add a safety check ahead of a /api/kronos/decision call. Risk state is planning context, not a market-safety guarantee.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}},{"mpp":{}}],"offers":[{"intent":"charge","method":"evm","amount":"20000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]},"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":{}},{"mpp":{}}],"offers":[{"intent":"charge","method":"evm","amount":"50000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]},"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","description":"Full market-intelligence decision journal for BTC, ETH, SOL, XRP, ADA, and supported stocks: combines signal score, anomaly review, and confidence calibration into one auditable record with directional_bias, calibrated_confidence, anomaly_score, and a decision_id. Use it to log an autonomous agent's market call for later audit, or get calibrated confidence instead of raw signal strength. No field is a market activity instruction; pair with /api/kronos/audit to close the loop.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.150000"},"protocols":[{"x402":{}},{"mpp":{}}],"offers":[{"intent":"charge","method":"evm","amount":"150000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]},"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":{}},{"mpp":{}}],"offers":[{"intent":"charge","method":"evm","amount":"50000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]},"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":{}},{"mpp":{}}],"offers":[{"intent":"charge","method":"evm","amount":"70000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]},"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","description":"Conformally-calibrated price forecast returning an empirically-validated 80% interval (range_80), current_price, point_return, and upside_probability for BTC, ETH, SOL, XRP, and ADA. Use it for a short-horizon Bitcoin price range, an Ethereum upside-probability check before a trade decision, confidence bands to feed a risk model, or forecast-width comparisons across symbols. Directional bias is supporting context; the calibrated range is the product.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}},{"mpp":{}}],"offers":[{"intent":"charge","method":"evm","amount":"50000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]},"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/kronos/futures/decision":{"get":{"operationId":"getKronosFuturesDecision","tags":["Trading","Crypto","Futures"],"summary":"Perpetual-futures decision package: direction, stop/target on the calibrated range, leverage cap, liquidation, sizing, funding","description":"Kronos Futures turns the spot signal into a perp-ready package for BTC, ETH, SOL, XRP, or ADA: direction LONG / SHORT / FLAT, stop-loss and take-profit placed on the conformally-calibrated 80% range, a leverage cap that keeps liquidation outside 2x the stop distance (hard-capped by Kronos risk state: NORMAL 3x, ELEVATED 2x, HIGH 1x), liquidation price, risk-based position size for the caller's equity and max loss, and live perp funding cost or credit over the forecast horizon from Kraken Futures and Hyperliquid. Bearish signals become sized shorts instead of 'stay out'. Market intelligence only; no exchange execution.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.150000"},"protocols":[{"x402":{}},{"mpp":{}}],"offers":[{"intent":"charge","method":"evm","amount":"150000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]},"parameters":[{"name":"symbol","in":"query","description":"Symbol: BTC, ETH, SOL, XRP, ADA","schema":{"type":"string","default":"BTC"}},{"name":"equity","in":"query","description":"Account equity in USD for position sizing (optional)","schema":{"type":"number"}},{"name":"max_loss_pct","in":"query","description":"Max loss per position as a fraction of equity (default 0.01)","schema":{"type":"number","default":0.01}},{"name":"max_leverage","in":"query","description":"Caller leverage ceiling, 1-5 (default 5)","schema":{"type":"number","default":5}}],"responses":{"200":{"description":"Futures decision package with direction, levels, leverage envelope, liquidation, position sizing, funding impact, warnings, and risk disclosure.","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"direction":{"type":"string","enum":["LONG","SHORT","FLAT"]},"risk_state":{"type":"string"},"data_freshness":{"type":"string"},"entry_reference_price":{"type":"number"},"range_80":{"type":"object"},"levels":{"type":"object","properties":{"stop_loss":{"type":"number"},"take_profit":{"type":"number"},"stop_distance_pct":{"type":"number"},"reward_to_risk":{"type":"number"}}},"leverage":{"type":"object","properties":{"suggested_leverage":{"type":"number"},"max_leverage_by_range":{"type":"number"},"max_leverage_by_risk_state":{"type":"number"},"binding_constraint":{"type":"string"},"liquidation_price":{"type":"number"},"liquidation_distance_pct":{"type":"number"}}},"position":{"type":"object"},"funding":{"type":"object"},"funding_impact":{"type":"object"},"warnings":{"type":"array","items":{"type":"string"}},"flat_reasons":{"type":"array","items":{"type":"string"}},"audit_url":{"type":"string"},"risk_disclosure":{"type":"object"}}}}}},"402":{"description":"Payment Required"}}}},"/api/kronos/futures/funding":{"get":{"operationId":"getKronosFuturesFunding","tags":["Trading","Crypto","Futures"],"summary":"Live perp funding, mark/index, open interest, and crowding across Kraken Futures and Hyperliquid","description":"Live perpetual-futures funding rates (1h, 8h, annualized), mark and index price, open interest, and 24h volume for BTC, ETH, SOL, XRP, and ADA from Kraken Futures and Hyperliquid, with a per-symbol consensus, who-pays-whom, and a LONG_CROWDED / SHORT_CROWDED / BALANCED crowding label. Cached 5 minutes. Use it to price carry or spot a crowded side before a leveraged position.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}},{"mpp":{}}],"offers":[{"intent":"charge","method":"evm","amount":"20000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]},"parameters":[{"name":"symbol","in":"query","description":"Optional single symbol; omit for all five","schema":{"type":"string"}}],"responses":{"200":{"description":"Per-symbol venue rows and consensus funding snapshot.","content":{"application/json":{"schema":{"type":"object","properties":{"fetched_at":{"type":"string"},"stale":{"type":"boolean"},"venue_errors":{"type":"array"},"symbols":{"type":"object"},"risk_disclosure":{"type":"object"}}}}}},"402":{"description":"Payment Required"},"503":{"description":"No futures venue reachable"}}}},"/api/kronos/futures/risk":{"get":{"operationId":"getKronosFuturesRisk","tags":["Trading","Crypto","Futures"],"summary":"Will this leveraged perp position survive the calibrated range?","description":"Stress a side, leverage, and entry against the conformally-calibrated 80% range: liquidation price and distance, the adverse range bound, a SURVIVES_RANGE / THIN_BUFFER / LIQUIDATION_INSIDE_RANGE verdict, the maximum leverage that still survives the range, P&L at both range bounds, and funding cost over the horizon. Use it as a pre-trade gate or to stress an open position.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}},{"mpp":{}}],"offers":[{"intent":"charge","method":"evm","amount":"50000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]},"parameters":[{"name":"symbol","in":"query","description":"Symbol: BTC, ETH, SOL, XRP, ADA","schema":{"type":"string","default":"BTC"}},{"name":"side","in":"query","required":true,"description":"LONG or SHORT","schema":{"type":"string","enum":["LONG","SHORT"]}},{"name":"leverage","in":"query","required":true,"description":"Leverage to test (1-125)","schema":{"type":"number"}},{"name":"entry","in":"query","description":"Entry price; defaults to current perp mark","schema":{"type":"number"}},{"name":"notional","in":"query","description":"Position notional in USD for funding cost","schema":{"type":"number"}},{"name":"horizon_hours","in":"query","description":"Hours held for funding cost; defaults to forecast horizon","schema":{"type":"number"}}],"responses":{"200":{"description":"Survivability verdict with liquidation math, range bounds, P&L envelope, and funding impact.","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"side":{"type":"string"},"entry_price":{"type":"number"},"leverage":{"type":"number"},"range_80":{"type":"object"},"liquidation_price":{"type":"number"},"liquidation_distance_pct":{"type":"number"},"adverse_move_pct":{"type":"number"},"survives_calibrated_range":{"type":"boolean"},"max_leverage_surviving_range":{"type":"number"},"pnl_at_range_bounds_pct":{"type":"object"},"verdict":{"type":"string","enum":["SURVIVES_RANGE","THIN_BUFFER","LIQUIDATION_INSIDE_RANGE","UNKNOWN_RANGE"]},"funding_impact":{"type":"object"},"risk_disclosure":{"type":"object"}}}}}},"400":{"description":"side/leverage invalid or entry unavailable"},"402":{"description":"Payment Required"}}}},"/api/signals":{"get":{"operationId":"getCryptoSignals","tags":["Crypto","Intelligence"],"summary":"Current crypto market-intelligence signals","description":"Canonical Kronos by ForgeMesh endpoint for current BTC, ETH, SOL, XRP, and ADA signal context: per-symbol scores, ranked top_k list, regime, and data freshness. Use it for a quick Bitcoin price-momentum check, an Ethereum market snapshot before running deeper analysis, scanning the top 5 coins for the strongest mover, or feeding a lightweight signal into a trading agent's decision loop. Legacy compatibility path: /api/kronos/signals.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}},{"mpp":{}}],"offers":[{"intent":"charge","method":"evm","amount":"50000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]},"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":{}},{"mpp":{}}],"offers":[{"intent":"charge","method":"evm","amount":"50000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]},"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, returning monitored whale-scale transfers, exchange flows, bridge flows, and stablecoin issuer events by chain and lookback window. Use it to catch a large exchange inflow before it moves price, monitor bridge flows into or out of Base, track stablecoin mint or burn events, or add on-chain flow context to a crypto trading or research agent. Configurable 1-168 hour window across Ethereum, Base, and Arbitrum.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}},{"mpp":{}}],"offers":[{"intent":"charge","method":"evm","amount":"20000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]},"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":"0x1CcEf327b34853f6aC51464eA47fb3c291328D5E","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"}}}}