# decker [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/gigshow/decker-ai  
**GitHub Stars:** 3  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/decker

## Description
Deterministic market-state engine for trading agents — state, gate, coordinates, with receipts.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "decker": {
    "url": "https://decker-ai.com"
  }
}
```

## Documentation & README

<!--
  Keywords: AI trading signal, crypto market state engine, structural analysis,
  algorithmic trading API, Telegram trading bot, Python SDK, decker-client,
  deterministic signal, progress_pct, operation rules, GO WATCH HOLD, KRX, KOSPI
-->
<div align="center">

<h1><img src="https://raw.githubusercontent.com/gigshow/decker-ai/HEAD/assets/decker_claw_owl_v1.svg" height="46" align="top" alt="DeckerClaw" />&nbsp; Decker AI</h1>

### The deterministic market-state layer your trading agents call.

**Rules trade, LLMs explain.** Live, non-custodial, with receipts.

[Open the app](https://decker-ai.com) · [Telegram bot](https://t.me/deckerclawbot) · [Kakao channel](https://pf.kakao.com/_RxlxjVX) · [API docs](https://api.decker-ai.com/docs)

[![Open App](https://img.shields.io/badge/Open_App-decker--ai.com-00C853?style=flat-square)](https://decker-ai.com)
[![Telegram](https://img.shields.io/badge/Telegram-@deckerclawbot-26A5E4?style=flat-square&logo=telegram&logoColor=white)](https://t.me/deckerclawbot)
[![Kakao Channel](https://img.shields.io/badge/Kakao-Channel-FEE500?style=flat-square&logo=kakaotalk&logoColor=000000)](https://pf.kakao.com/_RxlxjVX)
[![API Docs](https://img.shields.io/badge/API-docs-4D9FFF?style=flat-square)](https://api.decker-ai.com/docs)
[![MCP Server](https://img.shields.io/badge/MCP-server-9C27B0?style=flat-square)](https://api.decker-ai.com/api/v1/mcp/health)
[![PyPI](https://img.shields.io/pypi/v/decker-client?style=flat-square&color=3776AB&label=PyPI)](https://pypi.org/project/decker-client/)
[![Track record](https://img.shields.io/badge/track_record-stamped_daily-00C853?style=flat-square)](TRACK_RECORD.md)
[![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)](LICENSE)

<img src="https://raw.githubusercontent.com/gigshow/decker-ai/HEAD/assets/screenshots/hero_desktop.jpg" width="880" alt="Decker AI — the live market-state cockpit across crypto and Korean equities (KOSPI 200)" />

</div>

---

## What you get

- **Signals you can act on, with context.** Not "BUY" — `GO / WATCH / HOLD` + `progress_pct` (0–100% lifecycle) + entry / stop / target.
- **It explains itself.** Every signal has a structural cause (multi-timeframe alignment, state machine phase) that an LLM translates into plain language.
- **Same engine, two markets.** Crypto (24/7) + Korean equities (KOSPI + KOSDAQ, Beta).
- **Use it your way.** Web app, Telegram, Kakao channel, REST API, or MCP server inside Claude / Cursor.

> *"Where are we in the current structural cycle — and what's the next optimal move?"*

---

## Get started in 60 seconds

| Path | Best for | Start |
|------|---------|-------|
| 📱 **Web app** | Most people — full dashboard, mock trading, KRX watchlist | **[decker-ai.com](https://decker-ai.com)** — sign up free |
| 🤖 **Telegram bot** | Quick signal checks on your phone | **[@deckerclawbot](https://t.me/deckerclawbot)** — `/start` |
| 💛 **Kakao channel** | 한국 사용자, KRX 시그널 알림 | **[pf.kakao.com/_RxlxjVX](https://pf.kakao.com/_RxlxjVX)** |
| 🧠 **MCP server** | Claude / Cursor / Codex users | **[decker-ai.com/mcp](https://decker-ai.com/mcp)** — 2-min setup |
| 🛠 **REST API** | Developers building bots & apps | [DEVELOPER_README.md](https://github.com/gigshow/decker-ai/blob/HEAD/DEVELOPER_README.md#api-quickstart-3-steps) |

> Free tier is generous (30 calls/day on the API; Web + Telegram included). During Beta, signed-up users get **PRO access for free**.

---

## See it in action

**Start here — 30 seconds. No signup, no key.**

```bash
curl -s https://api.decker-ai.com/api/v1/public/demo | jq .
```

<a href="https://gigshow.github.io/decker-ai/assets/video/decker-mcp-demo.mp4"><img src="https://raw.githubusercontent.com/gigshow/decker-ai/HEAD/assets/screenshots/posters/decker-mcp-demo.jpg" width="760" alt="MCP journey demo — all 13 tools chained through one live session: explore, set risk, decide, execute, manage" /></a>

▶️ **[Play — MCP journey demo (30s)](https://gigshow.github.io/decker-ai/assets/video/decker-mcp-demo.mp4)** · One live session, all 13 tools: explore a market → set your risk profile → decide → execute → manage — **zero LLM in the signal path.**

Shorter cut with the response and the plain-language takeaway shown together on every call (no separate captions needed): **[Play — Shorts cut (35s)](https://gigshow.github.io/decker-ai/assets/video/decker-mcp-shorts.mp4)**

### The engine room — live FSM, MTF alignment, R:R

<a href="https://gigshow.github.io/decker-ai/assets/video/decker-webapp-dashboard.mp4"><img src="https://raw.githubusercontent.com/gigshow/decker-ai/HEAD/assets/screenshots/posters/decker-webapp-dashboard.jpg" width="760" alt="The live cockpit — full universe grid with per-symbol state and AI reading" /></a>

▶️ **[Play — the live cockpit (16s)](https://gigshow.github.io/decker-ai/assets/video/decker-webapp-dashboard.mp4)** · Every signal traces to a structural cause: `progress_pct` + `operation_gate` + entry / stop / target.

### Signal → execution, non-custodial

<a href="https://gigshow.github.io/decker-ai/assets/video/decker-hyperliquid-page.mp4"><img src="https://raw.githubusercontent.com/gigshow/decker-ai/HEAD/assets/screenshots/posters/decker-hyperliquid-page.jpg" width="760" alt="Hyperliquid — state, signal-engine coordinates, and a non-custodial order" /></a>

▶️ **[Play — non-custodial execution (16s)](https://gigshow.github.io/decker-ai/assets/video/decker-hyperliquid-page.mp4)** · Click Order · wallet-sign · **custody 0**. Decker relays your signature only (revocable agent wallet, EIP-712). *For information only — not investment advice.*

### Read it daily — and we score our own calls

<a href="https://gigshow.github.io/decker-ai/assets/video/decker-daily-briefing.mp4"><img src="https://raw.githubusercontent.com/gigshow/decker-ai/HEAD/assets/screenshots/posters/decker-daily-briefing.jpg" width="620" alt="The web briefing hub — per-symbol view with baseline, target, and invalidation" /></a>
<a href="https://gigshow.github.io/decker-ai/assets/video/decker-telegram-briefing.mp4"><img src="https://raw.githubusercontent.com/gigshow/decker-ai/HEAD/assets/screenshots/posters/decker-telegram-briefing.jpg" width="260" alt="The daily briefing on Telegram — picks and subscribe" /></a>

▶️ **Play:** [web hub (10s)](https://gigshow.github.io/decker-ai/assets/video/decker-daily-briefing.mp4) · [Telegram (6s)](https://gigshow.github.io/decker-ai/assets/video/decker-telegram-briefing.mp4)

Every morning (08:00 KST): the engine's view per symbol — baseline, what winning and losing look like, and a pick you can answer. Evening: the **same view scored against what actually happened — hits and misses alike, on the record.** *We stamp our wrong calls too.*

Web hub: [decker-ai.com/briefing](https://decker-ai.com/briefing) · Subscribe: [@deckerclawbot](https://t.me/deckerclawbot) → `/briefing`

### Korean equities (KRX) — Beta, free

<a href="https://gigshow.github.io/decker-ai/assets/video/decker-krx-page.mp4"><img src="https://raw.githubusercontent.com/gigshow/decker-ai/HEAD/assets/screenshots/posters/decker-krx-page.jpg" width="760" alt="Korean equities — today's hot market and portfolio actions on KOSPI" /></a>

▶️ **[Play — KRX (16s)](https://gigshow.github.io/decker-ai/assets/video/decker-krx-page.mp4)** · Same deterministic engine on KOSPI + KOSDAQ. Portfolio states — **ADD / HOLD / REDUCE / EXIT**, not buy/sell. Daily closing-bell checkup at 16:30 KST · [@krxdeckerbot](https://t.me/krxdeckerbot).

---

## Three things that make it different

**1. `progress_pct` — every signal has a lifecycle.**
A signal at 25% progress is a different trade than the same signal at 80%. Most tools just say "BUY"; Decker tells you *where in the move you are*.

```
Entry                                                           Target
  0%──────────33%──────────50%──────────67%──────────83%────────100%
 Wait       Entry        Active       Late TP      Final TP     Exit
