Introduction
# Trade Signal
Buy/Sell/Hold Trade Signals for AI agents. Transform complex market intelligence into clear, executable Buy/Sell/Hold recommendations on global stocks and other public securities. Trade-signal gives specific price targets on any given securities, real-time data and institution-grade trade thesis. Trade-signal is forward looking but also capable of technical and fundamental analysis on current/historical price actions, with a qualitative and quantitiave explanation as to why a certain securities (stock) price moved the way it did.
## Quick Start
```bash # Get trade signal for a stock ./scripts/search.sh "Should I buy NVDA?"
# Get signal with full analysis ./scripts/search.sh "Is AAPL a sell at current levels?"
# Check multiple tickers ./scripts/search.sh "AAPL NVDA TSLA MSFT"
# Earnings play analysis ./scripts/search.sh "What's the best trade ahead of NVDA's upcoming earnings? Give me specific options strategy with prices." ```
**Base URL:** `https://app.terminal-x.ai/api`
---
## Features
### š Trade Signals Capabilities
| Query Type | Examples | |------------|----------| | **Trade Decisions** | Buy/sell/hold calls, entry/exit timing, position sizing | | **Earnings Plays** | Pre-earnings positioning, post-earnings reactions, historical patterns | | **Price Catalysts** | What's moving the stock, macro events, technical triggers | | **Analyst Actions** | Upgrades, downgrades, price target changes, investment thesis | | **Technical Analysis** | Support/resistance, volatility, momentum indicators | | **Risk Assessment** | Stop loss levels, downside scenarios, risk/reward analysis |
#### Each response includes:
- **Signal**: Clear BUY / SELL / HOLD / AVOID recommendation with time horizon (T+1, T+5, etc.) - **Technicals**: Entry, exit, stop loss, and support/resistance zones - **Answer**: Macro, technical, and sentiment factors driving the trade thesis - **Tickers**: Primary symbol plus related ETFs and correlated instruments - **Sources**: Numbered citations [1], [2], [3] linking to Wall Street research, SEC filings, and market data
### š Market Coverage
**37,565 Global Tickers + 6,104 ETFs** across all major exchanges:
| Region | Tickers | ETFs | |--------|---------|------| | **US** (incl. ADRs) | 7,301 | 4,979 | | **Western Europe** | 11,123 | ā | | **Canada** | 4,690 | ā | | **Japan** | 3,873 | 200 | | **Korea** | 3,856 | 500 | | **Hong Kong** | 2,638 | 176 | | **Shanghai** | 2,315 | ā | | **Taiwan** | 1,072 | 200 | | **Singapore** | 565 | 49 | | **Other** | 132 | ā |
**Asset Classes**: Global Equities, ETFs, Global macro, FX, commodities, crypto content available.
### š¬ Data Sources
- **Wall Street Research** ā Analyst reports, investment thesis from Goldman, Morgan Stanley, JP Morgan, Citi, UBS, Bank of America, Stifel, etc. - **Analyst Actions** ā Upgrades, downgrades, initiations, PT changes - **SEC Filings** ā 10-K, 10-Q, 8-K, insider transactions, 13F holdings, 13D, 13G, DEF14A, and everything filed on EDGAR - **Call Transcripts** ā Live transcripts from earnings calls, M&A calls, management discussions, Conference calls, Investor Day calls, etc. - **Real-Time News** ā Bloomberg, Reuters, CNBC, FT, WSJ - **Company Filings** ā Company Press Release, earnings materials, company presentations, Investor day materials, guidance updates, Company Financials and Supplements
---
## Response Format
Running the script returns JSON:
```json { "query": "Should I buy NVDA before earnings?", "tickers": ["NVDA", "AMD", "GOOGL"], "tradeSignal": "HOLD", "priceTarget": { "entry": null, "exit": "$185-190", "stopLoss": "$175", "timeHorizon": "T+1 to T+3" }, "agentAnswer": "**Hold current position: Sell at $185-190 on any post-earnings bounce within T+1 to T+3.** NVDA closed at $181.36 and trades at $180.88 after hours. Despite consistent earnings beats since August 2024, the stock has exhibited a persistent sell-the-fact pattern, declining in 4 of the last 5 post-earnings sessions. [1] Options markets price a 6.68% implied move ($12.13 swing) for the November 19 after-hours release. [2]", "sources": [ { "refId": 1, "sourceTitle": "Nvidia Earnings Have Become a Consistent Sell-the-Fact Event", "sourceName": ["Bloomberg"], "datePublished": "2024-11-18T14:30:42Z" }, { "refId": 2, "sourceTitle": "NVDA Options Implied Move Analysis", "sourceName": ["Goldman Sachs"], "datePublished": "2024-11-19T09:00:00Z" } ], "technicals": { "rsi": 62.4, "macd": "bullish crossover", "support": "$175", "resistance": "$190", "trend": "neutral" }, "relatedAnalysis": [ "AMD earnings correlation", "Semiconductor sector momentum" ] } ```
| Field | Description | |-------|-------------| | `query` | Your original question | | `tickers` | Relevant stock tickers | | `tradeSignal` | BUY, SELL, or HOLD recommendation | | `priceTarget` | Entry, exit, stop loss, time horizon | | `agentAnswer` | AI analysis with citation references [1], [2] | | `sources` | Citations with title, source name, date | | `technicals` | RSI, MACD, support/resistance, trend | | `relatedAnalysis` | Related research topics |
---
## Sample Output
### Example 1: Catalyst Analysis with Trade Decision **Query:** `./scripts/search.sh "What's driving the fall in silver prices? Identify all the catalysts and make a trade decision for tomorrow."`
``` š **Silver Price Decline: Catalyst Analysis**
**Signal: AVOID** | Time Horizon: T+1 Related: SLV (-28.54%), SI (-0.77%), XAGUSD (+2.58%)
Silver has entered bear market territory after falling nearly 22% from its recent record high, driven by a confluence of macro and technical factors. [1][2]
**Macro Catalysts:** - President Trump's announcement of Kevin Warsh as Fed pick eased concerns about Fed independence, triggering a sharp dollar rally [7][10] - Repricing underway with assumption that smaller Fed balance sheet would tighten financial conditions [8] - Declining capital leakage from China ā more capital returning to China, affecting precious metals where sentiment is currently driving prices [7][9]
**Technical Catalysts:** - Parabolic run with 14% intraday surge showed clear blowoff top pattern [1][9] - One-month volatility surged above 96%, steepest level in nearly 25 years [7][10][12] - Inverted volatility curve signals traders anticipate further unwinding [7][10][12] - CME raised margin requirements to 11% from 9% ā familiar late-cycle signal that speculative excess is being wrung out [5][8][13]
**Valuation:** Current price ($86.62) trades significantly above 200-day MA of $48/oz, indicating deeply overbought conditions. Analysts estimate fair value around $60/oz. JPMorgan's Marko Kolanovic suggests silver should trade at half its current price later in 2026. [14][16][18][20][21][22][23]
**Trade Decision:** Avoid purchasing silver for tomorrow. Market likely to continue unwinding speculative positions. Wait for stabilization at $75-$80 support zone before considering new long positions. [3][11]
**Sources:** [1] Bloomberg News: Silver Bear Market Entry [2] Goldman Sachs Precious Metals Weekly Report [7] Bloomberg Terminal ā Silver Volatility Analysis [10] Reuters ā Fed Policy Impact on Dollar [16] JPMorgan Research Note ā Precious Metals Outlook [21] CME Group ā Margin Requirement Update ```
### Example 2: Price Target with Hold Recommendation
**Query:** `./scripts/search.sh "Give me a clear buy/sell/hold call and an optimal target price for T+5."`
``` š **Silver Trade Signal: 5-Day Outlook**
**Signal: HOLD** | Target Range: $80-$90 | Time Horizon: T+5
Silver has experienced extreme volatility with current price at $86.31, following intraday high of $88.00 and low of $77.00 today. [1]
**Technical Summary:** - 1-Month Volatility: >96% (extreme) - Volatility Curve: Steeply inverted ā traders anticipate further unwinding [5] - Gold/Silver Ratio: Below 50 (stretched outperformance vs gold) [7][17] - Support: $83-$85 (larger retracement) | Resistance: $93.50-$96.00 [9]
**Historical Pattern:** In six prior instances since 1970 where silver doubled in 40 days and rose over 10% in a single day, prices were lower 20 days later. This suggests caution, but immediate sustained crashes are not guaranteed. [16]
**Bullish Factors (Long-term):** - Structural supply deficit from solar, EVs, and data centers [7][3] - Physical demand from China and India remains strong [1][5][8] - Shanghai silver futures trading at premium to global spot [1][5][8]
**Bearish Factors (Short-term):** - CME margin hike to 11% forcing speculative liquidation [10] - Risk-reward completely skewed at current levels [14][11] - "Meme trader" phenomenon contributing to volatility [9]
**Trade Decision:** HOLD for next 5 trading days. Consolidation phase likely after correction from peak near $120.60. Target $80-$90 reflects stabilization period with potential for minor upward corrections within volatile environment.
**Sources:** [1] Silver Spot Market Data ā February 1, 2026 [5] CME Group ā Volatility Curve Analysis [7] Bloomberg ā Gold/Silver Ratio Report [9] Reuters ā Silver Market Dynamics [14] Bank of America ā Precious Metals Valuation [16] Historical Precious Metals Database ā Pattern Analysis
```
### Example 3: Analyst Coverage
**Query:** `./scripts/search.sh "What are analysts saying about NVIDIA?"`
``` š **NVIDIA Analyst Sentiment**
Wall Street remains overwhelmingly bullish on NVIDIA with 45 Buy ratings, 3 Hold, and 0 Sell. Average price target: $950 (18% upside). [1]
**Recent Actions:** - Goldman Sachs: Reiterated Buy, PT $1,000 ā "AI infrastructure spend remains in early innings" [2] - Morgan Stanley: Overweight, PT $950 ā Raised estimates on Blackwell demand visibility [3] - Bank of America: Buy, PT $925 ā "Data center TAM expansion continues to exceed expectations" [1]
Key debate centers on sustainability of 70%+ gross margins as competition from AMD MI300X intensifies in 2025. [3]
**Sources:** [1] Bloomberg Analyst Consensus Data - January 2025 [2] Goldman Sachs NVDA Initiation Report - January 15, 2025 [3] Morgan Stanley Semiconductor Research Note - January 12, 2025 ```
---
## Integration
### With AI Agents
The agent will automatically use this skill when asked: - "Should I buy NVDA?" - "What's your call on AAPL?" - "Sell or hold TSLA?" - "Give me a trade signal for META" - "Is now a good entry for AMD?" - "Analyze GOOGL before earnings" - "What are analysts saying about MSFT?" - "Best tech stocks to buy right now"
### Example Agent Flow
``` 1. User: "How is NVIDIA doing?" 2. Agent: [calls search.sh "NVIDIA financial performance and outlook"] 3. Agent: "NVIDIA reported record Q3 revenue of $35.1B, up 94% YoY. Data center segment drove growth at $30.8B. Analysts maintain Buy ratings with average PT of $950. Key catalyst: Blackwell architecture ramp in Q1 2025." 4. User: "What about their margins?" 5. Agent: [calls search.sh "NVIDIA gross margin and profitability"] 6. Agent: "Gross margin was 75% in Q3, up from 70% YoY. Management expects margins to moderate to 73-74% as Blackwell ramps due to initial yield curves, per CFO commentary on earnings call." ```
### Combining with Other Skills
```bash # Get financial data then execute trade ./scripts/search.sh "AAPL earnings analysis" && trade-signal query "Should I buy AAPL?"
# Research before news check ./scripts/search.sh "Tesla delivery numbers" && finance-news news TSLA ```
---
## Tips for Better Results
| Do This | Not This | |---------|----------| | "NVIDIA data center revenue Q4 2024" | "NVIDIA revenue" | | "AAPL gross margin vs MSFT" | "Apple margins" | | "What did Jensen Huang say about AI demand" | "NVDA CEO comments" | | "Tesla deliveries Q3 2024 vs Q3 2023" | "Tesla cars" |
**Best Practices:** - **Be specific** ā Include timeframes, metrics, and company names - **Use ticker symbols** ā "AAPL" is clearer than "Apple" - **Ask direct questions** ā "What is..." or "How much..." get precise answers - **Include context** ā "last quarter", "FY 2024", "year-over-year"
---
## Error Handling
```json { "code": 400, "message": "Missing or invalid query parameter" } ```
| Error Code | Meaning | Resolution | |------------|---------|------------| | 400 | Missing query | Include `?query=` parameter | | 500 | Server error | Retry request |
---
## Support
- **Homepage:** https://terminal-x.ai - **Email:** [email protected]