자주 묻는 질문
Q1: 주소를 화이트리스트에 추가한 후에도 출금할 수 없는 경우
원인:
1. 출금 페이지의 화이트리스트와 API 출금 화이트리스트는 서로 독립적입니다.
2. [출금 페이지] > [출금 주소 관리]를 통해 추가된 주소는 API 출금에 적용되지 않습니다.
해결책:
- API 출금 화이트리스트 관리 페이지 방문: https://www.coinex.com/apikey
- 출금 주소를 API 전용 화이트리스트에 추가하세요.
Q2: access_id not exist 오류
일반적인 원인:
(1) 새로 생성된 API 키는 일반적으로 활성화되는 데 약 10분이 소요됩니다. 생성 직후 API를 호출하면 이 오류가 발생할 수 있습니다.
(2) 잘못된 access_id.
(3) 유효하지 않은 서명 인증.
(4) 잘못된 요청 헤더.
해결책:
(1) [CoinEx API 문서]를 참조하여 HTTP 인증 요청을 구성하는 방법을 알아보세요.
(2) 데모:
Q3: 3008/4001 service unavailable 오류
원인: 이 오류는 서버 부하가 높은 기간 동안 주문을 취소할 때 발생할 수 있습니다.
해결책:
(1) 중요한 주문 취소를 우선시하세요.
(2) 1-2초 후에 다시 시도하세요.
(3) 응답이 code: 0을 반환하지만 주문이 취소되지 않는 경우:
- 완전한 요청과 응답을 기록하세요.
- 고객 지원에 문의하고 메인/서브 계정 정보를 제공하여 도움을 받으세요.
Q4: 파라미터 오류
원인: 이는 일반적으로 업로드된 파라미터가 API 문서에 지정된 유형과 일치하지 않을 때 발생합니다.
해결책: POST /spot/cancel-order 엔드포인트를 예로 들면:
(1) API 문서의 파라미터 이름과 유형을 엄격하게 비교하세요.
(2) 숫자 유형과 문자열 유형의 차이에 특히 주의하세요.
Q5: API 속도 제한은 무엇인가요?
속도 제한은 단기 속도 제한과 장기 속도 제한으로 나뉘며, 응답 헤더를 통해 식별할 수 있습니다:
1. 단기 속도 제한: X-RateLimit-Limit 값이 0보다 크면 단기 속도 제한이 트리거되지 않았습니다.
단기 제한은 토큰 버킷 메커니즘을 사용하며, 메인 계정과 서브 계정에 대해 독립적인 속도 제한이 있습니다.
- 트리거 후 일반적인 오류: Code: 213, 4213
- 메시지: Please don't try too frequently.
2. 장기 속도 제한: X-RateLimit-LongPeriod-{period}-Remaining이 반환되면 장기 속도 제한이 트리거되었습니다. 시스템은 사용자의 요청 볼륨과 품질을 평가하여 더 긴 기간 동안 요청 총량에 제한을 부과할지 결정합니다. 트리거 후, 모든 엔드포인트(주문 취소 제외)에 대한 요청 속도는 초당 1개 요청으로 제한됩니다.
- 일반적인 오류: Code: 213, 4213
- 응답 헤더를 통한 추가 판단이 필요합니다.
기타 일반적인 질문
Q1: API 요청 지연 시간을 줄이는 방법은?
서버는 AWS 도쿄에 배포되어 있으며 지역 간 로드 밸런싱을 지원합니다. 지연 시간을 최소화하기 위해 가까운 지역을 선택할 수 있습니다.
사용 가능한 영역:
- ap-northeast-1a
- ap-northeast-1c
- ap-northeast-1d
Q2: API 출금에 2FA가 필요한가요?
보안상의 이유로:
1. API 출금을 사용하기 전에 로그인하고 2FA를 통해 인증해야 합니다.
2. [출금 화이트리스트]에 출금 주소를 추가한 후에는 추가 2FA 인증 없이 API 출금을 시작할 수 있습니다.
Q3: API를 통해 출금 화이트리스트 주소를 추가할 수 있나요?
현재 API를 통한 출금 화이트리스트 주소 추가는 지원되지 않습니다. [API 관리] > [출금 화이트리스트]로 이동하여 수동으로 또는 일괄적으로 주소를 추가하세요.
Q4: 서명 오류
해결책:
1. access_id와 secret_key가 올바르게 구성되어 있는지 확인하세요.
2. 요청 본문과 서명 생성에 사용된 파라미터가 동일한지 확인하세요. 요청 파라미터를 문자열로 전처리하고 서명 전후의 일관성을 확인하세요.
3. 서명에 타사 라이브러리를 사용하는 경우 올바르게 구성되어 있는지 확인하세요.
Q5: Tonce check error - Correct tonce should be within one minute of the current time
해결책:
(1) 모든 API 요청의 타임스탬프가 밀리초 단위인지 확인하세요.
예시:
(2) 컴퓨터에서 자동 시간 동기화가 활성화되어 있는지 확인하세요.
Q6: 선물 계정의 실제 사용 가능한 잔액과 순 가치를 검색하는 방법은?
(1) /assets/futures/balance 엔드포인트를 사용하여 available 필드를 검색하세요. 이는 선물 계정의 현재 사용 가능한 잔액을 나타냅니다.
(2) API 엔드포인트는 현재 계정의 순 가치 반환을 지원하지 않습니다. 순 가치는 실현 및 미실현 손익의 합계입니다.
(3) 미실현 손익은 고정 값이 아니며 포지션 변화에 따라 변동할 수 있습니다. 정확한 결과를 위해서는 수동 계산이 필요합니다.
(4) 계산 공식은 "선형 계약 계정 수입 및 PNL 계산 방법" 문서를 참조하세요.
Q7: WebSocket API에서 반환된 데이터를 처리하는 방법은?
WebSocket API는 압축된 JSON 문자열 형식으로 데이터를 반환하므로, 사용하기 전에 압축을 해제해야 합니다(예: gzip 모듈 사용).
일반적인 오류:
utf-8 codec can't decode byte 0x8b in position 1: invalid start byte
Q8: 타사 세금 플랫폼에서 오류가 보고되면 어떻게 해야 하나요?
V1 서비스는 2024년 9월 25일에 중단되었습니다. 오류는 플랫폼이 코드를 V2로 업그레이드하지 않아 발생했을 수 있습니다. 도움이 필요하시면 관련 세금 플랫폼에 문의하세요.
Q9: WebSocket 연결이 성공적으로 이루어졌는지 어떻게 확인할 수 있나요?
구독에 성공하면 구독 결과 응답을 받게 됩니다.
이후 구독한 메시지 업데이트를 받게 됩니다:
Q10: WebSocket 연결이 자동으로 끊어지는 이유는 무엇인가요? 연결을 유지하려면 어떻게 해야 하나요?
(1) WebSocket 연결 끊김은 주로 네트워크 문제로 인해 발생합니다. 네트워크 연결이 안정적인지 확인하세요.
(2) WebSocket 연결을 유지하려면 server.ping을 사용하여 연결을 활성 상태로 유지해야 합니다.
(3) 1분 동안 서버와 통신이 없으면 WebSocket 연결이 자동으로 끊어집니다. 연결을 활성 상태로 유지하기 위해 ping 인터페이스를 통해 60초 이내의 전송 간격을 설정하는 것이 좋습니다.
기타 API 오류에 대해서는 여기를 클릭하여 고객 지원에 문의하고 문제 해결을 위해 다음 정보를 제공해 주세요:
(1) 메인 계정의 이메일 또는 서브 계정의 사용자 이름.
(2) 완전한 요청 및 응답 세부 정보.
중요: 불필요한 손실을 방지하기 위해 오류 메시지에 access_id와 secret_key를 공유하지 마세요.