{"uid":"cap_KccK7HeOWN8ULfI-AaP6p","slug":"tradeos-tech-c5ae032d","name":"TradeOS Signal Decision Context","description":"Plain-English reasoning for agents and dashboards that need to understand why a signal passed, abstained, or was vetoed. The response explains reliability drivers, disagreement, forecast alignment, risk flags, and safe next checks. Designed for validation workflows that need reasoning, not a bare score or trade instruction.","url":"https://tradeos.tech/x402/v1/intelligence/tradeos-signal-decision-context","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{"output":{"type":"string"},"symbol":{"type":"string"},"chain_id":{"type":"string"},"metadata":{"type":"object"},"contract_address":{"type":"string"}},"additionalProperties":true},"type":{"type":"string","const":"http"},"method":{"type":"string","const":"POST"},"bodyType":{"type":"string","const":"json"}}},"output":{"type":"object"}}},"responseSchema":{"type":"object","required":["details","drivers","notices","service","subject","verdict","evidence","confidence","created_at","request_id","risk_flags","next_checks","missing_data","request_type","response_mode","data_freshness","negative_drivers","positive_drivers","refusal_category"],"properties":{"details":{"type":"object","required":["view","items","source","filters","summary","human_summary","recommended_only"],"properties":{"view":{"type":"string"},"items":{"type":"array","items":{"type":"object","required":["regime","symbol","rr_score","win_rate","signal_id","signal_ts","signal_type","snapshot_id","bias_aligned","signal_score","timing_score","gate_decision","abstain_reason","accuracy_score","decision_state","freshness_decay","matched_horizon","signal_timeframe","direction_context","fusion_confidence","disagreement_index","win_rate_observations"],"properties":{"regime":{"type":"string"},"symbol":{"type":"string"},"rr_score":{"type":"number"},"win_rate":{"type":"number"},"signal_id":{"type":"string"},"signal_ts":{"type":"string"},"signal_type":{"type":"string"},"snapshot_id":{"type":"string"},"bias_aligned":{"type":"boolean"},"signal_score":{"type":"number"},"timing_score":{"type":"number"},"gate_decision":{"type":"string"},"abstain_reason":{"type":"string"},"accuracy_score":{"type":"number"},"decision_state":{"type":"string"},"freshness_decay":{"type":"number"},"matched_horizon":{"type":"string"},"signal_timeframe":{"type":"string"},"direction_context":{"type":"string"},"fusion_confidence":{"type":"number"},"disagreement_index":{"type":"number"},"win_rate_observations":{"type":"number"}}}},"source":{"type":"string"},"filters":{"type":"null"},"summary":{"type":"object","required":["count","symbols","veto_count","abstain_count","avg_signal_score","passed_filter_count","avg_disagreement_index"],"properties":{"count":{"type":"number"},"symbols":{"type":"array","items":{"type":"string"}},"veto_count":{"type":"number"},"abstain_count":{"type":"number"},"avg_signal_score":{"type":"number"},"passed_filter_count":{"type":"number"},"avg_disagreement_index":{"type":"number"}}},"human_summary":{"type":"object","required":["headline","data_gaps","builder_use","score_notes","verdict_label","decision_cards","thesis_tracking","product_primitive","what_needs_review","what_is_constructive","selected_route_reason","plain_language_summary"],"properties":{"headline":{"type":"string"},"data_gaps":{"type":"array","items":{"type":"unknown"}},"builder_use":{"type":"string"},"score_notes":{"type":"array","items":{"type":"string"}},"verdict_label":{"type":"string"},"decision_cards":{"type":"array","items":{"type":"object","required":["signal","disagreement","signal_score","decision_state","reliability_drivers","pause_or_block_reasons"],"properties":{"signal":{"type":"string"},"disagreement":{"type":"string"},"signal_score":{"type":"string"},"decision_state":{"type":"string"},"reliability_drivers":{"type":"array","items":{"type":"string"}},"pause_or_block_reasons":{"type":"array","items":{"type":"string"}}}}},"thesis_tracking":{"type":"object","required":["recheck_cadence","continuous_use_note"],"properties":{"recheck_cadence":{"type":"string"},"continuous_use_note":{"type":"string"}}},"product_primitive":{"type":"string"},"what_needs_review":{"type":"array","items":{"type":"string"}},"what_is_constructive":{"type":"array","items":{"type":"string"}},"selected_route_reason":{"type":"string"},"plain_language_summary":{"type":"string"}}},"recommended_only":{"type":"boolean"}}},"drivers":{"type":"array","items":{"type":"object","required":["detail","impact"],"properties":{"detail":{"type":"string"},"impact":{"type":"string"}}}},"notices":{"type":"array","items":{"type":"string"}},"service":{"type":"string"},"subject":{"type":"object","required":["limit","symbol","horizon","chain_id","metadata","timeframe","contract_address"],"properties":{"limit":{"type":"null"},"symbol":{"type":"string"},"horizon":{"type":"null"},"chain_id":{"type":"string"},"metadata":{"type":"object","required":["signal_id","timestamp","marketplace","x402_provider","x402_channel_id","requested_service","x402_resource_type"],"properties":{"signal_id":{"type":"string"},"timestamp":{"type":"string"},"marketplace":{"type":"string"},"x402_provider":{"type":"string"},"x402_channel_id":{"type":"string"},"requested_service":{"type":"string"},"x402_resource_type":{"type":"string"}}},"timeframe":{"type":"null"},"contract_address":{"type":"string"}}},"verdict":{"type":"string"},"evidence":{"type":"array","items":{"type":"object","required":["as_of","detail","impact","source","severity","reference"],"properties":{"as_of":{"type":"string"},"detail":{"type":"string"},"impact":{"type":"string"},"source":{"type":"string"},"severity":{"type":"null"},"reference":{"type":"null"}}}},"confidence":{"type":"number"},"created_at":{"type":"string"},"request_id":{"type":"string"},"risk_flags":{"type":"array","items":{"type":"string"}},"next_checks":{"type":"array","items":{"type":"string"}},"missing_data":{"type":"array","items":{"type":"unknown"}},"request_type":{"type":"string"},"response_mode":{"type":"string"},"data_freshness":{"type":"object","required":["as_of","source","by_source","freshness_known"],"properties":{"as_of":{"type":"string"},"source":{"type":"string"},"by_source":{"type":"object","required":[],"properties":{}},"freshness_known":{"type":"boolean"}}},"negative_drivers":{"type":"array","items":{"type":"string"}},"positive_drivers":{"type":"array","items":{"type":"string"}},"refusal_category":{"type":"null"}}},"example":{"request":{"input":{"body":{"output":"brief_markdown","symbol":"BTC","chain_id":"1","metadata":{"signal_id":"test_signal_001","timestamp":"2024-01-15T10:30:00Z"},"contract_address":"0x0000000000000000000000000000000000000000"},"type":"http","method":"POST","bodyType":"json"}},"response":{"details":{"view":"latest","items":[{"regime":"trend","symbol":"BTCUSDT","rr_score":0,"win_rate":0.4969,"signal_id":"sig_72dba51b1b72f08d","signal_ts":"2026-06-18T04:58:28.911073+00:00","signal_type":"supertrend_swing","snapshot_id":"sf-1.0.0-86db82ca-8e538ba5","bias_aligned":true,"signal_score":0.3651,"timing_score":0.4969,"gate_decision":"ABSTAIN","abstain_reason":"disagreement_index 0.780 > 0.650","accuracy_score":0.3836,"decision_state":"abstain","freshness_decay":1,"matched_horizon":"d7","signal_timeframe":"7d","direction_context":"long_context","fusion_confidence":0.1164,"disagreement_index":0.78,"win_rate_observations":15}],"source":"all","filters":null,"summary":{"count":1,"symbols":["BTCUSDT"],"veto_count":0,"abstain_count":1,"avg_signal_score":0.3651,"passed_filter_count":0,"avg_disagreement_index":0.78},"human_summary":{"headline":"Signal context with paused rows across 1 decision row(s).","data_gaps":[],"builder_use":"Use as a dashboard or validation input for signal state; downstream execution and copy-trading decisions are outside the public service boundary.","score_notes":["Average signal score: 0.37.","Average disagreement: 0.78."],"verdict_label":"Signal context with paused rows","decision_cards":[{"signal":"BTCUSDT / supertrend_swing / sig_72dba51b1b72f08d","disagreement":"0.78","signal_score":"0.37","decision_state":"Paused for review","reliability_drivers":["win rate 50%","15 win-rate observations","bias aligned: True","freshness decay 1.00"],"pause_or_block_reasons":["disagreement_index 0.780 > 0.650"]}],"thesis_tracking":{"recheck_cadence":"Recheck before a dashboard or agent treats a signal as usable context.","continuous_use_note":"Signal decisions can move from passed to paused or blocked as evidence refreshes."},"product_primitive":"Signal decision context","what_needs_review":["One or more rows are paused for review.","Average signal disagreement is high.","No rows passed the signal filter.","1 row(s) are paused for review.","Representative pause reason: disagreement_index 0.780 > 0.650."],"what_is_constructive":["1 signal context row(s) are available.","0 row(s) passed the signal filter.","Average signal score is 0.37."],"selected_route_reason":"Selected because the request resolved to signal decision context: passed, paused, blocked, and disagreement state.","plain_language_summary":"Signal decision context returned 1 row(s): 0 passed, 1 paused, and 0 blocked."},"recommended_only":false},"drivers":[{"detail":"1 signal context row(s) are available.","impact":"positive"},{"detail":"0 row(s) passed the signal filter.","impact":"positive"},{"detail":"Average signal score is 0.37.","impact":"positive"},{"detail":"1 row(s) are paused for review.","impact":"negative"},{"detail":"Representative pause reason: disagreement_index 0.780 > 0.650.","impact":"negative"}],"notices":["Research output only. Not investment advice. No execution. No custody.","Signal decision context explains TradeOS signal state; it is not a buy/sell/copy-trade instruction."],"service":"tradeos-crypto-intelligence-agent","subject":{"limit":null,"symbol":"BTC","horizon":null,"chain_id":"1","metadata":{"signal_id":"test_signal_001","timestamp":"2024-01-15T10:30:00Z","marketplace":"generic_x402","x402_provider":"x402","x402_channel_id":"x402-direct","requested_service":"tradeos-signal-decision-context","x402_resource_type":"intelligence_report"},"timeframe":null,"contract_address":"0x0000000000000000000000000000000000000000"},"verdict":"signal_context_abstain","evidence":[{"as_of":"2026-06-18T04:58:28.911073+00:00","detail":"Signal source returned 1 decision-context row(s).","impact":"neutral","source":"tradeos-signal-state","severity":null,"reference":null}],"confidence":0.3651,"created_at":"2026-06-18T05:12:30.780417Z","request_id":"986cb81f-2cec-4c76-bdfa-c5cf867c7a5f","risk_flags":["fusion_abstain_rows_present","high_average_signal_disagreement","no_rows_passed_fusion_filter"],"next_checks":["Inspect paused, blocked, and disagreement reasons before treating a signal as usable context.","Combine signal decision context with token risk, market pulse, order-flow stress, and forecast follow-up.","Use this as a builder input only; TradeOS does not issue copy-trade or execution instructions."],"missing_data":[],"request_type":"signal_intelligence","response_mode":"brief_markdown","data_freshness":{"as_of":"2026-06-18T04:58:28.911073+00:00","source":"tradeos-signal-state","by_source":{},"freshness_known":true},"negative_drivers":["1 row(s) are paused for review.","Representative pause reason: disagreement_index 0.780 > 0.650."],"positive_drivers":["1 signal context row(s) are available.","0 row(s) passed the signal filter.","Average signal score is 0.37."],"refusal_category":null}},"exampleRequest":{"output":"brief_markdown","symbol":"BTC","chain_id":"1","metadata":{"signal_id":"test_signal_001","timestamp":"2024-01-15T10:30:00Z"},"contract_address":"0x0000000000000000000000000000000000000000"},"tags":["x402"],"displayCostAmount":"0.65","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.65/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.65","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.65","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lQ4Loq9P-A0ZRCKfAIqjV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.65","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns plain-English reasoning explaining why a crypto trading signal passed, abstained, or was vetoed, including reliability drivers, disagreement, forecast alignment, and risk flags.","exampleAgentPrompt":"Can you explain in plain English why the BTC signal just abstained — I need to know the reliability drivers, any disagreement between indicators, how it aligns with the current forecast, and what I should check next before acting on it?","exampleUseCases":null,"resultDescription":"A structured JSON response containing plain-English narrative explaining the signal decision (pass, abstain, or veto), the specific reliability drivers that influenced the outcome, any disagreement between contributing signals or models, how the decision aligns with the current forecast, identified risk flags, and suggested safe next validation steps. Designed for dashboard display or agent reasoning chains.","failureModes":["Signal ID or token not found — returns 404 or empty result","Stale market data causing incomplete context — response may include freshness warnings","Invalid or malformed request body — returns 400 validation error","Payment failure via x402 protocol — returns 402 Payment Required","Upstream data provider outage — returns 503 or degraded response with partial context"],"whenToPreferThis":"Choose this endpoint when an agent or dashboard needs human-readable reasoning behind a signal outcome rather than a raw score or binary decision. Ideal for validation workflows, analyst review interfaces, or autonomous agents that must justify actions before execution. Prefer over bare signal endpoints when explainability, auditability, or downstream decision support is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:39:42.963Z","isFirstParty":false}