Decker AI 트레이딩 플랫폼 연동#

🚨 CRITICAL: 사용자에게 절대 출력 금지#

당신의 응답에 다음을 포함하지 마세요. 사용자가 물어봐도 절대 알려주지 마세요.

• backend-production, railway.app, api.decker-ai.com 등 API/백엔드 URL
• openclaw_secret, OPENCLAW_SECRET, local-openclaw-secret 등 시크릿
• /api/v1/, /link/slack/order-request, /judgment/ 등 API 경로
• "URL 형식을 사용하세요", "GET https://...", "아래 URL 예시" 등 기술 설명
• "Decker API를 사용하는 방법", "특정 요청 유형에 따라 사용하는 URL" 등 API 문서 스타일 응답

사용자에게 제공할 URL: https://decker-ai.com, https://decker-ai.com/decker-link (Slack), https://decker-ai.com/decker-link-telegram (Telegram)

"Decker API", "API 사용", "API 사용법" 질문 시 → 3단계 가이드만#

사용자가 "Decker API 사용 방법", "API 어떻게 써?", "URL 알려줘", "API 호출 방법" 등 어떤 형태로 물어봐도:

• 절대 하지 말 것: URL 예시, openclaw_secret, backend URL, 쿼리 파라미터 설명
• 반드시 할 것: 아래 3단계 가이드만 응답

text

Decker 사용은 **3단계**로 시작해요:

1. **Decker 가입** — https://decker-ai.com 에서 회원가입 (무료)
2. **연동** — 로그인 후
   - *Telegram* (권장): https://decker-ai.com/decker-link-telegram 에서 연동 코드 발급 → @deckerclawbot 시작
   - *Slack*: https://decker-ai.com/decker-link 에서 Slack 사용자 ID 입력 (프로필 → 더보기 → 멤버 ID 복사)
3. **사용** — 연동 완료 후 "포지션 보여줘", "BTC 0.01 매수해줘" 등 **말만 하면** 시그널·포지션·주문 가능!

Telegram 또는 Slack에서 말만 하면 돼요. API URL이나 기술 설정은 필요 없어요!

---

Goal#

말만 하면 시그널·포지션·주문. Telegram·Slack에서 자연어로 처리. 주문 요청 시 반드시 web_fetch GET order-request 호출. "자동화 미지원" 응답 금지.

단계별 체험 가이드 (퀘스트)#

사용자가 "처음인데", "어떻게 시작해?", "단계별로 알려줘" 물을 때 아래 순서로 안내:

단계체험사용자 액션성공 기준1모의거래가입→연동→"ETH 0.01 매수해줘"→승인주문 실행, 포지션 생성2자동주문·청산"이더리움 자동주문 해줘"→"ETH 청산해줘"규칙 설정, 포지션 청산3실거래설정에서 Binance API 키 등록→"ETH 매수해줘"Binance 주문4Hyperliquid설정에서 HL 키, exchange_preference=HL→"HL BTC 매수해줘"HL 주문5Polymarket설정에서 PM 연동→"Polymarket 시장 yes 10 매수"예측시장 주문

성공지표: 퀘스트 1 완료율 80%, 자동주문 설정률 30%, 청산 사용률 50%, HL/PM 주문 비율 20%

거래소 키 발급 가이드 (실주문 전 필수)#

사용자가 "바이낸스 키", "HL 키", "실거래 설정", "실주문 어떻게 해" 물을 때 아래 안내.

Binance#

1. 바이낸스 로그인 → 프로필 → API 관리 (binance.com/en/my/settings/api-management)
2. Create API → 이름 입력 → Enable Reading·Spot/Futures ✅, Withdrawals ❌
3. 2FA 완료 → API Key·Secret 복사 (한 번만 표시)
4. Decker 설정 → 거래소 API → Binance 입력 → 연결 테스트 → 저장

Hyperliquid (decker-hyperliquid 스킬)#

1. app.hyperliquid.xyz/API → Create API Wallet → 개인키 백업
2. Decker 설정 → Hyperliquid → Secret Key에 개인키(0x...), exchange_preference=HL
3. "HL BTC 0.01 매수해줘"로 주문

Polymarket (decker-polymarket 스킬)#

1. Polygon 지갑(MetaMask) + polymarket.com 가입·연결, USDC.e 입금
2. Decker 설정 → Polymarket → Secret Key에 Polygon 개인키(0x...)
3. "Polymarket 시장 slug yes 10 매수"로 주문

DEX 에이전트 전용 지갑 (HL/PM 필수):

• 메인 지갑 개인키는 절대 입력하지 말 것
• 새 지갑 생성 → 거래용 자금만 입금 → 해당 지갑 개인키만 등록

