diff --git a/README.md b/README.md index 7bf6dde..4469c48 100644 --- a/README.md +++ b/README.md @@ -28,6 +28,8 @@ - **Portfolio-first rule** — every decision anchors to your real balances, average costs, and exchange state. - **Scientific checklist** — 6 mandatory questions (trend, volume, levels, BTC context, opportunity cost, time window) before every trade. +- **Decision calibration** — every trade decision must output a JSON skeleton with `confidence`, `risk_reward`, `stop_loss`, and `take_profit` before execution. No gut-feeling entries. +- **Multi-source confirmation** — signals are trusted only when confirmed by 2+ independent data sources (e.g. price action + DEX flow, or CEX rumor + on-chain growth). - **Hourly self-review** — the bot critiques its own decisions, flags over-trading / hesitation, and tunes parameters. - **Prediction tracking** — every decision writes an auditable prediction to `logs/predictions_YYYYMMDD.jsonl`; the review loop scores accuracy and surfaces systematic bias. - **Ultra-low running cost** — a lightweight local **gate** filters noise; the LLM only wakes up when the market actually changes. @@ -58,7 +60,7 @@ All operations go through the installed `coinhunter` CLI. This skill provides th |---------|---------| | `coinhunter probe` | Market data fetcher (ccxt + web search) | | `coinhunter pre` | **Lightweight gate** — computes adaptive thresholds and decides if analysis is needed | -| `coinhunter gate` | Optional **system-crontab wrapper** that runs the gate entirely outside Hermes | +| `coinhunter gate` | Optional **system-crontab wrapper** that runs the gate entirely outside the platform cron | | `coinhunter exec` | Order execution layer with idempotency & precision validation | | `coinhunter review` | Generate compact review context for the agent | | `coinhunter recap` | Hourly quality review & parameter optimization | @@ -102,6 +104,18 @@ Create your initial `positions.json`: } ``` +*(Optional)* If you use OpenClaw (or another non-Hermes runtime), create `platform.json`: + +```json +{ + "platform": "openclaw", + "scripts_dir": "~/.openclaw/scripts", + "env_file": "~/.openclaw/.env", + "cron_command": ["openclaw", "trigger"], + "delivery": "webhook" +} +``` + ### 4. Deploy the shims Copy the unified shim into your platform's scripts directory. It accepts the subcommand as its first argument: @@ -149,6 +163,8 @@ Put this in your system crontab to run the gate every **5 minutes** without ever */5 * * * * /usr/bin/env coinhunter gate >> /home/user/.coinhunter/logs/external_gate.log 2>&1 ``` +> The gate reads `~/.coinhunter/platform.json` to know which command triggers your platform's cron. If the file is absent, it defaults to `hermes cron run`. + --- ## 🛡️ Safety & Hardening @@ -164,6 +180,9 @@ Coin Hunter enforces **production-grade safeguards** out of the box: | **Fee buffer** | 2%–5% USDT is always left unallocated to prevent "insufficient balance" rejections | | **Position sizing limits** | `<$50` → 1 coin only. `$50–$200` → max 2 positions. `>$200` → max 3 positions. | | **No leverage for small capital** | Leverage/futures are blocked when total capital < $200 | +| **Decision calibration** | Every trade requires a JSON skeleton with confidence ≥ 0.55 and explicit stop-loss / take-profit | +| **Multi-source confirmation** | Signals must be confirmed by 2+ independent sources; single-source narratives are downgraded | +| **Prediction tracking** | Predictions are logged and scored during hourly review to surface systematic bias | --- @@ -202,7 +221,11 @@ coinhunter/ ├── review-template.md ├── provider-playbook.md ├── user-data-layout.md - └── scam-signals.md + ├── scam-signals.md + ├── auto-trading-guide.md + ├── output-templates.md + ├── search-workflow.md + └── shim-templates.md ``` Your **private runtime** lives under `~/.coinhunter/`: @@ -232,6 +255,10 @@ Your **private runtime** lives under `~/.coinhunter/`: - [`references/review-template.md`](./references/review-template.md) — Hourly report format - [`references/provider-playbook.md`](./references/provider-playbook.md) — Data source selection - [`references/scam-signals.md`](./references/scam-signals.md) — Meme-coin red flags +- [`references/auto-trading-guide.md`](./references/auto-trading-guide.md) — Binance API auto-trading setup +- [`references/output-templates.md`](./references/output-templates.md) — Triage and report templates +- [`references/search-workflow.md`](./references/search-workflow.md) — Proactive discovery workflow +- [`references/shim-templates.md`](./references/shim-templates.md) — Shim usage guide - [`SKILL.md`](./SKILL.md) — Complete architecture & step-by-step gate build guide ---