openclaw-multiagent-trade

Contract-first, keyless Binance futures research sandbox for historical replay, backtesting, market-data capture, and local paper trading.

This repository is a public monorepo with two layers:

• trading/
  • the research and runtime codebase
• platform/
  • the host-side control-plane blueprint, monitor board example, and operational design docs

What This Project Is

• A reproducible research sandbox for Binance USD-M perpetual futures
• A contract-first runtime with explicit boundaries between data, research, risk, and deterministic execution
• A keyless-first platform: public market-data access comes first, exchange credentials are optional and not required for the core path
• A paper-only system with strong guardrails and no live-money execution

What It Is Not

• Not a live trading bot
• Not an autonomous LLM trading loop
• Not a repository of personal host state, VM snapshots, or private operator history
• Not an example of direct exchange key usage in source-controlled defaults

Core Capabilities

• Historical replay with manifest-driven offline runs
• Trade-driven backtesting on normalized Binance public data
• Public Binance live capture with depth-aware recorder quality tracking
• Local paper trading on captured public market data
• Host-side monitoring concepts for recorder health, incidents, and continuity audits

Guardrails

• No live exchange credentials in repository defaults
• No live-money order placement
• No live-money venue trading
• No discretionary LLM-controlled trading loop
• No hidden runtime data bundled into the repository

5-Minute Quickstart

Read QUICKSTART.md for the shortest path.

If you want the most direct first run:

cd trading
micromamba env create -f environment.trade.yml
micromamba run -n crypto-trade-env bash -lc 'make docs-check contract-validate'
micromamba run -n crypto-trade-env bash -lc 'make binance-historical-sync-sample backtest-run'
micromamba run -n crypto-trade-env bash -lc 'make live-capture-fixture local-paper-simulate'

That path uses curated fixtures and public-data samples. It does not require exchange keys.

Repo Map

• docs/repo-map.md
• docs/public-boundaries.md
• docs/roadmap.md
• docs/glossary.md
• trading/README.md
• platform/README.md

Verification

Trading-layer verification entrypoints live under trading/:

cd trading
make docs-check contract-validate
make test-historical-runtime test-backtest-runtime
make test-live-capture-runtime test-paper-runtime

Current Status

• Phase 1 foundation: complete
• Phase 2 offline research and simulation: complete
• Phase 3 keyless historical sync, backtesting, live capture, local paper trading, and data-quality hardening: complete
• Optional keyed venue-side paper adapter: intentionally left out of the public keyless-first release