בוט מסחר OKX: אינטגרציית API ואוטומציה

שילוב בוט מסחר עם API של OKX

עם ניסיון של למעלה מ-5 שנים ויותר מ-30 אינטגרציות עם בורסות, הצוות שלנו מבטיח אינטגרציה אמינה ויעילה עם API של OKX. קראו על OKX בוויקיפדיה היא בורסת מטבעות קריפטוגרפיים המבוססת באיי סיישל עם למעלה מ-300 נקודות קצה של API ונפח מסחר יומי של 5 מיליארד דולר. שירות אינטגרציית ה-API שלנו עבור בוטי מסחר מבטיח אוטומציה חלקה ב-OKX. בעת אוטומציה של מסחר ב-OKX, אנו נתקלים במלכודות לא ברורות: חתימת בקשות, ניהול פוזיציות באמצעות חשבון מאוחד, וחיבור מחדש של WebSocket. הצוות שלנו השלים למעלה מ-30 אינטגרציות של בוטי מסחר עם OKX במשך 5 שנים, וכל בקשה שנייה של לקוח נוגעת לבורסה זו. לרוב, בעיות נובעות מחתימה שגויה — שגיאת 401 בכל ניסיון, או מצב מסחר שגוי (tdMode) המוביל לסגירת פוזיציה כפויה. בואו נפרק כיצד להימנע משגיאות אלו ולבנות אינטגרציה יציבה שפועלת ללא תקלות.

OKX (לשעבר OKEx) היא הבורסה המרכזית השלישית בגודלה עם נפח מסחר יומי של כ-5 מיליארד דולר. היא מספקת API של REST ו-WebSocket V5 עבור ספוט, חוזים עתידיים, אופציות ומרווח — למעלה מ-50 זוגות מסחר. תכונה מרכזית: החשבון המאוחד מאפשר מסחר בכל המוצרים מיתרה אחת. אנו מבטיחים פעולה יציבה (זמינות של 99.9%) ומספקים תמיכה לאחר השקה למשך 30 יום.

אתגרים מרכזיים באינטגרציית בוט עם OKX

המלכודות העיקריות:

• חתימת בקשות: OKX דורשת שלושה כותרות ומשפט סיסמה. שגיאה בקידוד החתימה מובילה לשגיאת 401. יישמנו מודול אימות שנבדק על אלפי בקשות.
• חשבון מאוחד: פוזיציות עבור ספוט, חוזים עתידיים ואופציות קשורות ליתרה אחת. יש לציין נכון את tdMode (מזומן, צולב, מבודד). מצב שגוי עלול להוביל לסגירה בלתי צפויה.
• חיבור מחדש של WebSocket: בעת ניתוק חיבור, יש לבצע אימות מחדש. אנו משתמשים בנסיגה אקספוננציאלית ונרשמים מחדש לערוצים.

כדי לתקן שגיאת 401, בדקו שחותמת הזמן בפורמט UTC, שמשפט הסיסמה תואם לזה שנקבע בעת יצירת המפתח, ושהגוף עבור בקשות GET ריק. כמו כן, ודאו שמפתח ה-API לא פג.

חתימת בקשות נכונה עבור OKX

OKX דורשת שלושה כותרות עבור בקשות פרטיות: מפתח API, חותמת זמן, חתימה ומשפט סיסמה. שלבים:

1. צרו מחרוזת timestamp + method + path + body.
2. חתמו עליה עם HMAC-SHA256 באמצעות המפתח הסודי.
3. קודדו את החתימה ב-Base64.
4. העבירו בכותרת OK-ACCESS-KEY, OK-ACCESS-SIGN, OK-ACCESS-TIMESTAMP, OK-ACCESS-PASSPHRASE.

import hmac
import hashlib
import base64
import time
import json
import httpx

