OKX에서 자동 거래에 API를 사용하는 방법

OKX API는 REST 및 WebSocket 인터페이스를 통한 자동 거래를 가능하게하므로 보안 HMAC 인증을 통해 주문 배치, 실시간 데이터 스트리밍 및 계정 관리가 가능합니다.

2025/08/07 17:21

자동 거래를위한 OKX API 이해

OKX API는 사용자가 거래 전략을 자동화하고 실시간 시장 데이터에 액세스하며 프로그래밍 방식으로 계정을 관리 할 수있는 강력한 인터페이스를 제공합니다. 자동 거래를 시작하기 전에 OKX가 제공하는 API 유형을 이해하는 것이 필수적입니다. 이 플랫폼은 REST API , WebSocket API 및 Web3.JS API를 지원하며 처음 두 개는 자동 거래와 가장 관련이 있습니다. REST API를 사용하면 HTTP 요청을 사용하여 주문을하고 균형을 확인하고 히스토리 데이터를 검색 할 수 있습니다. WebSocket API를 사용하면 대기 시간이 낮은 시장 데이터, 주문 업데이트 및 계정 변경을 실시간으로 스트리밍 할 수 있습니다.

시작하려면 OKX 계정에서 API 키를 생성해야합니다. 계정 설정에서 API 관리 섹션으로 이동하십시오. 여기에서는 보안을 위해 이름, 암호 및 바인딩 IP 주소를 지정하여 새 API 키를 만듭니다. 무단 사용을 방지하기 위해 특정 IP에 대한 액세스를 제한하는 것이 중요합니다. 생성 된 키는 API 키 , 비밀 키 및 암호화 의 세 가지 구성 요소로 구성됩니다. 이들은 거래 계좌에 대한 모든 액세스 권한을 부여하므로 안전하게 저장해야합니다.

개발 환경 설정

OKX API를 효과적으로 사용하려면 적절한 개발 환경이 필요합니다. 대부분의 개발자는 단순성과 풍부한 라이브러리 생태계로 인해 Python을 사용합니다. Python (바람직하게는 버전 3.8 이상)을 설치하고 종속성을 관리하기 위해 가상 환경을 설정하십시오. PIP를 사용하여 HTTP 통신 requests 및 WebSocket 연결을 처리하기위한 websockets 과 같은 필수 패키지를 설치하십시오.

 pip install requests websockets

그런 다음 API 자격 증명을 안전하게 저장하기 위해 구성 파일 (예 : config.py )을 작성하십시오. 메인 스크립트에서 키를 하드 코딩하지 마십시오. 귀하의 구성에는 다음이 포함되어야합니다.

