get_signals
Purpose: Query research signals with dynamic filters (symbol / interval / action / score / confidence).
Triggers (casual questions too): "should I buy / sell X?", "살까 말까?", "good entry?",
"what's the signal for BTC / AAPL / 삼성전자?", "is X bullish or bearish?",
"any buy signals right now?". Returns a research signal + score (NOT an order or advice —
always surface the disclaimer). Pair with get_latest_decisions to show what the system did.
When to call: drilling into a specific signal slice; symbol-by-symbol scanning;
any "should I trade X?" question about a live symbol.
Prerequisites: market://{market_id}/signals/summary recommended for global view.
Next steps: get_signal_detail, get_role_analysis.
Caveats: When symbol/coin is omitted, the whole market is scanned in one
consolidated query (2 newest rows per symbol, newest-first scan cap per interval).
Args: market_id: Market ID (crypto, kr_stock, us_stock; aliases coin/kr/us accepted) symbol: Asset identifier to query (preferred; optional — targets a specific symbol DB) coin: Legacy alias of symbol (kept for backward compatibility) interval: Timeframe filter (15m, 30m, 240m, 1d, combined) action_filter: Action filter (buy, sell, hold) min_score: Minimum signal score threshold min_confidence: Minimum confidence threshold limit: Max results (default 500) hours_back: Only signals within last N hours (default 24)
Disclaimer: Information only, not investment advice. Signals are research output, not orders.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coin | No | ||
| limit | No | ||
| symbol | No | ||
| interval | No | ||
| market_id | Yes | ||
| min_score | No | ||
| hours_back | No | ||
| action_filter | No | ||
| min_confidence | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Set true on error responses | |
| action | No | Recommended client action (error path) | |
| reason | No | Human-readable cause (error path) | |
| full_data | No | ||
| retryable | No | Whether the client should retry (error path) | |
| timestamp | Yes | RFC3339 UTC, server build time | |
| ai_summary | No | One-line AI-oriented summary (success path) | |
| disclaimer | Yes | Canonical compliance disclaimer (always present) | |
| error_code | No | Stable error identifier; see mcp_error_policy.md | |
| request_id | Yes | 32-hex per-response correlation id | |
| _llm_summary | No | ||
| action_value | No | ||
| _next_actions | No | ||
| fallback_note | No | ||
| fallback_tool | No | Suggested fallback (error path) | |
| is_real_money | No | ||
| _value_signals | No | ||
| summary_for_user | No | One-line jargon-free Korean summary (success path) | |
| data_classification | No | ||
| is_investment_advice | No | ||
| ai_summary_ttl_seconds | No | ||
| _market_state_narrative | No | ||
| ai_summary_generated_at | No | RFC3339 UTC | |
| _followup_questions_for_user | No |