# FLOWPRINT & NINJATRADER 8 HISTORICAL ORDER FLOW DATABASE
**Ruta de acceso:** `I:\flowprint_contracts\`
**Volumen total:** 183.54 GB | 655 archivos de contratos trimestrales
**Formato:** Tick-by-Tick Microstructure Level 1 (24 horas continuo)

---

## 1. Estructura de Carpetas

```text
I:\flowprint_contracts\
├── ES\   (100 contratos | 2000 - 2026 | Tick: 0.25  | S&P 500 E-mini)
├── NQ\   ( 47 contratos | 2014 - 2026 | Tick: 0.25  | Nasdaq 100 E-mini)
├── GC\   ( 80 contratos | 2007 - 2026 | Tick: 0.10  | Oro Futures)
├── CL\   ( 56 contratos | 2013 - 2026 | Tick: 0.01  | Petróleo Crudo WTI)
├── YM\   ( 56 contratos | 2013 - 2026 | Tick: 1.00  | Dow Jones 30 E-mini)
├── NG\   ( 56 contratos | 2013 - 2026 | Tick: 0.001 | Gas Natural)
├── 6E\   ( 60 contratos | 2012 - 2026 | Tick: 0.00005 | Euro FX)
├── 6B\   ( 60 contratos | 2012 - 2026 | Tick: 0.00010 | Libra Británica FX)
├── 6J\   ( 60 contratos | 2012 - 2026 | Tick: 0.00500 | Yen Japonés FX)
└── 6A\   ( 80 contratos | 2007 - 2026 | Tick: 0.00010 | Dólar Australiano FX)
```

---

## 2. Nomenclatura de Archivos

Cada archivo representa un vencimiento trimestral oficial de futuros:
`[SIMBOLO][MES][AÑO].txt`
* **H**: Marzo (Q1)
* **M**: Junio (Q2)
* **U**: Septiembre (Q3)
* **Z**: Diciembre (Q4)

*Ejemplos:*
* `I:\flowprint_contracts\ES\ESH24.txt` -> Contrato E-mini S&P 500 Marzo 2024
* `I:\flowprint_contracts\NQ\NQU24.txt` -> Contrato E-mini Nasdaq Septiembre 2024
* `I:\flowprint_contracts\GC\GCZ25.txt` -> Contrato Oro Diciembre 2025

---

## 3. Especificación del Formato de Datos (Línea por Línea)

Delimitador: Punto y coma (`;`)
Sintaxis:
`timestamp;price;volume;bid;ask;aggressor`

### Definición de Campos:
1. **timestamp** (`yyyyMMdd HHmmss ffffff`): Fecha, hora y microsegundos (UTC, 24 horas sin gaps).
2. **price** (`float`): Precio real de ejecución de la transacción, redondeado al paso mínimo del tick.
3. **volume** (`int`): Volumen negociado en contratos (entero positivo >= 1).
4. **bid** (`float`): Mejor precio de compra (Best Bid) vigente en el momento del trade.
5. **ask** (`float`): Mejor precio de venta (Best Ask) vigente en el momento del trade.
6. **aggressor** (`str`): Iniciador de la agresión institucional:
   * `Ask`: Orden de compra a mercado atacando el Ask (Presión Compradora).
   * `Bid`: Orden de venta a mercado atacando el Bid (Presión Vendedora).

### Ejemplo Real:
```text
20261117 164315 236000;7317.00;2;7316.66;7317.18;Ask
20261117 164315 887000;7316.75;2;7316.53;7317.06;Bid
20261117 164316 188000;7317.00;2;7316.78;7317.30;Bid
```

---

## 4. Guía de Lectura Rápida en Python para IA / Scripts

```python
import polars as pl # o pandas

def load_contract(file_path):
    schema = {
        "timestamp": pl.Utf8,
        "price": pl.Float64,
        "volume": pl.Int64,
        "bid": pl.Float64,
        "ask": pl.Float64,
        "aggressor": pl.Categorical
    }
    df = pl.read_csv(
        file_path,
        separator=";",
        has_header=False,
        new_columns=["timestamp", "price", "volume", "bid", "ask", "aggressor"],
        schema=schema
    )
    # Parsear timestamp a datetime con microsegundos
    df = df.with_columns(
        pl.col("timestamp").str.strptime(pl.Datetime(time_unit="us"), format="%Y%m%d %H%M%S %f")
    )
    return df

# Ejemplo de uso:
# df = load_contract(r"I:\flowprint_contracts\ES\ESZ26.txt")
```

---

## 5. Capacidades para Backtesting y Análisis
* **Footprint / Order Flow Clusters:** Matriz diagonal Bid x Ask construible directamente con `price`, `volume`, `bid`, `ask` y `aggressor`.
* **Delta / Cumulative Volume Delta (CVD):** `Delta = Sum(Vol[Ask]) - Sum(Vol[Bid])`.
* **Volume Profile (VPOC / VAH / VAL):** Distribución de volumen exacto por nivel de tick.
* **Order Flow Imbalances:** Detección de desequilibrios diagonales de 300% / 400%.
* **Velocidad de Cinta:** Análisis de microsegundos para detección de absorciones e icebergs.
