OKX에서 BTC/USDT 시장을 찾는 방법은 무엇입니까?

시장 기호 매핑

1. OKX는 일반적인 거래 쌍 표기법과 다른 표준화된 상품 ID 형식을 사용합니다. BTC-USDT 기호는 모든 OKX API 엔드포인트 및 UI 요소에서 사용되는 공식 기기 ID입니다.

2. BTC/USDT 또는 BTCUSDT와 같은 기존 표기법은 OKX의 백엔드 시스템에서 인식되지 않습니다. API 호출에서 이를 사용하려고 하면 오류 코드 51000과 함께 OkxParamsException 이 발생합니다.

3. 모든 현물, 마진, 무기한 상품에는 하이픈 형식이 엄격하게 적용됩니다. 여기에는 ETH-USDT, SOL-USDT 및 XRP-USDT가 포함되며 슬래시, 연결, 밑줄이 없습니다.

4. python-okx를 통해 시장 데이터를 검색할 때 MarketAPI.get_ticker() 메서드에는 정확한 상품 ID가 필요합니다. 잘못된 문자열은 네트워크 요청이 전달되기 전에 즉시 거부를 유발합니다.

5. 프런트엔드 사용자는 OKX 웹 또는 모바일 인터페이스의 검색창에 "BTC"를 입력하여 BTC-USDT를 찾을 수 있습니다. 자동 제안 목록에는 유효한 기기 ID만 표시되며 비준수 변형은 필터링됩니다.

API 엔드포인트 탐색

1. 티커 데이터의 RESTful 엔드포인트는 /api/v5/market/ticker?instId=BTC-USDT 입니다. 이 경로는 대소문자를 구분하며 기본 또는 따옴표와 같은 쿼리 매개변수를 별도로 허용하지 않습니다.

2. K-라인 검색은 /api/v5/market/candles?instId=BTC-USDT&bar=1H 를 사용합니다. bar 매개변수는 OKX의 사전 정의된 간격(1m, 3m, 5m, 15m, 30m, 1H, 2H, 4H, 6H, 12H, 1D, 1W, 1M) 중 하나여야 합니다.

3. 주문 배치 엔드포인트에는 동일한 instId 형식이 필요합니다. instId: 'BTC/USDT'를 사용한 거래 요청은 "Instrument ID informal"이라는 메시지와 함께 HTTP 400을 반환합니다.

4. WebSocket 구독 메시지는 동일한 규칙을 따릅니다. 채널 티커에는 JSON 페이로드 {'channel':'tickers','instId':'BTC-USDT'} 가 필요합니다. 편차가 발생하면 오류 알림 없이 자동으로 연결이 끊어집니다.

5. CCXT는 이 매핑을 내부적으로 추상화하지만 exchange.markets 개체를 통해 투명하게 노출합니다. 개발자는 exchange.markets['BTC/USDT'].id를 검사하여 해결된 OKX 기본 기호를 확인할 수 있습니다.

프런트엔드 인터페이스 동작

1. OKX의 메인 거래 페이지에서 BTC-USDT는 기본적으로 현물 탭 아래에 나타납니다. 마진이나 선물로 전환하면 기본 기호 구조를 변경하지 않고 표시되는 상품 세트가 변경됩니다.

2. 주문장 깊이 차트는 올바른 상품 ID가 활성화된 경우에만 렌더링됩니다. URL에 ?instrument_id=BTC%2FUSDT가 포함된 경우 차트는 공백으로 유지되고 API 요청이 실행되지 않습니다.

3. 모바일 앱 탐색은 지속적인 기기 ID 캐싱에 의존합니다. 자산 목록에서 BTC-USDT를 스크롤해도 기호가 다시 로드되지 않습니다. 수동으로 변경될 때까지 마지막으로 유효한 instId 상태가 유지됩니다.

4. 계정 > 내역 섹션의 과거 거래 로그는 BTC-USDT를 사용한 모든 거래를 독점적으로 참조합니다. 내보낸 CSV 파일은 변환 없이 이 형식을 유지합니다.

5. UI 스토어를 통해 구성된 가격 알림은 기본 상품 ID를 사용하여 트리거됩니다. BTC/USDT에 대한 알림을 편집하면 지속되기 전에 자동으로 BTC-USDT로 변환됩니다.

모듈 전체의 데이터 일관성

1. python-okx의 MarketData.py, Trade.py 및 Account.py 모듈은 통합 기호 레지스트리를 공유합니다. 모듈별로 별도의 구성이 없습니다. 불일치로 인해 내부 유효성 검사가 중단될 수 있습니다.

2. books5 및 candle1m 채널의 Websocket 스트림은 모든 페이로드에 'instId':'BTC-USDT' 가 포함된 메시지를 내보냅니다. 원시 JSON을 구문 분석하는 클라이언트는 올바르게 라우팅하려면 이 문자열과 정확히 일치해야 합니다.

3. 여러 상품에 대한 일괄 쿼리에는 쉼표로 구분된 BTC-USDT,ETH-USDT,SOL-USDT가 필요합니다. 공백, 세미콜론 또는 대괄호는 전체 요청을 무효화합니다.

4. 실패한 주문의 오류 응답에는 원래 요청이 잘못된 형식을 사용한 경우에도 응답 본문에 'instId': 'BTC-USDT' 가 포함됩니다. 시스템은 기록하기 전에 정상화됩니다.

5. OKX의 공개 문서 예제에서는 BTC-USDT를 일관되게 사용합니다. 커뮤니티 튜토리얼의 편차로 인해 오래된 패턴의 복사-붙여넣기 전파로 인해 통합 오류가 발생하는 경우가 많습니다.

자주 묻는 질문

Q: BTC-USDT 대신 BTCUSDT를 사용할 수 있나요? A: 아니요. BTCUSDT는 모든 OKX API 및 프런트엔드 구성 요소에서 거부됩니다. BTC-USDT만 허용됩니다.

Q: 하이픈이 WebSocket 재연결 논리에 영향을 줍니까? 답: 그렇습니다. 잘못된 instId가 있는 구독 페이로드로 인해 서버는 닫기 프레임을 보내지 않고 연결을 끊습니다. 다시 연결을 시도하려면 다시 구독하기 전에 기호를 수정해야 합니다.

Q: CCXT는 BTC/USDT를 내부적으로 변환하지만 python-okx는 변환하지 않는 이유는 무엇입니까? A: CCXT는 다중 교환 추상화 계층으로 설계되었습니다. python-okx는 교환 전용이며 개발자가 OKX의 기본 규칙을 사용하여 직접 작업한다고 가정합니다.

Q: API 호출에서 BTC-USDT는 대소문자를 구분합니까? 답: 그렇습니다. btc-usdt 또는 Btc-Usdt는 오류 코드 51000을 반환합니다. 대문자와 하이픈 배치는 필수입니다.