```

**2. `GO / WATCH / HOLD` — three gates, not binary.**
| Gate | Meaning |
|------|---------|
| **GO** | Structure confirmed — entry conditions met |
| **WATCH** | Signal forming — monitor, no entry yet |
| **HOLD** | Active position — no new entry signal |

> `WATCH` is the gate most tools skip. It's why users enter too early.

**3. Deterministic + traceable. LLM explains, doesn't decide.**
| | Typical AI signal | Decker |
|---|---|---|
| Source | ML / LLM price prediction | Deterministic state machine |
| Output | BUY / SELL | `progress_pct` + `operation_gate` + ranked choices |
| LLM role | Makes the call | **Explains the structural state** |
| Auditability | ❌ Black box | ✅ Every signal has a `trace_id` |
| Cost per signal | High | **$0 on the rules path** |
| Reproducibility | ❌ | ✅ Same input → same output, always |

---

## Pricing

| Tier | Price | Daily API limit | MCP | Auto-trade |
|------|-------|-----------------|-----|------------|
| **FREE** | $0 forever | 30 calls/day | read-only (1d cache) | ❌ |
| **PRO** | $20 / mo · 7-day trial | 1,000 / day | full (13 tools) | virtual + real |
| **ENTERPRISE** | Contact us | 100,000+ / day · custom | full + per-org skill catalog | + custom integration |

> **Beta (now):** all authenticated users get **PRO for free** via `BETA_TIER_OVERRIDE=PRO`. No payment required.

Web sign-up and Telegram bot are always free for the basics.

---

## For developers

Building a bot, app, or agent on top of Decker? Everything you need — REST endpoints, MCP server (Claude / Cursor / Codex), Python SDK, OpenClaw skill, self-host — lives in one place:

### → **[DEVELOPER_README.md](https://github.com/gigshow/decker-ai/blob/HEAD/DEVELOPER_README.md)**

```bash
# 60-second smoke test (no auth needed)
curl https://api.decker-ai.com/api/v1/public/demo
```

```bash
# With an API key (decker-ai.com → Settings → API Keys, or Telegram /apikey)
curl "https://api.decker-ai.com/api/v1/public/signals/BTCUSDT/latest?timeframe=1h" \
  -H "X-API-Key: dk_live_xxx"
