OKX 현물 거래에 대한 API 권한을 관리하는 방법은 무엇입니까?

현물 거래를 위한 API 권한 구성

1. 신원 확인을 완료한 후 OKX 계정 대시보드 내의 API 관리 섹션에 액세스하세요.

2. “API 키 생성”을 클릭하고 현물 거래 작업에 필요한 특정 권한을 선택하세요.

3. 잔액 정보, 주문 내역 및 시장 데이터를 검색하려면 "읽기" 권한을 활성화합니다.

4. 지원되는 모든 거래 쌍에 대해 현물 주문을 작성, 취소 및 수정하려면 "거래" 권한을 활성화하세요.

5. 명시적으로 필요한 경우가 아니면 "출금"을 활성화하지 마십시오. 현물 실행과 관련 없이 보안 위험이 높아지기 때문입니다.

IP 화이트리스트 및 인증 강화

1. 현물 거래에 사용되는 각 API 키에 고정 IPv4 또는 IPv6 주소(또는 CIDR 서브넷)를 할당합니다.

2. 거래 관련 요청을 시작하기 전에 IP 바인딩이 활성화되어 있는지 확인하십시오. 거래 허가가 있는 바인딩되지 않은 키는 14일 동안 활동이 없으면 만료됩니다.

3. 타임스탬프, HTTP 메서드, 요청 경로 및 본문 해시를 통합하여 모든 개인 끝점 호출에 HMAC-SHA256 서명을 사용합니다.

4. 비밀 키와 별도로 암호 를 저장하고 스택 추적에 기록되거나 노출되지 않도록 하세요.

5. API 키를 분기별로 교체하고 API 관리 인터페이스를 통해 더 이상 사용되지 않는 키를 즉시 취소합니다.

현물 주문 실행 제약

1. 우발적인 마진 또는 자금 모드 활성화를 방지하려면 모든 현물 주문 페이로드에 tdMode = 'cash'를 지정하십시오.

2. 주문을 제출하기 전에 OKX의 상품 메타데이터에 대해 가격 및 크기 정밀도를 검증합니다. BTC-USDT에는 0.01의 가격 정밀도와 0.00000001의 크기 정밀도가 필요합니다.

3. ordType = 'limit' 또는 'market'을 명시적으로 설정합니다. 이 필드를 생략하면 환경 전반에 걸쳐 일관되지 않은 기본 동작이 트리거됩니다.

4. 클라이언트 측 주문 추적을 위해 clOrdId를 포함하고 세션 전반에 걸쳐 식별자를 재사용하지 마십시오.

5. 잘못 구성된 현물 제출에서 흔히 발생하는 50113 (서명 불일치) 및 58007 (경매 범위를 벗어난 가격 편차)과 같은 응답 코드를 모니터링합니다.

OKX 데모 환경을 사용한 테스트 워크플로

1. 테스트넷 도메인에 플래그=1로 별도의 API 키를 등록하여 실제 잔액에서 시뮬레이션 트래픽을 분리합니다.

2. KYC 요구 사항 없이 OKX 수도꼭지를 사용하여 데모 계좌에 자금을 조달하세요. 각 할당은 72시간 후에 만료됩니다.

3. 테스트넷과 프로덕션 모두에서 동일한 현물 주문 논리를 실행하여 대기 시간, 거부율 및 채우기 확인 시간을 비교합니다.

4. GET /api/v5/trade/orders-history-archive가 환경 간에 일관된 페이지 매김 구조를 반환하는지 확인합니다.

5. books50-l2-tbt 채널에 대한 WebSocket 구독이 인증 오류 없이 실시간 깊이 업데이트를 제공하는지 확인합니다.

EU 사용자를 위한 MiCA 호환 API 거버넌스

1. OKX European Ltd는 2025년 1월 27일 현재 EEA 30개 관할권 전체에 걸쳐 완전한 MiCA 인증을 보유하고 있습니다.

2. EU 기반 API 키는 자동으로 더 엄격한 속도 제한을 적용합니다. 즉, 전역 기본값인 20개 요청 대신 초당 15개 요청입니다.

3. 거래 엔드포인트는 X-MiCA-Jurisdiction 및 X-Compliance-Level을 포함한 추가 규제 헤더를 반환합니다.

4. 모든 현물 주문 확인에는 기본 자산의 MiCA 등록 상태와 연결된 변경 불가능한 준수ReferenceId가 포함됩니다.

5. MiCA 규정 준수 포털을 통해 명시적으로 활성화하지 않는 한 출금 관련 엔드포인트는 EU 키에 대해 비활성화된 상태로 유지됩니다.

자주 묻는 질문

Q: 현물 거래와 선물 거래에 동일한 API 키를 사용할 수 있나요? 예. 하지만 생성하는 동안 두 instType 카테고리 모두에 대해 "거래" 권한이 활성화된 경우에만 해당됩니다. 감사의 명확성을 위해 별도의 키를 사용하는 것이 좋습니다.

Q: 현물 주문이 오류 코드 58000을 반환하는 이유는 무엇입니까? 이는 요청한 상품이 거래가 일시 중지되었음을 나타냅니다. OKX의 공식 계측기 상태 페이지를 확인하거나 instType=SPOT을 사용하여 GET /api/v5/public/instruments를 호출하세요.

Q: 암호는 대소문자를 구분합니까? 예. OKX는 SHA-256 해시를 저장하며 대소문자 변형이 있으면 잘못된 서명이 생성됩니다.

Q: 내 API 키가 손상되었는지 어떻게 확인합니까? API Management에서 “최근 활동” 탭을 검토하세요. 인식되지 않는 IP, 예상치 못한 출금 시도 또는 주문 취소량 급증 신호 노출.