OKX에서 과거 선물 주문을 보는 방법

OKX 웹 인터페이스를 통해 과거 선물 주문에 접근하기

1. OKX 계정에 로그인하고 선물 거래 섹션으로 이동합니다.

2. 거래 인터페이스 상단에 있는 주문 탭을 클릭하세요.

3. 내역 하위 탭을 선택하여 완료, 취소 및 만료된 선물 주문을 표시합니다.

4. 날짜 범위 필터를 사용하여 검색의 시작 및 종료 타임스탬프를 지정합니다. 기본 기간은 지난 90일입니다.

5. BTC-USDT-SWAP 또는 ETH-USDT-QUARTER와 같은 상품 필터를 적용하여 계약 유형 및 기초 자산별로 결과를 좁힙니다.

REST API를 통해 선물 주문 내역 검색

1. 유효한 자격 증명을 사용하여 python-okx 에서 TradeAPI 클래스를 초기화하고 프로덕션 환경에 대해 flag='0' 을 설정합니다.

2. get_orders_history_archive 메소드를 호출하여 instType='SWAP' , instId='BTC-USDT-SWAP' 및 limit=100 포함한 매개변수를 전달합니다.

3. before 매개변수를 사용하여 응답을 통해 페이지를 매깁니다. 값은 각 배치에서 가장 오래된 레코드의 ordId 필드에서 추출됩니다.

4. 반환된 JSON 구조를 구문 분석합니다. 각 항목에는 ordId , px , sz , side , state , fillSz , avgPx 및 ts (밀리초 타임스탬프)가 포함되어 있습니다.

5. 기본 내림차순 정렬을 반대로 한 후 원시 응답을 시간순으로 저장한 다음 연속 페이지에서 ts 값의 간격을 확인하여 완전성을 검증합니다.

데이터 무결성 및 시간 범위 제약

1. OKX는 웹 인터페이스에서 최대 180일 동안 선물 주문 내역을 보관하지만, 기관 계층 계정의 경우 API 액세스가 365일 까지 연장됩니다.

2. 90일보다 오래된 레코드에는 명시적인 instType 사양이 필요합니다. 이를 생략하면 instId 제공되는 경우에도 빈 데이터가 반환됩니다.

3. state 필드에는 filled , cancelled , partial_filled , expired , failed 와 같은 값이 포함됩니다. 실패는 마진이 부족하거나 매개변수가 잘못되어 주문이 거부되었음을 나타냅니다.

4. 타임스탬프는 항상 UTC이며 일광 절약 시간제에 맞춰 조정되지 않습니다. 현지 시간 변환은 Python에서 datetime.timezone.utc 를 사용하여 클라이언트 측에서 처리되어야 합니다.

5. 주문 ID는 ORD 라는 접두사와 그 뒤에 18개의 영숫자가 붙은 불변의 문자열입니다. 배치 전체에 걸쳐 숫자 순서가 보장되지는 않습니다.

과거 주문 검색 중 일반적인 함정

1. get_orders_history_archive 대신 get_orders_history 사용하면 페이지 매김 시도에 관계없이 최근 90일만 생성됩니다.

2. 존재하지 않는 ordId 또는 365일보다 오래된 값 등 유효하지 않은 before 값을 전달하면 오류 코드 50015 ('잘못된 이전 매개변수')가 트리거됩니다.

3. instId 지정하는 동안 instType 생략하면 명시적인 유효성 검사 오류가 발생하는 대신 빈 data 배열과 함께 HTTP 200이 반환됩니다.

4. flag='1' (데모 모드)을 생산 instId 값과 혼합하면 자동 불일치가 발생합니다. 데모 모드에서 접수된 주문은 실제 계정 내역 엔드포인트에 나타나지 않습니다.

5. 체결된 주문에 대해 fillSz sz 와 같다고 가정하면 청산으로 인해 발생한 부분 체결이 무시됩니다. 여기서 fillSz 연속적인 시장 영향으로 인해 원래 sz 초과할 수 있습니다.

자주 묻는 질문

Q: API 키 없이 과거 선물 주문을 검색할 수 있나요? 아니요. /api/v5/trade/orders-history-archive 아래의 모든 엔드포인트에는 OK-ACCESS-KEY , OK-ACCESS-SIGN , OK-ACCESS-TIMESTAMP 및 OK-ACCESS-PASSPHRASE 포함한 전체 인증이 필요합니다. 공개 엔드포인트는 주문 내역을 공개하지 않습니다.

Q: orders-history 과 orders-history-archive 응답 모두에 동일한 ordId 나타나는 이유는 무엇입니까? 이는 주문이 지난 90일 이내에 이루어졌으며 보관 보존 자격을 갖춘 경우에 발생합니다. 시스템은 이중 인덱싱을 유지하지만 중복되는 레코드에 대해 두 끝점에서 동일한 페이로드 콘텐츠를 보장합니다.

Q: get_orders_history_archive 호출에 속도 제한이 있습니까? 예. 엔드포인트는 IP 주소당 2초당 20개의 요청을 적용합니다. 이를 초과하면 필수 일시 중지 기간을 나타내는 Retry-After 헤더와 함께 HTTP 429가 트리거됩니다.

Q: 역지정가 주문이 실행되지 않은 경우 과거 주문 기록에 표시됩니까? 예. 트리거되지 않은 조건부 주문은 수동으로 제거된 경우 state='canceled' 으로 기록에 남고, 만료 시간 이후에도 여전히 활성 상태인 경우 state='pending' 으로 유지됩니다. 이 기간은 배치 중에 재정의되지 않는 한 기본값은 30일입니다.