```

**Prefer a runnable file?** → [`examples/quickstart.py`](https://github.com/gigshow/decker-ai/blob/HEAD/examples/quickstart.py) — zero dependencies (stdlib only), no key, prints the composed view + receipts in one run. Wrapping Decker for an agent crew: [`examples/langgraph_decker_tool.py`](https://github.com/gigshow/decker-ai/blob/HEAD/examples/langgraph_decker_tool.py). More in [`examples/`](https://github.com/gigshow/decker-ai/blob/HEAD/examples/).

The demo returns the **composed view** — the same card our daily briefing sends:

```json
{ "layer": "STATE_VIEW", "symbol": "BTCUSDT", "ref_price": 63650.0,
  "lines": ["■ BTC — 층간 힘겨루기: 주 판 아래쪽 · 지금 판 위쪽", "…"],
  "wait_target": "...", "invalidation": "...",
  "verdict_recent": [{"briefing_date": "2026-07-05", "slot": "morning", "verdict": "hit"}],
  "provenance": { "composer": "briefing_story.compose_card" } }
```

**Add to Claude Desktop / Cursor (MCP):** guided 2-minute setup with per-client config → **[decker-ai.com/mcp](https://decker-ai.com/mcp)**.

Cursor (`~/.cursor/mcp.json`) takes a remote server directly:

```json
{
  "mcpServers": {
    "decker": {
      "url": "https://api.decker-ai.com/api/v1/mcp",
      "headers": { "X-API-Key": "dk_live_YOUR_KEY" }
    }
  }
}
```

> ⚠ Endpoint is `/api/v1/mcp` (stateless Streamable HTTP) — an old `/sse` suffix now returns `405 Method Not Allowed`.

Claude Desktop / Codex reach it through the `mcp-remote` bridge (needs Node/npx) — see [decker-ai.com/mcp](https://decker-ai.com/mcp) or **[DEVELOPER_README.md](https://github.com/gigshow/decker-ai/blob/HEAD/DEVELOPER_README.md)** (endpoints · auth · rate limits · MCP tools · SDK · OpenClaw · self-host).

**Running a multi-agent crew** (TradingAgents / LangGraph / AutoGen)? Give your analysts one deterministic market-state instrument — with receipts — instead of re-deriving structure per prompt: → **[docs/integrations/multi-agent-frameworks.md](https://github.com/gigshow/decker-ai/blob/HEAD/docs/integrations/multi-agent-frameworks.md)**

---

## How the engine works (one diagram)

```
Raw OHLCV candles
  ↓  Sequence Labeler  →  every candle gets a role (anchor / test / signal)
  ↓  State Machine     →  C_SET → B_FORMING → B_SET → A_FORMING → W_PENDING
  ↓  Operation Gate    →  GO · WATCH · HOLD
  ↓  RULES Engine      →  9-layer YAML rulebook → strategy + ranked choices
  ↓  AI Consultation   →  LLM translates structural state → plain language
  ↓
