# QuantLive Skills

QuantLive skills pack : outils opérationnels pour le trading micro-trademax, les bots M9M, le flip protectif, et les backtests.

## Contenu

- `quantlive_skills/skills/`
  - `trading_ops.py` : signal, audit_position, run_backtest, reconcile_csv
  - `m9m_ops.py` : host d'ops M9M (bridges, logs, gardien, swarm)
  - `flip_protective.py` : mécanisme flip -150 pts, règle de clôture, règle de sortie
  - `backtest.py` : objectifs de backtest + interprétation

## Installation

### Via pip (recommandé pour usage en dev / serveur)

```bash
pip install quantlive-skills
```

Pour l'usage dans un projet local :

```bash
uv pip install -e ".[dev]"
```

### Via npm (optionnel, pour les agents JS/TS)

Un package npm peut être généré à partir du même contenu partagé. Voir le répertoire `npm/` quand il est disponible.

## Utilisation

### MCP tools

Les outils ci-dessous sont exposés par le serveur QuantLive MCP (`quantlive_mcp.server`).

| Tool | Description | Prix (USDC) | Max |
|------|-------------|-------------|-----|
| `reconcile_csv` | Réconciliation broker vs ledger (CSV base64) | 0.10 | 1.00 |
| `get_signal` | Signal XAUUSD micro-trademax actuel | 0.05 | 0.50 |
| `run_backtest` | Backtest walk-forward avec flip protectif | 0.50 | 5.00 |
| `audit_position` | Audit d'une position ouverte (flip, BE, trailing) | 0.02 | 0.20 |

Exemple d'appel via curl (MCP HTTP) :

```bash
curl -s -X POST https://quantlive-mcp.fly.dev/mcp/tools/reconcile_csv \
  -H "Content-Type: application/json" \
  -d '{
    "broker_csv": "***",
    "ledger_csv": "***",
    "tolerance_bps": 50
  }' | jq .
```

Pour un appel payant, ajoutez l'en tête `x-payment` avec les infos x402 (voir `quantlive_mcp/middleware/x402.py` et la route du serveur).

### n8n

Utilisez le nœud HTTP Request pour appeler chaque tool MCP.

Exemple minimal :

- URL : `https://quantlive-mcp.fly.dev/mcp/tools/get_signal`
- Méthode : POST
- En tête : `Content-Type: application/json`
- Body : `{}`
- Réponse JSON → expose dans n8n `{{ $json.signal }}`

Pour les appels payants, ajoutez l'en tête `x-payment` et le paramètre `max_amount`.

### OpenClaw

Les skills sont chargées par OpenClaw via le paquet `quantlive_skills`.

Pour utiliser dans un agent OpenClaw :

- Installer le paquet dans l'environnement Python ou dans le `uv sync` du serveur MCP
- Appeler les outils via le serveur MCP (voir section MCP tools)
- Ou utiliser les manifests dans `quantlive_skills/skills/` pour les imports direct (pour usages avancés)

## Intégration avec le serveur MCP

Le serveur MCP (`quantlive_mcp.server`) charge les outils depuis `quantlive_mcp.tools.*` et les expose via FastMCP.

Lien : https://github.com/QuantLive/quantlive-mcp

## Contributions

Voir les règles du repo.

## License

Voir LICENSE du repo.

## Auteur

QuantLive team.