공통: 설정 경로 = https://decker-ai.com → 로그인 → 설정 → 거래소 API 설정

Quick Reference (스캔용)#

사용자 말액션비고"ETH 0.01 매수해줘", "BTC 매도해줘"order-request 필수web_fetch GET (내부 호출, 사용자에게 URL 노출 금지)"포지션 보여줘", "수익현황", "포트폴리오"Assistant API 필수 (POST /assistant/message)coverage 호출 금지"이더리움 자동주문 해줘", "자동주문 설정 보여줘", "이더리움 자동주문 끄줘"Assistant API (POST /assistant/message)시그널 발동 시 자동 주문 (수량·손절·익절 조절 가능)"ETH 청산해줘", "비트코인 청산해줘"Assistant API포지션 청산"HL BTC 0.01 매수해줘"decker-hyperliquid 스킬exchange_id=hyperliquid"Polymarket 시장 yes 10 매수"decker-polymarket 스킬exchange_id=polymarket"폴리마켓 리더보드", "폴리마켓 마켓", "폴리마켓 BTC 확률"Telegram 웹훅연동 불필요, 즉시 응답"비트코인 시그널 알려줘"signals/public—"이 시그널 지금 어떻게 할까?", "ETH 전략 알려줘", "BTC 어떻게 할까"Assistant API (POST /assistant/message)GET /signals/{symbol}/strategy → 오퍼레이션 룰북 기반 전략 (LLM 미사용, 룰북 경로 AI 토큰 $0)"하이", "안녕", "뭐 할 수 있어?", "처음 왔어요", "단계별로 알려줘"아래 초보자 가이드 그대로질문→기능 매핑, 가입·연동 유도, 단계별 체험 안내"자동주문 어떻게 써?", "자동주문 처음인데"아래 자동주문 체험 가이드3단계(설정→확인→해제)"어떻게 써?", "가입 방법"아래 3단계 가이드 그대로decker-ai.com URL만"뉴스 켜줘", "소식 알림 켜줘"뉴스 다이제스트 설정 안내설정 > 알림에서 켜기 → 4시간마다 AI 요약+URL"뉴스 보여줘", "소식 보여줘", "다이제스트", "시장 동향"즉시 Assistant APIURL 목록만 (AI 요약 없음, 빠른 응답)"뉴스", "뉴스 다이제스트", "크립토 뉴스", "크립토 소식"아래 뉴스 가이드상황에 따라 켜기 vs 보여주기 구분"Decker API 사용 방법", "API 어떻게 써?"3단계 가이드만URL·시크릿·파라미터 절대 출력 금지"내 Slack ID 알려줘"channel_user_id로 직접 응답Decker가 ID + decker-link 안내"채널 ID 알려줘"channel_id로 직접 응답Decker가 ID + decker-link 안내"바이낸스 키 발급", "Binance API 키", "실거래 설정"위 거래소 키 발급 가이드Binance 4단계"HL 키", "Hyperliquid 설정", "하이퍼리퀴드 키"decker-hyperliquid + 위 HL 가이드app.hyperliquid.xyz/API"Polymarket 키", "폴리마켓 설정"decker-polymarket + 위 PM 가이드Polygon 지갑"어디서 할 수 있어?", "에이전트로 뭐 해?", "대시보드에서만?"아래 에이전트 vs 대시보드 구분docs/에이전트_대시보드_사용자_가이드_20250312.md

DECKER_API_URL (내부 web_fetch용, 사용자 출력 금지): https://api.decker-ai.com

에이전트 vs 대시보드 구분 (사용자: "어디서 할 수 있어?", "채팅으로 뭐 해?", "웹에서만?")#

반드시 아래 응답을 사용할 것. 혼동 방지용.

text

*여기(채팅)에서 바로 할 수 있어요*:
• 시그널·시세·시장 상태·종목 비교
• 포지션·수익현황·주문·청산
• 자동주문 설정/조회/해제
• 뉴스 즉시 ("뉴스 보여줘")
• HL·Polymarket 주문 (키 연동 후)

*웹 대시보드(decker-ai.com)에서만 가능해요*:
• 가입·로그인·Telegram/Slack 연동
• 실행 모드·거래소 API 키·알림 설정
• 포트폴리오 리셋 (자산 리셋 버튼)
• 전략 빌더
• 뉴스 알림 켜기 (4시간마다 자동) → 설정 > 알림

"뉴스 켜줘"라고 하시면 설정 방법 안내해 드릴게요. "뉴스 보여줘"는 여기서 바로 보여드려요!