"67% progress. B-leg confirmed. Recommended: 30% partial TP or hold to target."
```

**No price prediction. No black box. Every output traces to a formal structural cause.**

Deep dives: [Sequence Engine](https://github.com/gigshow/decker-ai/blob/HEAD/concept/sequence_engine.md) · [Labeling Algorithm](https://github.com/gigshow/decker-ai/blob/HEAD/concept/labeling_algorithm.md) · [Market State Theory](https://github.com/gigshow/decker-ai/blob/HEAD/concept/market_state_theory.md)

---

## Supported symbols

**Crypto (GA):** `BTCUSDT` · `ETHUSDT` · `SOLUSDT` · `BNBUSDT` · `XRPUSDT` · `DOGEUSDT` — timeframes `30m`, `1h`, `4h`, `1d`.

**KRX (Beta, free):** KOSPI 948 + KOSDAQ 1,822 = **2,770 tickers**. Universe = top 200 by trading value ∪ user watchlist ∪ momentum spike ∪ volume spike. Timeframe `1d` only (1w expanding). Daily evaluation at 16:30 KST.

KRX details: [`docs/krx/KRX_BUSINESS_MODEL_AND_ROADMAP_2026-05-09.md`](https://github.com/gigshow/decker-ai/blob/HEAD/docs/krx/KRX_BUSINESS_MODEL_AND_ROADMAP_2026-05-09.md).

---

## Performance

We don't publish a headline win rate. Backtest numbers without method
and sample size are marketing, not evidence — and easy to cherry-pick.

What we stand on instead:

- **Deterministic & reproducible.** Same input → same output, always.
  The rules path has zero LLM in it, so a signal is not a model's opinion —
  it's a formal structural verdict you can re-derive.
- **Auditable.** Every read carries its `provenance` (composer + the versioned
  rulebook contract) and traces back to the exact engine emit. The full
  RULES.yaml is open, so you can re-derive any verdict yourself.
- **Scored in public, daily.** The morning briefing's view is graded against
  what actually happened that evening — hits and misses alike, on the record.
  → [decker-ai.com/briefing](https://decker-ai.com/briefing) · a GitHub Action
  stamps the daily scorecard straight into this repo: [TRACK_RECORD.md](https://github.com/gigshow/decker-ai/blob/HEAD/TRACK_RECORD.md)

Method and rulebook are open: [Model & Algorithm](https://github.com/gigshow/decker-ai/blob/HEAD/docs/model.md) · [Operation Rules (YAML)](https://github.com/gigshow/decker-ai/blob/HEAD/operation_rules/RULES.yaml) · [Signal Performance](https://github.com/gigshow/decker-ai/blob/HEAD/docs/signal-performance.md).

*For information only. Not investment advice.*

---

## Docs

| | |
|--|--|
| **[DEVELOPER_README.md](https://github.com/gigshow/decker-ai/blob/HEAD/DEVELOPER_README.md)** | API · MCP · SDK · OpenClaw · self-host — **start here if you're building** |
| [Quick Start](https://github.com/gigshow/decker-ai/blob/HEAD/docs/quickstart.md) | 5-minute path picker — Telegram / MCP / REST / SDK |
| [API Guide](https://github.com/gigshow/decker-ai/blob/HEAD/docs/api-guide.md) | Full field-level endpoint reference + error codes |
| [Docs by persona](https://github.com/gigshow/decker-ai/blob/HEAD/docs/README.md) | Trader / Builder / Curious about the engine / Evaluating claims |
| [Architecture](https://github.com/gigshow/decker-ai/blob/HEAD/docs/architecture.md) | Pipeline, state engine, modules |
| [Model & Algorithm](https://github.com/gigshow/decker-ai/blob/HEAD/docs/model.md) | How the signal engine works |
| [Operation Rules](https://github.com/gigshow/decker-ai/blob/HEAD/operation_rules/RULES.yaml) | Open YAML rulebook (v2.4.7+) |
| [Article Series (1–15)](https://github.com/gigshow/decker-ai/blob/HEAD/docs/medium/README.md) | Deep dives on Medium |
| [Roadmap](https://github.com/gigshow/decker-ai/blob/HEAD/docs/roadmap.md) | What's next |
| [llms.txt](https://github.com/gigshow/decker-ai/blob/HEAD/llms.txt) | LLM / AI agent discovery manifest |

---

## Links

| | |
|-|-|
| **Web app** | https://decker-ai.com |
| **API docs** | https://api.decker-ai.com/docs |
| **Telegram bot (crypto)** | https://t.me/deckerclawbot |
| **Telegram bot (KRX)** | https://t.me/krxdeckerbot |
| **Kakao channel** | https://pf.kakao.com/_RxlxjVX |
| **X / Twitter** | https://x.com/blockoceandev |

---

> This repository is the **public hub** for Decker AI — SDK, samples, rulebook, architecture docs, OpenClaw skill packages.
> Production application code runs in a private monorepo. All listed endpoints, channels, and the web app are live.
>
> Built by **[gigshow](https://github.com/gigshow)** (Dohyung Kim · 김도형) — founder. *Open to investor / partnership conversations.*