class OKXClient:
    BASE_URL = "https://www.okx.com"

    def __init__(self, api_key: str, secret_key: str, passphrase: str, sandbox: bool = False):
        self.api_key = api_key
        self.secret_key = secret_key
        self.passphrase = passphrase
        if sandbox:
            self.BASE_URL = "https://www.okx.com"  # sandbox через флаг в заголовке

    def _sign(self, timestamp: str, method: str, path: str, body: str = "") -> str:
        message = timestamp + method.upper() + path + body
        signature = hmac.new(
            self.secret_key.encode('utf-8'),
            message.encode('utf-8'),
            hashlib.sha256
        ).digest()
        return base64.b64encode(signature).decode()

    def _headers(self, method: str, path: str, body: str = "", sandbox: bool = False) -> dict:
        timestamp = time.strftime('%Y-%m-%dT%H:%M:%S.000Z', time.gmtime())
        headers = {
            "OK-ACCESS-KEY": self.api_key,
            "OK-ACCESS-SIGN": self._sign(timestamp, method, path, body),
            "OK-ACCESS-TIMESTAMP": timestamp,
            "OK-ACCESS-PASSPHRASE": self.passphrase,
            "Content-Type": "application/json"
        }
        if sandbox:
            headers["x-simulated-trading"] = "1"
        return headers

הצבת הזמנות דרך API של OKX

async def place_order(
    self,
    inst_id: str,  # 'BTC-USDT' для spot, 'BTC-USDT-SWAP' для perpetual
    td_mode: str,  # 'cash' (spot), 'cross' или 'isolated' (futures)
    side: str,  # 'buy' или 'sell'
    ord_type: str,  # 'market', 'limit', 'post_only', 'fok', 'ioc'
    sz: str,  # размер
    px: str = None  # цена (для limit)
) -> dict:
    path = "/api/v5/trade/order"
    payload = {
        "instId": inst_id,
        "tdMode": td_mode,
        "side": side,
        "ordType": ord_type,
        "sz": sz
    }
    if px:
        payload["px"] = px
    body = json.dumps(payload)
    async with httpx.AsyncClient() as client:
        response = await client.post(
            f"{self.BASE_URL}{path}",
            content=body,
            headers=self._headers("POST", path, body)
        )
    data = response.json()
    if data["code"] != "0":
        raise OKXError(f"Order failed: {data['msg']}")
    return data["data"][0]

async def get_positions(self, inst_type: str = "SWAP") -> list:
    path = f"/api/v5/account/positions?instType={inst_type}"
    async with httpx.AsyncClient() as client:
        response = await client.get(
            f"{self.BASE_URL}{path}",
            headers=self._headers("GET", path)
        )
    return response.json().get("data", [])

פרמטרי הזמנה מרכזיים:

בעת הצבת הזמנה, OKX מחזירה קוד '0' על הצלחה. כל שאר הקודים (לדוגמה, '51000' — יתרה לא מספקת) דורשים טיפול נפרד.

הרשמה לערוצי WebSocket של OKX

class OKXWebSocket:
    WS_PUBLIC = "wss://ws.okx.com:8443/ws/v5/public"
    WS_PRIVATE = "wss://ws.okx.com:8443/ws/v5/private"

    async def subscribe_trades(self, inst_id: str):
        async with websockets.connect(self.WS_PUBLIC) as ws:
            await ws.send(json.dumps({
                "op": "subscribe",
                "args": [{"channel": "trades", "instId": inst_id}]
            }))
            async for msg in ws:
                data = json.loads(msg)
                if data.get("arg", {}).get("channel") == "trades":
                    for trade in data.get("data", []):
                        await self.on_trade(trade)

    async def login_private(self, ws):
        """Аутентификация в приватном WebSocket"""
        timestamp = str(int(time.time()))
        sign = base64.b64encode(
            hmac.new(
                self.secret_key.encode(),
                f"{timestamp}GET/users/self/verify".encode(),
                hashlib.sha256
            ).digest()
        ).decode()
        await ws.send(json.dumps({
            "op": "login",
            "args": [{
                "apiKey": self.api_key,
                "passphrase": self.passphrase,
                "timestamp": timestamp,
                "sign": sign
            }]
        }))