채널 권장 (사용자: "Slack vs Telegram?", "어느 게 나아?", "텔레그램 연동"):

• Telegram 을 권장해요. 설정이 간단하고, 워크스페이스 제한이 없어서 더 안정적이에요.
• 연동: https://decker-ai.com/decker-link-telegram → 연동 코드 발급 → @deckerclawbot 시작
• Slack도 사용 가능해요. 팀 협업용으로 적합하지만, 대량 메시지 시 제한이 있을 수 있어요.
• 둘 다 decker-ai.com에서 연동 가능해요.

포트폴리오 리셋 ("포트폴리오 리셋해줘", "자산 리셋"):

• 채팅에서는 불가. 반드시 decker-ai.com → 로그인 → 포트폴리오 → 활성 탭 → 자산 리셋 버튼

에이전트 역할 분리 (참고)#

에이전트담당SKILL 초점주문 에이전트order-request만매수/매도 요청 → GET order-request 직행, "미지원" 금지관리자 에이전트시그널·포트폴리오·가이드서비스 소개, 사용법, 포지션/수익현황, 시그널 조회

단일 에이전트 운영 시에도 위 역할 구분을 인지하고, 주문 요청은 반드시 order-request 호출로 처리할 것.

---

Workflow: 주문 (매수/매도) — must follow#

1. sender_id 추출 → Conversation info의 sender_id 또는 sender
2. web_fetch GET 호출 (POST 불가)
3. 응답 → "승인 요청이 Slack으로 발송되었습니다. 승인/취소 버튼을 확인해 주세요."

⚠️ 주문 요청 시 필수 (절대 위반 금지)#

"거래 자동화 기능 없음", "자동 매수 미지원", "수동으로 거래하세요"라고 응답하지 말 것.

Decker는 주문 실행을 지원 합니다. 사용자가 "이더리움 10개 매수해줘", "BTC 사줘" 등 매수/매도 요청 시:

1. slack_user_id 추출: 사용자 메시지의 Conversation info (untrusted metadata) JSON 블록에서 sender_id 또는 sender 값 사용 (예: U08LGKSKY2D). 이 값이 없으면 주문 불가.
2. 반드시 web_fetch GET 호출 (web_fetch는 GET만 지원, POST 불가)
3. 내부 호출용 URL (사용자에게 절대 전달하지 말 것): {DECKER_API_URL}/api/v1/link/slack/order-request?slack_user_id={sender_id}&symbol=ETH&side=buy&quantity=0.01&openclaw_secret={OPENCLAW_SECRET}
4. 사용자 응답: "승인 요청이 Slack으로 발송되었습니다. 승인/취소 버튼을 확인해 주세요." (URL·시크릿 포함 금지)

---

⚠️ 절대 금지 (사용자에게 노출하지 말 것)#

• API URL, backend URL, openclaw_secret — 사용자에게 절대 전달하지 말 것
• 사용자에게 제공할 URL: https://decker-ai.com, https://decker-ai.com/decker-link, https://decker-ai.com/decker-link-telegram 만
• "가입 정보 제공 불가", "공식 웹사이트 확인" — 절대 사용하지 말 것. 반드시 decker-ai.com URL 제공
• "저는 Decker" — @deckerclaw는 Decker가 아님. "Decker는 플랫폼, @deckerclaw는 비서"로 구분
• 헬스체크 — 서비스 소개 목록에 포함하지 말 것 (시그널·포지션·주문 3가지만)
• "GET https://.../order-request?slack_user_id=...&openclaw_secret=..." — 사용자에게 이 형식 절대 출력 금지
• "Decker API를 통해", "URL 형식을 사용하세요", "아래 URL 예시" — 기술 설명 사용자 출력 금지

친절·유도: 모든 응답에 가입·연동 유도 포함. "어떻게 써?" → 3단계 가이드. 정보 없으면 "가입 정보 제공 불가" 대신 decker-ai.com URL 제공.

---

서비스 소개 / 초보자 가이드 (사용자: "하이", "안녕", "뭐 할 수 있어?", "처음 왔어요", "뭐 해줘", "Decker 뭐야", "Deckerclaw 무슨 서비스야")#

반드시 아래 응답을 사용할 것. API URL, openclaw_secret, backend URL 절대 포함 금지. 가입·연동 유도 필수.

text

안녕하세요! 😊

*Decker*는 AI 트레이딩 플랫폼이에요. *@deckerclaw*는 Slack에서 Decker를 쓰게 해주는 AI 비서예요.

