cite-agent 0.1.0
Financial Data MCP Server with Citations & Provenance
Requires Python: >=3.10

# Cite-Finance API

**Production-grade financial data API with AI-powered synthesis**

## Overview

Cite-Finance provides SEC EDGAR data, market data, and financial calculations through a clean REST API with built-in AI synthesis capabilities.

## What Makes Cite-Finance Different

### ✅ Zero Hallucination
Pure structured JSON responses - no LLM inference, no made-up numbers.

### ⚡ Lightning Fast
Sub-300ms p95 latency with 99.9% SLA (Pro tier).

### 📊 Consistency Scores
Cross-source validation gives you a 0-1 confidence metric on every response.

### 🔗 SEC Citations
Every data point includes direct links to source filings - perfect for compliance.

### 🤖 LLM-Ready Format
`format=llm` option returns prompt-ready text snippets with metadata.

### 🛡️ Production Grade
Sentry monitoring, Stripe billing, Redis caching, full observability.

## Architecture

```
cite-finance-api/
├── src/
│   ├── api/          # API routes (FastAPI)
│   ├── core/         # Business logic (calculations, metrics)
│   ├── data_sources/ # Plugin-based data source adapters
│   ├── auth/         # API key management
│   ├── billing/      # Stripe integration, usage tracking
│   ├── middleware/   # Rate limiting, auth
│   ├── models/       # Pydantic models
│   └── utils/        # Shared utilities
├── tests/            # Test suite
├── docs/             # API documentation
└── config/           # Configuration files
```

## Quick Start

### Installation
```bash
pip install -r requirements.txt
```

### Configuration
```bash
cp .env.example .env
# Edit .env with your API keys
```

### Run
```bash
uvicorn src.main:app --reload
```

### API Documentation
Once running, visit: http://localhost:8000/docs

## Pricing

| Tier | Price | Calls/Month | Key Features |
|------|-------|-------------|--------------|
| **Free** | $0 | 50 | Basic metrics, testing |
| **Starter** | $49 | 2,000 | **LLM answers**, citations, consistency |
| **Professional** | $199 | 10,000 | All features, **99.9% SLA** |
| **Enterprise** | $999 | Unlimited | Custom metrics, dedicated support |

## Quick Start

### 1. Get Your API Key

```bash
curl -X POST https://api.cite-finance.io/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@company.com"}'
```

### 2. Make Your First Request

```bash
curl -H "X-API-Key: your_key" \
  "https://api.cite-finance.io/api/v1/answers?ticker=AAPL&metric=revenue_ttm&format=json"
```

### 3. Get Structured, Cited Data

```json
{
  "ticker": "AAPL",
  "metric": "revenue_ttm",
  "value": 383285000000,
  "unit": "USD",
  "period": "TTM",
  "as_of": "2024-09-30",
  "sources": [
    {
      "type": "sec_filing",
      "filing": "10-K",
      "url": "https://www.sec.gov/...",
      "excerpt": "Total net sales: $383,285 million"
    }
  ],
  "consistency_score": 0.96,
  "retrieved_at": "2025-11-24T12:00:00Z"
}
```

**Key Benefits:**
- ✅ Structured JSON (no hallucination)
- ✅ SEC citations with URLs
- ✅ 96% consistency score
- ✅ Sub-300ms response time

## Use Cases

- **AI Chatbots**: Financial Q&A with verified sources
- **Trading Bots**: High-confidence data for algorithmic trading
- **Dashboards**: Real-time financial metrics with citations
- **Research Tools**: Compliance-ready data with SEC links

## Documentation

- [API Docs](https://api.cite-finance.io/docs)
- [Monetization Guide](./MONETIZATION_GUIDE.md)
- [Deployment Guide](./DEPLOYMENT_CHECKLIST.md)
- [Integration Examples](./MONETIZATION_GUIDE.md#integration-examples)

## Built For

LLM-first financial applications that need:
- Structured data (no hallucination)
- Verified sources (SEC citations)
- High confidence (consistency scores)
- Production speed (<300ms)

---

**Ready to launch?** See [DEPLOYMENT_CHECKLIST.md](./DEPLOYMENT_CHECKLIST.md)

## License

Proprietary - All Rights Reserved