# Decker AI API

> 시그널·시세·전략·주문을 하나로. AI 에이전트·대화형 서비스용. 룰북 기반으로 LLM 토큰 비용 없음.

## Docs

- [OpenAPI](https://api.decker-ai.com/docs): Swagger UI, 전체 스키마

## 인증

- **베타**: 아래 Core Endpoints 는 키 없이 호출 가능
- **정식**: decker-ai.com 회원가입 → API 키 발급 → X-Api-Key 헤더
- **공개 (항상)**: /llms.txt, /api/v1/system/health, /api/v1/public/demo
- **키 필요 (X-API-Key)**: /api/v1/public/state/{symbol}/{timeframe} · /api/v1/public/view/{symbol} · /api/v1/public/signals/{symbol}/latest

## 심볼 유니버스 (14종 — 엔진이 판독·시그널을 emit 하는 전체)

MCP·텔레그램·브리핑·API 단일 기준 (ENGINE_STATE_SYMBOLS). API 호출 시 아래 심볼 문자열 그대로 사용 — HL 합성은 `XYZ_*` 그대로.

- 크립토 perp (6): `BTCUSDT` 비트코인 · `ETHUSDT` 이더리움 · `SOLUSDT` 솔라나 · `BNBUSDT` BNB · `XRPUSDT` 리플 · `DOGEUSDT` 도지
- HL 합성 (8): `XYZ_GOLDUSD` 금 · `XYZ_SILVERUSD` 은 · `XYZ_CLUSD` 유가(WTI) · `XYZ_BRENTOILUSD` 브렌트유 · `XYZ_SP500USD` S&P500 · `XYZ_KR200USD` 코스피200 · `XYZ_TSLAUSD` 테슬라 · `XYZ_NVDAUSD` 엔비디아

## 심볼별 최신 시그널 (1급 시그널 여정)

```
GET /api/v1/public/signals/{symbol}/latest?timeframe=1h
Header: X-API-Key: dk_live_…
```

timeframe = 30m · 1h · 4h · 1d · 1w (기본 1h). 위 14종 전 심볼에서 동작 (HL 합성 `XYZ_*` 포함, 2026-07-10 14/14 실측). 해당 심볼/타임프레임에 활성 시그널이 없으면 404.

실응답 예시 (2026-07-10 실측):

```
{"symbol":"XYZ_SILVERUSD","timeframe":"1h","direction":"+","entry_price":59.767,
 "target_price":60.964,"stop_price":58.5717,"current_price":59.547,"progress_pct":0.0,
 "status":"in_progress","action_gate":"GO","c_state":null,"trigger_lane":null,
 "trigger_kind":"REVERSAL","signal_source":"active_user_signal","generated_at":"2026-07-10T15:00:00Z"}
```

## Core Endpoints (베타: 공개, 정식: API 키 필요)

- [Health](https://api.decker-ai.com/api/v1/system/health): 헬스체크 (항상 공개) — 응답에 `version`, `build.git_sha` / `build.git_sha_full` (배포 커밋, Railway 등)
- [Signals Public](https://api.decker-ai.com/api/v1/judgment/signals/public): 시그널 리스트 (`?symbol=` 필수 — symbol, timeframe, direction, confidence). 심볼별 최신 1건은 위 "심볼별 최신 시그널" 경로가 1급
- [Signal State](https://api.decker-ai.com/api/v1/signals/{symbol}/state): 종목별 진행도·상태·market_state
- [Strategy](https://api.decker-ai.com/api/v1/signals/{symbol}/strategy): 진행도 기반 전략 (오퍼레이션 룰북)
- [Consultation](https://api.decker-ai.com/api/v1/signals/{symbol}/consultation): 상의 (rationale, choices)
- [Market Prices](https://api.decker-ai.com/api/v1/market/prices): 실시간 시세 (symbols=BTCUSDT,ETHUSDT)
- [Compare](https://api.decker-ai.com/api/v1/judgment/compare): 다중 자산 비교
- [Market Status](https://api.decker-ai.com/api/v1/judgment/market-status): 시장 상태 (청산·펀딩)
- [LLM Opportunities](https://api.decker-ai.com/api/v1/llm/opportunities): 에이전트용 인사이트 (conviction, rationale, choices)

## LLM Opportunities (에이전트 필수)

```
GET /api/v1/llm/opportunities?symbol=BTC&minConfidence=0.6&limit=5
```

에이전트·대화형 서비스에 넣기 좋은 JSON. conviction, progress_pct, strategy, rationale, choices. 룰북 기반 → AI 토큰 $0.

## Signal Push (등록)

```
POST /api/v1/signals/push
Body: {"symbol":"BTCUSDT","timeframe":"1h","direction":"long","entry_price":96000,"target_price":100000,"stop_loss":92000}
```

등록 후 /state, /strategy, /llm/opportunities 즉시 사용 가능.

## Base URL

https://api.decker-ai.com

## Optional

- [Decker Service](https://decker-ai.com): 사용자 대시보드, Telegram·Slack 연동
- [ClawHub decker skill](https://clawhub.ai): OpenClaw 스킬 (web_fetch → Decker API)