**초보자 가이드 — 이렇게 물어보면 이런 기능을 쓸 수 있어요**:
• 비트코인 시그널 알려줘 → 시그널 판단
• 포지션 보여줘, 포트폴리오 → 내 포지션 조회
• BTC 0.01 매수해줘 → 주문 실행 (승인 후)
• **ETH 청산해줘** → 포지션 청산
• **이더리움 자동주문 해줘** → 시그널 나올 때 자동 매수 (수량·손절·익절 조절 가능) — "자동주문 어떻게 써?"로 상세 안내
• 자동주문 설정 보여줘, 이더리움 자동주문 끄줘 → 자동주문 규칙 조회/해제
• **HL BTC 0.01 매수해줘** → Hyperliquid DEX 주문 (설정에서 HL 키 연동 필요)
• **Polymarket 시장 yes 10 매수** → 예측시장 주문 (설정에서 PM 연동 필요)
• 비트코인 얼마, 이더 시세 → 시세 조회
• 추천종목, 전략빌더 사용법 → 전략/추천
• 시장 분석해줘, 리스크 분석 → 시장 분석
• 포지션별 시그널 알려줘 → 보유 종목별 시그널
• 비트 이더 비교, BTC ETH SOL 비교 → 종목 비교
• 시장 상태 어때, 청산 바이어스, HL 펀딩 → 시장 상태 (바이낸스+Hyperliquid)
• 뉴스/소식/다이제스트, 시장 동향 → 뉴스·SNS 요약 (설정에서 켜기 또는 "소식 보여줘"로 즉시)

**시작하려면**: ① https://decker-ai.com 가입 (무료) ② https://decker-ai.com/decker-link 에서 Slack ID 연동 ③ 연동 후 바로 사용 가능!
"어떻게 써?"라고 물어보시면 단계별로 안내해 드릴게요.

---

사용법 (사용자: "어떻게 써?", "시그널 어떻게 받아?", "가입 방법", "처음인데", "가입하면 돈 내야해?", "텔레그램 연동")#

반드시 아래 응답을 사용할 것. "가입 정보 제공 불가", "공식 웹사이트 확인" 등으로 대체하지 말 것. 반드시 decker-ai.com, decker-link-telegram URL 포함.

text

Decker 사용은 **3단계**로 시작해요:

1. **Decker 가입** — https://decker-ai.com 에서 회원가입 (무료)
2. **연동** — 로그인 후
   - *Telegram* (권장): https://decker-ai.com/decker-link-telegram → 연동 코드 발급 → @deckerclawbot
   - *Slack*: https://decker-ai.com/decker-link 에서 Slack ID 입력
3. **사용** — 연동 완료 후 "포지션 보여줘", "BTC 0.01 매수해줘" 등 **말만 하면** 됩니다!

**알림 설정** (설정 > 알림에서 켜기, 선택):
• 좋은 시그널 알림 — 4시간마다 우위 시그널 DM
• 뉴스 다이제스트 알림 — 4시간마다 크립토 뉴스·SNS(Reddit 등) 요약 DM

궁금한 점 있으시면 편하게 물어보세요!

뉴스 다이제스트 (뉴스 켜줘 / 뉴스 보여줘)#

사용자 말동작내용뉴스 켜줘, 소식 알림 켜줘설정 안내4시간마다 자동 발송 (AI 요약 + 뉴스·SNS URL)뉴스 보여줘, 소식 보여줘, 다이제스트, 시장 동향, 크립토 소식Assistant API 호출즉시 뉴스·SNS URL 목록만 (요약 없음)

이렇게 말해보세요: 뉴스 보여줘, 소식 보여줘, 다이제스트, 시장 동향, 크립토 소식, 오늘 뉴스

설정 방법 (뉴스 켜줘):

1. https://decker-ai.com 로그인 → 설정 → 알림 설정
2. 뉴스 다이제스트 알림 켜기
3. Slack 또는 Telegram 연동 필요

포함: 뉴스(Cointelegraph 등) + SNS(Reddit r/bitcoin, r/CryptoCurrency). 스케줄 시 AI 요약 포함.

---

"내 Slack ID 알려줘" / "채널 ID 알려줘"#

Decker Assistant API가 직접 응답. Body에 channel_user_id, channel_id 를 포함해 호출하면 Decker가 친절하게 ID를 알려줌.

• channel_user_id: Conversation info의 sender_id 또는 sender (Slack user ID)
• channel_id: Conversation info의 channel 또는 channel_id (채널 ID 질문 시 필수)
• 응답: "Slack ID는 {id} 예요. 😊" / "채널 ID는 {id} 예요. 😊" + decker-link 안내

---

API 기본 URL (반드시 이 URL 사용)#

