ai-exchange/README.md

AI ICT

AI ICT 交易辅助系统第一阶段工程实现。

当前项目已经具备从数据、结构、信号、执行、回测到报告的最小闭环，并提供轻量查询 API、HTTP 调试服务与一键编排入口。

See docs/ for architecture, database, rule, and migration references.

Current closed loop

当前主线可运行链路：

OKX -> candles -> market_sessions -> swings -> dealing_ranges -> liquidity_pools -> sweep_events -> displacement_events -> MSS -> FVG -> bias_snapshots -> trade_signals -> trade_executions -> backtest_runs -> backtest_results -> reports

Runtime utility scripts

• python3 scripts/run_dev.py - run the scaffold entrypoint
• python3 scripts/show_models.py - list exported ORM model names
• python3 scripts/check_db.py - run a simple database connectivity check
• python3 scripts/run_migrations.py - apply SQL files in migrations/ order
• python3 scripts/run_okx_backfill.py - fetch and write sample OKX candles
• python3 scripts/run_session_generator.py - generate market sessions
• python3 scripts/run_swings.py - rebuild swings
• python3 scripts/run_ranges.py - rebuild dealing ranges
• python3 scripts/run_liquidity.py - rebuild liquidity pools
• python3 scripts/run_sweeps.py - rebuild sweep events
• python3 scripts/run_displacement.py - rebuild displacement events
• python3 scripts/run_mss.py - rebuild MSS structure events
• python3 scripts/run_fvg.py - rebuild FVG zones
• python3 scripts/run_signals.py - generate bias and signals
• python3 scripts/run_execution.py - run paper execution gating and create an execution record
• python3 scripts/run_backtest.py - run backtest and write results
• python3 scripts/run_reports.py - build sample reports from current services
• python3 scripts/run_api_server.py - start a lightweight HTTP API server on 127.0.0.1:8000
• python3 scripts/run_pipeline.py - run the current end-to-end closed loop and print a structured summary

Lightweight API helpers

The src/api/ package exposes internal query helpers and HTTP routes for:

• GET /health
• GET /candles?instrument_id=1&timeframe=1m&limit=100
• GET /sessions?instrument_id=1&limit=20
• GET /signals?instrument_id=1&limit=20
• GET /backtests?instrument_id=1&limit=10

Validation

Unit tests:

• python3 -m unittest discover -s tests/unit -p "test_*.py"