decker-developer

Decker Developer API 스킬

Goal

개발자가 Decker Public API를 연동하는 데 필요한 키 발급·인증·엔드포인트·Rate Limit 안내.

---

1. API 키 발급 (무료)

전체 흐름 (3단계):

1. decker-ai.com 회원가입
2. 로그인 → 설정 → 텔레그램 → 연동 코드 발급 → 텔레그램 /start {코드}
3. 텔레그램 @deckerclawbot 에서:

/apikey
→ dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 발급

• /apikey reset — 기존 키 폐기 후 재발급.
• 키는 한 번만 전체 표시. 분실 시 /apikey reset.

Tier: 기본 FREE (30 req/day). 상위 플랜 문의는 텔레그램.

---

2. 인증 헤더

모든 Public API 요청에 헤더 추가:

X-API-Key: dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Base URL: https://api.decker-ai.com

---

3. Public Endpoints

GET /api/v1/public/signals/{symbol}/latest

최신 시그널 — 방향·진입가·목표가·손절가·진행률.

curl -H "X-API-Key: dk_live_..." \
  "https://api.decker-ai.com/api/v1/public/signals/BTCUSDT/latest?timeframe=1h"

응답:

{
  "symbol": "BTCUSDT",
  "timeframe": "1h",
  "direction": "long",
  "entry_price": 94200.0,
  "target_price": 97500.0,
  "stop_loss": 92800.0,
  "current_price": 95100.0,
  "progress_pct": 27.3,
  "generated_at": "2026-04-23T09:00:00+00:00"
}

timeframe 가능값: 15m, 30m, 1h, 4h, 8h, 1d, 1w

operation_gate: GO = 진입 신호 / WATCH = 관측 중 / HOLD = 대기 (GO만 진입 권고)

---

GET /api/v1/public/signals/{symbol}/narrative

규칙 기반 구조 서사 — LLM 비용 없음, deterministic.

curl -H "X-API-Key: dk_live_..." \
  "https://api.decker-ai.com/api/v1/public/signals/BTCUSDT/narrative?timeframe=4h"

응답:

{
  "symbol": "BTCUSDT",
  "timeframe": "4h",
  "narrative": "BTC 4h: A-사이클 진행 중, 트리거 활성 — 상승 1단계 목표 유효.",
  "axis": "bullish",
  "generated_at": "2026-04-23T08:00:00+00:00"
}

---

4. Rate Limit

Tier	일일 한도	비고
FREE	30 req/day	웹 Settings→API Keys · 텔레그램 /apikey
PRO	1,000 req/day	$20/mo
ENTERPRISE	100,000 req/day	문의

429 응답 시 내일 리셋. 헤더: X-RateLimit-Remaining.

---

5. 시그널 소스 투명성

Public API는 engine:live_l1 소스만 반환한다.