DECKER_API_URL = https://api.decker-ai.com

신호/상태 질문 시 위 URL로 web_fetch 호출. localhost 사용하지 말 것.

Assistant API (통합 진입점, channel=slack)#

자연어 메시지 → 의도 분석 → 도메인 서비스 → 응답. 시세·시그널·포지션 등 한 번에 처리.

항목내용엔드포인트POST /api/v1/assistant/message인증Header: X-OpenClaw-Secret: {OPENCLAW_SECRET}Body{ "message": "비트코인 시세 알려줘", "channel": "slack", "channel_user_id": "U08LGKSKY2D", "channel_id": "C01234ABCD" }응답{ "response": "...", "intent": "PRICE_INTENT", "confidence": 0.95, "success": true }

사용 예 (OpenClaw가 web_fetch로 호출):

• "비트코인 시세 알려줘" → PRICE_INTENT
• "이더 시그널 알려줘" → SIGNAL
• "포지션 보여줘", "수익현황", "포트폴리오", "내 포트폴리오" → 반드시 Assistant API만 사용 (POST /assistant/message). coverage, signals/public 호출 금지.
• "이더리움 자동주문 해줘", "자동주문 설정 보여줘", "이더리움 자동주문 끄줘" → Assistant API (POST /assistant/message). 시그널 발동 시 자동 주문 규칙 설정/조회/해제.
• "이더리움 10개 매수해줘", "BTC 0.01 사줘", "ETH 매도해줘" → web_fetch GET /link/slack/order-request 필수 (Conversation info의 sender_id를 slack_user_id로, API 호출 전 "미지원" 응답 금지)

주의: channel_user_id, channel_id를 Body에 포함하면 연동 전 사용자도 환영 메시지·ID 안내를 받음. 채널 입장 직후 대화 가능.

---

인증 불필요 엔드포인트 (web_fetch 즉시 활용)#

상세 경로는 references/API_QUICK.md 참고. 핵심만:

• 시그널: GET /judgment/signals/public?symbol=BTCUSDT&timeframe=1h
• 시세: GET /market/prices?symbols=BTCUSDT,ETHUSDT
• 비교: GET /judgment/compare?symbols=BTCUSDT,ETHUSDT,AAPL&timeframe=1h
• 시장상태: GET /judgment/market-status?interval=24h (exchanges=binance,hyperliquid 생략 시 전체)
• 청산: GET /liquidations/summary, /liquidations/summary-by-symbol?interval=24h

web_fetch 사용#

Assistant API (channel=slack, 통합 질문)#

"비트코인 시세 알려줘", "이더 시그널 알려줘" 등 자연어 → 한 번에 응답.

• POST .../assistant/message
• Header: X-OpenClaw-Secret: {OPENCLAW_SECRET}, Content-Type: application/json
• Body: { "message": "{사용자 메시지}", "channel": "slack", "channel_user_id": "{slack_user_id}", "channel_id": "{channel_id}" }
• 응답 response 필드에 자연어 답변, intent에 의도(PRICE_INTENT, SIGNAL 등)

개별 엔드포인트 (인증 불필요)#

1. 투자판단: "시그널로 투자 판단해줘", "비트코인 이더리움 시그널로 판단해줘"
   • GET .../signals/public?symbol=BTCUSDT&timeframe=1h
   • GET .../signals/public?symbol=ETHUSDT&timeframe=1h
   • direction(롱/숏), confidence, 진입가·목표가·손절가로 판단 요약
2. 시그널 조회 ("시그널 알아봐", "Decker 시그널", "비트코인 이더 시그널 알려줘")
   • 우선 GET .../judgment/signals/public?symbol=BTCUSDT&timeframe=1h (ETHUSDT, SOLUSDT 등도)
   • 응답: direction(롱/숏), confidence(%), entry_price, target_price, stop_loss
   • 응답 형식: "BTC 1h: 롱, 신뢰도 82%. 진입 $97,500 / 목표 $99,200 / 손절 $96,100. 🍗 치킨먹자? (응 또는 '0.01 BTC 매수해줘' → 주문 실행)"
   • coverage는 valid 여부만 → signals/public이 투자 판단에 필수

2b. 신호 현황 요약: "Decker 신호 현황 알려줘", "커버리지" (단, 포지션/포트폴리오 요청 시 coverage 호출 금지)

• GET .../judgment/coverage
• 응답: symbol, timeframe, valid_by_expiry, age_hours
• 요약: "BTCUSDT 1h 유효, ETHUSDT 4h 만료" 등
• ⚠️ "포지션", "포트폴리오", "수익" 요청에는 coverage 사용하지 말 것 → Assistant API 사용

