# QuantGist Platform

> The Intelligence Layer Between News and Execution

QuantGist is a structured intelligence platform built around how traders and systems actually consume market information. It is not a news feed — it is a pipeline that ingests, normalises, enriches, and delivers market-moving event data in a consistent, machine-readable schema.

## Overview

- **Ingests**: Licensed news feeds, economic release schedules, earnings calendars, and macro data providers.
- **Normalises**: Every source mapped to a single unified event schema — no custom parsing on your end.
- **Enriches**: Symbol tags, sector mappings, sentiment scores, impact classifications, and surprise deltas.
- **Delivers**: REST API for pull, webhooks for push, and WebSocket streams for continuous consumption.

## Architecture

```
Sources         News • Economic • Earnings
     ↓
Ingestion       Real-time polling + webhooks
     ↓
Normalization   Unified event schema
     ↓
Intelligence    Scoring • Tagging • Enrichment
     ↓
Delivery        REST • Webhooks • Streams
```

## Four Capability Pillars

### 1. News Intelligence
Real-time headlines scored, deduplicated, and enriched before they reach you.

- Real-time news ingestion from licensed sources
- Source reliability scoring on every event
- Breaking event detection and prioritization
- Deduplication across overlapping feeds

### 2. Economic Calendar
Every macro release structured with forecast, actual, previous, and surprise score.

- CPI, NFP, FOMC, GDP, PMI coverage
- Forecast vs actual vs previous schema
- Surprise score calculation per release
- Pre/post-market timing labels

### 3. Event Intelligence
Automatic enrichment maps every event to the assets and sectors it moves.

- Automatic ticker and symbol tagging
- Sector and asset class mapping
- Market impact scoring (low / medium / high)
- Watchlist relevance matching

### 4. Delivery Infrastructure
Your choice of delivery method — built for systems that cannot afford to miss an event.

- REST API with consistent schema
- Webhook push on every matching event
- WebSocket streaming (coming soon)
- Discord and Telegram integrations (coming soon)

## Data Flow

1. **Ingest** — Licensed news feeds, partner data sources, and scheduled economic release endpoints are continuously polled and consumed.
2. **Normalize** — Every event is mapped to a single schema: event_id, symbols, sentiment, impact, category, timestamps, and source metadata.
3. **Enrich** — Surprise scores are calculated, tradeability assessed, entities linked, and near-duplicate events collapsed before delivery.
4. **Deliver** — Choose your integration: pull via REST, receive pushes via webhook, subscribe to a stream — or all three simultaneously.

## QuantGist vs Most News APIs

| Dimension | Most News APIs | QuantGist |
|-----------|---------------|-----------|
| Schema design | Generic headlines in raw text format | Trader-native schema with symbols, sentiment, and impact |
| Data scope | Separate calendar and news tools to manage | Unified platform: news, calendar, events, sentiment |
| Delivery format | JSON dump requiring your own enrichment pipeline | Enriched intelligence with context, ready for automation |

## Roadmap

**Available now**: Economic Calendar API, Macro Events API, REST endpoints, Webhook delivery, News API, Earnings API, Markets Overview, AI Indicators.

**Coming soon**: WebSocket streaming, Discord bot integration, Telegram bot integration.

**Planned**: Surprise scoring engine improvements, Watchlist relevance AI, SDK libraries (Python, JS), Bulk CSV export.

## Links

- Platform overview: https://quantgist.com/platform
- API documentation: https://quantgist.com/docs
- Sign up free: https://quantgist.com/signup
- Pricing: https://quantgist.com/pricing