לפי משוב לקוחות, אינטגרציית API של OKX מהירה ב-20-30% מזו של Binance בזכות תיעוד טוב יותר. לערוצי WebSocket של OKX יש בממוצע השהיה נמוכה ב-15% מזו של Bybit — קריטי לאסטרטגיות ארביטראז' ולמסחר בתדירות גבוהה.

אילו נכסים OKX תומכת בהם?

ארגז החול של OKX זמין דרך הכותרת BTC-USDT-YYMMDD — אין צורך בכתובת URL נפרדת. SDK רשמי של Python: {BASE}-{QUOTE}-YYMMDD-STRIKE-C/P. תיעוד: תיעוד API רשמי.

תחילת עבודה עם מפתחות API של OKX

כדי לקבל מפתחות API של OKX, היכנסו למדור ה-API באתר OKX וצרו מפתח עם ההרשאות הנדרשות (מסחר, קריאה). שמרו את המפתח הסודי ומשפט הסיסמה. לעולם אל תשתפו פרטים אלה עם אף אחד.

בדיקות בארגז חול

OKX מאפשרת בדיקות דרך הכותרת x-simulated-trading: 1. כל הבקשות עם כותרת זו מתבצעות על יתרת דמו. אין צורך בכתובת URL נפרדת.

לוח זמנים ועלות אינטגרציה

אינטגרציה בסיסית (ספוט בלבד) אורכת מ-10 ימי עבודה. עם חוזים עתידיים ואופציות, מ-15 יום. העלות מחושבת באופן אישי לפי הפונקציונליות הנדרשת (לדוגמה, תמיכה בחוזים עתידיים או אופציות). נבחן את הפרויקט שלכם תוך יום אחד ונציע פתרון אופטימלי. אוטומציית מסחר מפחיתה החלקה ב-10-15%, מה שמחזור של 100 אלף דולר נותן חיסכון של עד 15,000 דולר בחודש. הצוות שלנו: 5 שנים בפיתוח Web3, למעלה מ-30 אינטגרציות עם בורסות (10+ עם OKX), 100% שיעור השלמת פרויקטים. החל מ-5,000 דולר לאינטגרציית ספוט בסיסית; עם חוזים עתידיים ואופציות מ-15,000 דולר. קבלו ייעוץ — נדון בפרטים. הזמינו אינטגרציה.

שגיאות נפוצות ופתרונות

חתימה שגויה היא הגורם מספר 1 לשגיאות 401. ודאו שחותמת הזמן ב-UTC, שהגוף ריק עבור GET, ושמשפט הסיסמה תואם למקור. פקיעת מפתח API: הגדירו תוקף של לפחות 90 יום. חריגה ממגבלת קצב: OKX מאפשרת 20 בקשות בשנייה ברוב נקודות הקצה — הוסיפו הגבלת קצב. לעולם אל תתעלמו משדה הקוד: קוד 51000 מציין יתרה לא מספקת, 50000 מציין שגיאת מערכת.

מה מספק החשבון המאוחד

החשבון המאוחד מאפשר שימוש ביתרה אחת לכל סוגי המסחר: ספוט, חוזים עתידיים, אופציות ומרווח. זה מפשט את ניהול ההון ומפחית את הצורך בהעברת כספים בין חשבונות משנה. עבור מפתחים, זה אומר שאין צורך לכתוב מודולים נפרדים לכל מוצר — רק לציין נכון את BTC-USD-YYMMDD-50000-C ו-x-simulated-trading: 1.

טיפול בשגיאות API

קראו את שדה הקוד בתגובת ה-JSON. קודי 4xx הם שגיאות לקוח (בקשה שגויה), 5xx הם שגיאות שרת. השתמשו בנסיונות חוזרים עם נסיגה אקספוננציאלית עבור שגיאות 5xx.

מה כלול בשירות האינטגרציה

• ניתוח דרישות ועיצוב ארכיטקטורה
• יישום מודול אימות וניתוב
• אינטגרציית REST API לפעולות מסחר
• חיבור WebSocket לערוצי מחירים ומסחר
• בדיקות בסביבת ארגז חול
• בדיקות עומס ואימות יציבות
• תיעוד API ומדריך הפעלה
• תמיכה ל-30 יום לאחר ההשקה