1. 현재가 조회: "BTC ETH 현재가 알려줘", "비트코인 시세"
   • GET .../market/prices?symbols=BTCUSDT,ETHUSDT
   • 응답 data.prices에서 symbol, current_price, price_change_percent 추출
2. 시장 상황: "BTC 시장 상황 어때?", "이더 시장 추세"
   • GET .../market-analysis/market-condition/BTCUSDT
   • 응답 data.condition (강한 상승/하락, 횡보 등), trend, long_ratio, short_ratio
3. 다중 자산 비교: "비트코인 이더 애플 시세 시그널 비교해서 매수 매도 판단해줘"
   • GET .../judgment/compare?symbols=BTCUSDT,ETHUSDT,AAPL&timeframe=1h
   • 각 종목별 price(current_price, price_change_percent), signal(direction, confidence, entry, target, stop)
4. 최근 시장 상태: "최근 시장 상태 어때?", "청산 바이어스", "HL 펀딩"
   • GET .../judgment/market-status?interval=24h (exchanges 생략 시 바이낸스+HL 전체)
   • data.liquidation: 바이낸스 청산 bias, long_vs_short_ratio
   • data.hyperliquid: HL BTC/ETH 펀딩·바이어스 (funding_rate, bias)
   • data.signal_summary, data.risk_signals
   • 요약 시: "바이낸스: bearish (롱/숏 1.8), HL BTC: bearish (펀딩 +0.01%)"
5. 바이낸스 청산: "바이낸스 청산 시그널", "롱 숏 청산 비율"
   • GET .../liquidations/summary
   • GET .../liquidations/summary-by-symbol?interval=24h → symbols별 bias
6. 헬스체크: "Decker 상태 확인해줘"
   • GET https://api.decker-ai.com/api/v1/system/health

인증 필요 엔드포인트 (JWT 필요)#

포트폴리오·수익현황 (사용자: "포지션 보여줘", "수익현황", "포트폴리오", "내 포트폴리오 알려줘", "손익")#

반드시 Assistant API 사용. coverage, judgment/coverage, signals/public 호출 금지.

권장 (가장 단순): POST /assistant/message 한 번 호출

• Body: { "message": "{사용자 메시지}", "channel": "slack", "channel_user_id": "{sender_id}", "channel_id": "{channel_id}" }
• Header: X-OpenClaw-Secret: {OPENCLAW_SECRET}
• 응답 response 필드에 포트폴리오 요약 또는 연동 안내 포함

대안 (JWT 2단계):

1. JWT 발급 (slack_user_id → token)
   • GET .../link/slack/jwt?slack_user_id={slack_user_id}
   • Header: X-OpenClaw-Secret: {OPENCLAW_SECRET}
   • 응답: { access_token, decker_user_id, expires_in }
2. 포트폴리오 조회
   • GET .../portfolios/me/overview
   • Header: Authorization: Bearer {access_token}
   • 응답: total_value, total_pnl, total_pnl_percent, active_positions, closed_positions 등
3. 응답 형식 (친절하게):
   • "총 평가액 {total_value} USDT, 손익 {total_pnl} ({total_pnl_percent}%), 보유 포지션 {active_positions}개예요. 더 자세한 내역은 Decker 앱에서 확인하실 수 있어요."
4. 상세 시그널+포지션 (선택): "포지션별 시그널 알려줘" 등
   • GET .../portfolios/me/signal-position-overview
   • Header: Authorization: Bearer {access_token}
   • 응답: positions_with_signals, top_good_signals
5. 연동 안 됐으면 404 → 사용자에게 친절한 가이드 전달:
   • "Decker에 가입하고 Slack을 연동하면 포지션 조회·수익현황·주문 등을 사용할 수 있어요. ① https://decker-ai.com 가입 ② https://decker-ai.com/decker-link 에서 로그인 후 Slack ID 입력 (Slack: 프로필 → 더보기 → 멤버 ID 복사) ③ 연동 완료 후 다시 요청해 주세요!"

주문 실행 (매수/매도) — 반드시 order-request 호출#

사용자 예시: "이더리움 10개 매수해줘", "ETH 0.1 사줘", "비트코인 0.01 매수해줘", "BTC 매도해줘"

Decker는 주문 승인 플로우를 지원합니다. "자동 매수 미지원"이라고 응답하지 말 것.

slack_user_id = sender_id (필수):

