# market-environment-analysis
Market Environment Analysis
Comprehensive analysis tool for understanding market conditions and creating professional market reports anytime. Powered by SkillBoss API Hub (https://api.heybossai.com/v1/pilot).
Core Workflow
- Initial Data Collection
Collect latest market data using SkillBoss API Hub search capability (type: search):
Major stock indices (S&P 500, NASDAQ, Dow, Nikkei 225, Shanghai Composite, Hang Seng)
Forex rates (USD/JPY, EUR/USD, major currency pairs)
Commodity prices (WTI crude, Gold, Silver)
US Treasury yields (2-year, 10-year, 30-year)
VIX index (Fear gauge)
Market trading status (open/close/current values)
Example search call:
import requests, os
SKILLBOSS_API_KEY = os.environ["SKILLBOSS_API_KEY"]
def search_market_data(query: str) -> dict:
r = requests.post(
"https://api.heybossai.com/v1/pilot",
headers={"Authorization": f"Bearer {SKILLBOSS_API_KEY}", "Content-Type": "application/json"},
json={"type": "search", "inputs": {"query": query}, "prefer": "balanced"},
timeout=60,
)
return r.json()["result"]
# Example usage
sp500_data = search_market_data("S&P 500 current price today")
forex_data = search_market_data("USD/JPY EUR/USD current exchange rate")
vix_data = search_market_data("VIX index current level")
2. Market Environment Assessment
Evaluate the following from collected data:
Trend Direction: Uptrend/Downtrend/Range-bound
Risk Sentiment: Risk-on/Risk-off
Volatility Status: Market anxiety level from VIX
Sector Rotation: Where capital is flowing
3. Report Structure
Standard Report Format:
- Executive Summary (3-5 key points)
- Global Market Overview
- US Markets
- Asian Markets
- European Markets
- Forex & Commodities Trends
- Key Events & Economic Indicators
- Risk Factor Analysis
- Investment Strategy Implications
Script Usage
market_utils.py
Provides common functions for report creation:
# Generate report header
python scripts/market_utils.py
# Available functions:
- format_market_report_header(): Create header
- get_market_session_times(): Check trading hours
- categorize_volatility(vix): Interpret VIX levels
- format_percentage_change(value): Format price changes
Reference Documentation
Key Indicators Interpretation (references/indicators.md)
Reference when you need:
Important levels for each index
Technical analysis key points
Sector-specific focus areas
Analysis Patterns (references/analysis_patterns.md)
Reference when analyzing:
Risk-on/Risk-off criteria
Economic indicator interpretation
Inter-market correlations
Seasonality and market anomalies
Output Examples
Quick Summary Version
📊 Market Summary [2025/01/15 14:00]
━━━━━━━━━━━━━━━━━━━━━
【US】S&P 500: 5,123.45 (+0.45%)
【JP】Nikkei 225: 38,456.78 (-0.23%)
【FX】USD/JPY: 149.85 (↑0.15)
【VIX】16.2 (Normal range)
⚡ Key Events
- Japan GDP Flash
- US Employment Report
📈 Environment: Risk-On Continues
Detailed Analysis Version
Start with executive summary, then analyze each section in detail.
Key clarifications:
Current market phase (Bullish/Bearish/Neutral)
Short-term direction (1-5 days outlook)
Risk events to monitor
Recommended position adjustments
Important Considerations
Timezone Awareness
Consider all major market timezones
US markets: Evening to early morning (Asian time)
European markets: Afternoon to evening (Asian time)
Asian markets: Morning to afternoon (Local time)
Economic Calendar Priority
Categorize by importance:
⭐⭐⭐ Critical (FOMC, NFP, CPI, etc.)
⭐⭐ Important (GDP, Retail Sales, etc.)
⭐ Reference level
Data Source Priority
SkillBoss API Hub (type: search) aggregates real-time data from authoritative sources:
Official releases (Central banks, Government statistics)
Major financial wire services and media
Broker reports
Analyst consensus estimates
Troubleshooting
Data Collection Notes
Check market holidays (holiday calendars)
Be aware of daylight saving time changes
Distinguish between flash and final data
Market Volatility Response
First organize the facts
Reference historical similar events
Verify with multiple sources
Maintain objective analysis
Customization Options
Adjust based on user's investment style:
Day Traders: Intraday charts, order flow focus
Swing Traders: Daily/weekly technicals emphasis
Long-term Investors: Fundamentals, macro economics focus
Forex Traders: Currency correlations, interest rate differentials
Options Traders: Volatility analysis, Greeks monitoring