• API 키
• 비밀 키
• 암호
• 기본 URL (예 : 휴식을위한 https://www.okx.com )

버전 제어를 사용하는 경우이 파일이 .gitignore 에 추가되었는지 확인하십시오. 이것은 민감한 데이터의 우발적 노출을 방지합니다.

OKX API로 요청을 인증합니다

OKX는 요청 인증을 위해 HMAC-SHA256 암호화를 사용합니다. 모든 개인 API 요청에는 OK-ACCESS-KEY , OK-ACCESS-SIGN , OK-ACCESS-TIMESTAMP 및 OK-ACCESS-PASSPHRASE 와 같은 특정 필드가있는 헤더가 포함되어야합니다. 서명은 타임 스탬프, HTTP 방법, 엔드 포인트 경로 및 요청 본문 (있는 경우)을 연결 한 다음 비밀 키로 서명하여 생성됩니다.

파이썬에서 서명을 생성하는 방법은 다음과 같습니다.

 import hmac
 import hashlib
 import json def generate_signature (timeStamp, method, url, body, secret_key) :


message = timestamp + method + url + (json.dumps(body) if body else '') mac = hmac.new(bytes(secret_key, 'utf-8'), bytes(message, 'utf-8'), hashlib.sha256) return mac.hexdigest()
 이 기능을 API 래퍼에 포함시킵니다. 타임 스탬프는 ISO 형식이어야합니다 (예 : 2024-04-05T12:00:00.000Z ). 인증 오류를 피하기 위해 시스템 클록이 UTC와 동기화되어 있는지 항상 확인하십시오.
 
REST API를 통해 주문 배치
 거래를 자동으로 실행하려면 Place Order Endpoint를 사용하십시오. 엔드 포인트 URL은 /api/v5/trade/order 입니다. 필요한 매개 변수가 포함 된 JSON 본체로 게시물 요청을 보내야합니다.
 
Instid : 악기 ID (예 : BTC-USDT-SWAP )
 TDMODE : 무역 모드 ( cash , isolated 또는 cross )
 OrdType : 주문 유형 ( limit , market , post_only 등)
 SZ : 주문 크기
 PX : 가격 (한도 주문에 필요)
 예제 요청 본문 :
 
{
 'Instid': 'btc-usdt-swap',
 'tdmode': 'cross',
 'OrdType': 'Limit',
 'sz': '0.001',
 'PX': '60000'
 }

requests 도서관을 사용하여 요청을 보내십시오.

 import requests
 from config import API_KEY, SECRET_KEY, PASSPHRASE url = 'https://www.okx.com/api/v5/trade/order'
 헤더 = {


'OK-ACCESS-KEY': API_KEY, 'OK-ACCESS-PASSPHRASE': PASSPHRASE, 'Content-Type': 'application/json'
 }
 
몸 = {
 
'instId': 'BTC-USDT-SWAP', 'tdMode': 'cross', 'ordType': 'limit', 'sz': '0.001', 'px': '60000'
 }
 
타임 스탬프 = '2024-04-05T12 : 00 : 00.000Z'
 Signature = Generate_Signature (TimeStamp, 'Post', '/API/V5/Trade/Order', Body, Secret_key)
 
헤더 [ 'OK-Access-Sign'] = 서명
 헤더 [ 'ok-access-timestamp'] = 타임 스탬프
 
응답 = requests.post (URL, 헤더 = 헤더, json = body)
 print (response.json ())

code 및 msg 에 대한 응답을 확인하십시오. code 0 은 성공을 나타냅니다.

WebSocket을 사용하여 시장 데이터를 스트리밍합니다

실시간 거래 결정의 경우 OKX의 WebSocket API 에 연결하십시오. 이를 통해 주문서, 거래 및 주문 상태에 대한 라이브 업데이트를받을 수 있습니다. websockets 라이브러리를 사용하여 wss://ws.okx.com:8443/ws/v5/public 채널 또는 wss://ws.okx.com:8443/ws/v5/private for private 데이터에 연결하십시오.

가격 변경을 모니터링하려면 시세 또는 깊이 채널을 구독하십시오.

 import asyncio
 import websockets
 import json Async def listen_to_ticker () :


uri = 'wss://ws.okx.com:8443/ws/v5/public' async with websockets.connect(uri) as websocket: subscribe_message = { 'op': 'subscribe', 'args': [ { 'channel': 'tickers', 'instId': 'BTC-USDT' } ] } await websocket.send(json.dumps(subscribe_message)) while True: response = await websocket.recv() data = json.loads(response) if 'data' in data: print('Latest price:', data['data'][0]['last'])
 이 코 루틴을 실행하여 업데이트를 지속적으로 받으십시오. 단절을 처리하고 견고성을 위해 재 연결 로직을 구현하십시오.
 
위험 관리 및 모니터링 주문
 자동 거래에는 지속적인 모니터링이 필요합니다. Get Order 세부 사항 Endpoint ( /api/v5/trade/order )를 사용하여 ordId 의 특정 주문 상태를 확인하십시오. 시장 조건이 변경되면 취소 주문 엔드 포인트 ( /api/v5/trade/cancel-order )를 사용하여 주문 취소.
 
모든 작업을 기록하기 위해 로깅 구현 :
 
import logging
 logging.basicconfig (filename = 'trading.log', level = logging.info)
 
logging.info (f'order 배치 : {response.json ()} ')

실패한 요청 또는 예상치 못한 가격 변동에 대한 알림을 설정합니다. 손실이 임계 값을 초과하면 회로 차단기를 사용하여 거래를 중단하십시오.

자주 묻는 질문

2 요인 인증 (2FA)을 활성화하지 않고 OKX API를 사용할 수 있습니까?

보안상의 이유로 OKX는 API 키를 만들기 전에 계정에서 2FA를 활성화 해야합니다. 이는 무단 액세스에 대한 추가 보호 계층을 추가합니다.

OKX API에는 어떤 비율 제한이 적용됩니까?

OKX는 요청 유형에 따라 요율 제한을 시행합니다. 공개 엔드 포인트는 IP 당 2 초당 최대 20 개의 요청을 허용합니다. 개인 엔드 포인트는 API 키 당 2 초당 6 개의 요청 으로 제한됩니다. 이러한 제한을 초과하면 429 오류가 발생합니다.

TestNet은 OKX API 개발에 사용할 수 있습니까?

예. OKX는 다른 기본 URL을 통해 액세스 할 수있는 데모 거래 환경을 제공합니다 : https://www.okx.com . 실제 자금을 위험에 빠뜨리지 않고 거래를 시뮬레이션 할 수 있습니다. 구성에서 기본 URL을 전환하고 데모 별 API 키를 사용하십시오.

API 다운 타임 또는 연결 손실을 어떻게 처리합니까?

지수 백 오프로 재시 도로를 구현하십시오. WebSocket 연결의 경우 close 이벤트를 듣고 지연 후 다시 연결을 시도하십시오. 중단에서 회복하기 위해 로컬로 주문 상태를 저장합니다.