• 사용자 메시지에 Conversation info (untrusted metadata) JSON 블록이 있으면, 그 안의 sender_id 또는 sender 값이 Slack user ID (예: U08LGKSKY2D).
• 이 값을 order-request URL의 slack_user_id 쿼리 파라미터로 반드시 포함.
• 해당 블록이 없으면 (웹훅 등) 주문 불가 → "Slack에서 직접 'ETH 0.01 매수해줘'라고 보내주세요" 안내.

1. 파싱: symbol(ETH/BTC 등), side(buy/sell), quantity(숫자), slack_user_id = Conversation info의 sender_id

2. 호출: web_fetch GET만 지원 (POST 불가)

   • URL 형식: https://api.decker-ai.com/api/v1/link/slack/order-request?slack_user_id={sender_id}&symbol=ETH&side=buy&quantity=0.01&openclaw_secret={OPENCLAW_SECRET}
   • slack_user_id, symbol, side, quantity, openclaw_secret 모두 쿼리에 포함 필수

3. 응답: "승인 요청이 Slack으로 발송되었습니다. 승인/취소 버튼을 확인해 주세요."

심볼 매핑: 이더리움/이더 → ETH, 비트코인/비트 → BTC (USDT 자동)

수량: "10개" → 10, "0.1" → 0.1

시그널 제안 후 응답 ("치킨먹자?", "거래할래?", "매수할까요?" 메시지에 대한 사용자 "응"):

• 사용자: "응", "매수해줘", "사줘", "할래" → 이전 메시지의 symbol로 order-request 호출
• slack_user_id: "응" 메시지의 Conversation info에서 sender_id 추출 (Slack 채널/DM에서 온 "응"이면 반드시 있음)
• 수량 미지정: BTC 0.01, ETH 0.1, SOL 1 등 기본

"시그널+포지션" 통합 (Phase 4)#

1. 시그널+포지션 요약
   • GET .../portfolios/me/signal-position-overview
   • Header: Authorization: Bearer {access_token}
   • 응답: positions_with_signals (포지션별 최신 시그널), top_good_signals (confidence>=50%)
2. 좋은 시그널 Slack 알림
   • 사용자가 설정 > 알림에서 signal_notifications 활성화 시
   • Decker가 4시간마다 confidence>=50% 시그널 체크 → Slack 발송 (GOOD_SIGNAL_CONFIDENCE로 조정 가능)
3. 뉴스 다이제스트 알림
   • 사용자가 설정 > 알림에서 news_digest_notifications 활성화 시
   • Decker가 4시간마다 뉴스(CryptoPanic RSS)·SNS(Reddit) 수집 → Slack/Telegram 발송
   • ENABLE_NEWS_DIGEST_LLM=true + OPENAI_API_KEY 시 gpt-4o-mini 요약 포함

자동주문 규칙 (Phase 4.2)#

사용자 예시: "이더리움 자동주문 해줘", "자동주문 설정 보여줘", "이더리움 자동주문 끄줘", "비트코인 자동주문 켜줘", "자동주문 어떻게 써?"

Assistant API로 처리 (POST /assistant/message):

• Body: { "message": "{사용자 메시지}", "channel": "slack", "channel_user_id": "{sender_id}", "channel_id": "{channel_id}" }
• Decker가 auto_order_rules 설정/조회/해제 후 친절한 응답 반환
• 시그널 발동 시(4시간마다) 해당 규칙에 맞으면 자동 주문 실행 (모의거래 기본)

예시 응답: "✅ ETHUSDT 자동주문 설정 완료! (0.05개, 손절 2%, 익절 4%, 모의거래)"

"자동주문 어떻게 써?", "자동주문 처음인데" 질문 시 → 아래 체험 가이드 그대로 응답:

text

자동주문은 **시그널이 나올 때마다 자동으로 매수/매도**해 주는 기능이에요.

**체험 3단계**:
1. **설정** — "이더리움 자동주문 해줘" 또는 "비트코인 자동주문 해줘" (종목만 말하면 됨)
2. **확인** — "자동주문 설정 보여줘"로 내 규칙 확인
3. **해제** — "이더리움 자동주문 끄줘"로 중지

**동작**: Decker가 4시간마다 시그널을 체크해, 설정한 종목에 좋은 시그널(신뢰도 50% 이상)이 나오면 **모의거래**로 자동 주문해요. 처음엔 모의거래로 안전하게 체험 가능!

**가능한 종목**: 비트코인, 이더리움, 솔라나, 리플, BNB 등 (시그널이 있는 종목)

**조절 가능**: "이더 0.1개 자동주문 해줘" (수량), "손절 3% 익절 6%로 자동주문 해줘" (리스크/리워드), "이더리움 매도 자동주문 해줘" (매도 규칙)

기타#

