Crypto 키 (Binance/Bybit/OKX)
ExchangeKeyTabs의 첫 번째 탭(amber). Binance, Bybit, OKX 중 하나를 선택해 API 키를 등록합니다.
📸 Crypto 키 등록 폼 (추후 자동 캡처 예정)
필수 입력
| 필드 | 설명 | 비고 |
|---|---|---|
| Exchange | 거래소 select | Binance / Bybit / OKX |
| API Key | 거래소 발급 키 | text |
| API Secret | 거래소 발급 시크릿 | password (암호화 저장) |
| Label | 사용자 식별 라벨 | 기본 default |
Paper 모드 강제
현재 UI는 모든 신규 Crypto 키를 paper 모드 잠금으로 등록합니다.
┌───────────────────────────┐
│ amber Paper mode 배지 │
│ Live keys arrive in P4-01. │
└───────────────────────────┘
라이브 활성화는 /api-reference/equity-live request_confirm → enable 흐름을 거쳐야 합니다.
연결 테스트 미지원
CCXT는 단순 balance 호출이 의미 있는 검증이 되지 않으므로 (실 주문 시점에 검증), Crypto 폼은 Test Connection 버튼이 의도적으로 없습니다. 첫 주문 호출 시 자동 검증됩니다.
API 호출
curl -s -X POST -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
http://localhost:8000/api/exchange-keys \
-d '{
"asset_class": "crypto",
"exchange": "binance",
"api_key": "abcdef...",
"api_secret": "uvwxyz...",
"paper_mode": true,
"label": "default"
}'
응답:
{
"id": 12,
"asset_class": "crypto",
"exchange": "binance",
"label": "default",
"api_key_masked": "abcd…wxyz",
"paper_mode": true,
"created_at": "2026-04-26T01:00:00Z"
}
등록된 키 목록
폼 하단의 Registered keys 섹션은 모든 자산군의 등록 키를 함께 보여줍니다.
| 표시 | 의미 |
|---|---|
| 자산군 배지 | 매핑된 자산군 |
binance · default | exchange · label |
abcd…wxyz | API key prefix/suffix만 노출 (Fernet 암호화) |
| paper / live 배지 | 모드 |
| Trash 아이콘 | 키 삭제 |
절대 룰
저장 후 API secret은 영구히 다시 보이지 않습니다. 잃어버리면 거래소에서 새로 발급해야 합니다.
your_api_key_here, <your-api-key> 같은 placeholder 문자열은 거래소에서 401을 발생시킵니다. 실제 키만 입력하세요 (feedback_env_placeholder).
자주 묻는 질문
Q. IP whitelist는?
A. Binance/Bybit/OKX 공통으로 거래소 측 IP whitelist 설정을 권장합니다. quant-ai 서버 IP를 등록하세요.
Q. Withdraw 권한이 필요한가요?
A. 절대 활성화하지 마세요. trade only로 충분합니다.
Q. Bybit unified vs spot 어느 쪽?
A. 현재 spot 우선 지원. Unified margin은 후속 작업.