# Financial Context - AI Agent Financial Data API

A comprehensive financial data API service designed for AI agents and developers, providing real-time market data, financial statements, company information, and social media intelligence.

## Docs

### API Reference

#### Company Information
- `GET /company/{symbol}/profile` - Get company profile and corporate data
- `GET /company/{symbol}/insider-trades` - Get insider trading activities
- `GET /company/{symbol}/shareholders` - Get major shareholders information

#### Financial Data
- `GET /financials/{symbol}` - Get financial statements and metrics
- `GET /earnings/{symbol}` - Get earnings reports and estimates

#### Market Intelligence
- `GET /news/{symbol}` - Get financial news and market updates
- `GET /timeline/{symbol}` - Get corporate events and timeline
- `GET /bulls-vs-bears-summary/{symbol}` - Get market sentiment analysis
- `GET /forecast/{symbol}` - Get price forecasts and predictions

#### Technical Analysis
- `GET /technicals/rating` - Get multi-timeframe technical analysis
- `GET /technicals/{symbol}/{timeframe}` - Get single timeframe technical data
- `GET /technicals/timeframes` - Get supported timeframes

#### Market Data
- `GET /historical/{symbol}` - Get historical price and volume data
- `GET /quote/{symbol}` - Get real-time and delayed quotes
- `GET /quote-combine` - Get multiple stock quotes
- `GET /screener` - Screen stocks by criteria
- `GET /chart/{symbol}` - Get chart data and technical indicators

#### Usage & Analytics
- `GET /usage-stats` - Get API usage statistics

### Authentication
- **API Key**: Use `X-API-Key` header for authentication
- **Security**: All endpoints require valid API key
- **Rate Limiting**: Per-key rate limits apply
- **Usage Tracking**: Detailed analytics and monitoring

### Response Format
All API responses follow a consistent structure:
```json
{
  "success": true,
  "data": { ... },
  "timestamp": "2024-01-01T00:00:00Z",
  "requestId": "unique-request-id"
}
```

### Error Handling
Error responses include:
- `success`: false
- `error`: Human-readable error message
- `code`: Machine-readable error code
- `timestamp`: ISO 8601 timestamp
- `requestId`: Unique request identifier

### Supported Markets
- **US Markets**: NASDAQ, NYSE, AMEX
- **Symbol Formats**: AAPL, NASDAQ:AAPL
- **Data Coverage**: Real-time and historical data

### Key Features
- **Real-time Quotes**: Live market data with minimal latency
- **Financial Analysis**: Comprehensive financial statements and ratios
- **Technical Indicators**: Multi-timeframe technical analysis
- **Market Sentiment**: Bulls vs Bears analysis and news sentiment
- **Institutional Data**: Insider trades, forecasts, and shareholder information
- **Historical Data**: Complete price history and volume data

## Optional Resources

- GitHub Repository: `https://github.com/your-org/xstock-data`
- Live Demo: `https://financialcontext.com`
- API Documentation: `https://api.fcontext.com/docs`
- Support: `support@financialcontext.com`