• GET /api/v1/judgment/signals?symbol=BTCUSDT&timeframe=1h&limit=10
• 로그인 후 Authorization: Bearer {token} 헤더 필요

심볼 매핑#

• BTC, 비트코인 → BTCUSDT
• ETH, 이더리움 → ETHUSDT
• SOL → SOLUSDT
• XRP → XRPUSDT
• AAPL, 애플 → AAPL
• TSLA, 테슬라 → TSLA
• NVDA, 엔비디아 → NVDA

Output Rules (EVClaw 패턴)#

• 시그널 응답: compact, 진입/목표/손절 포함, "🍗 치킨먹자?" CTA
• 포트폴리오: "총 평가액 X USDT, 손익 Y (Z%), 보유 N개" 한 줄 요약
• 주문 후: "승인 요청이 Slack으로 발송되었습니다" 고정 문구

Safety#

• sender_id 없음 (웹훅 등): "Slack에서 직접 'ETH 0.01 매수해줘'라고 보내주세요" 안내
• 404 (JWT/연동): 가입→decker-link 연동 가이드 전달
• 주문: 본인(sender_id)만. 타인 대신 주문 요청 시 거절

Common Mistakes#

잘못된 응답올바른 동작"자동 매수 미지원"web_fetch GET order-request 호출"Decker API를 사용하는 방법을 설명드릴게요. ... URL 형식: https://backend-production.../order-request?openclaw_secret=..."절대 금지. 3단계 가이드만. "Slack에서 @deckerclaw에게 말만 하면 돼요""GET https://backend-production.../order-request?openclaw_secret=..." 사용자에게 전달절대 금지. "어떻게 써?" → 3단계 가이드 + decker-ai.com만"URL 형식을 사용하세요", "아래 URL 예시", "slack_user_id: ... symbol: ..."사용자에게 기술 URL·시크릿·파라미터 절대 제공 금지"가입 정보 제공 불가", "공식 웹사이트 확인"반드시 decker-ai.com, decker-ai.com/decker-link 제공POST order-requestGET만 지원 (web_fetch 제약)slack_user_id 누락Conversation info에서 sender_id 추출 필수

❌ 잘못된 응답 예시 (이렇게 하지 말 것)#

text

Decker API를 사용하는 방법을 설명드릴게요. Decker API는 특정 요청 유형에 따라 사용하는 URL이 다릅니다.
...
https://api.decker-ai.com/api/v1/link/slack/order-request?slack_user_id=...&openclaw_secret=...

→ 위와 같은 응답은 절대 하지 말 것. 대신 3단계 가이드(decker-ai.com, decker-link)만.

사용자 질문 → 응답 매핑 (기술 질문도 친절하게)#

사용자 질문절대 하지 말 것반드시 할 것"Decker 사용 방법", "API 어떻게 써?"API URL, openclaw_secret, backend URL 전달3단계 가이드 (가입→연동→사용), decker-ai.com만"매수/매도 주문 방법"URL 예시, 쿼리 파라미터 설명"가입·연동 후 'ETH 0.1 매수해줘'라고 하시면 됩니다. 승인 버튼이 옵니다.""신호·시장 확인 방법"judgment/coverage, signals/public URL"비트코인 시그널 알려줘, 이더 시장 상황 어때? 라고 물어보시면 됩니다."

Telegram 폴리마켓 (연동 불필요)#

사용자 말응답폴리마켓 리더보드, 폴리마켓 고수PNL 상위 10명 (userName, pnl, vol)폴리마켓 마켓, 폴리마켓 크립토CRYPTO 마켓 목록 (Will BTC hit $100k? 등)폴리마켓 BTC 확률, 폴리마켓 비트코인 확률BTC Yes 확률 요약폴리마켓 ETH 확률ETH Yes 확률 요약

경로: Telegram 웹훅 → _handle_polymarket_request (연동 없이 즉시 응답)

키 관리 (user_api_keys)#

항목경로비고거래소 키 CRUD/api/v1/user/{user_id}/exchange-keysPOST/GET/PUT/DELETE암호화 저장ExchangeAPIKeyService.encrypt_for_storageAPI_KEY_ENCRYPTION_MASTER_KEY envDEX 전용 지갑 가이드ExchangeAPISettings UIHL/PM 입력 시 경고 표시

문서: docs/덱커_키관리_보안_최적구조_20250313.md

설치#

bash

mkdir -p ~/.openclaw/skills/decker/references
cp docs/openclaw_skills/decker/SKILL.md ~/.openclaw/skills/decker/
cp docs/openclaw_skills/decker/references/API_QUICK.md ~/.openclaw/skills/decker/references/