מסחר אלגוריתמי ב-OKX דרך API: מהפקת מפתח ועד סקריפט ההזמנה הראשון

כנראה הגעת לכאן ככה: ראית כמה צילומי מסך של רווחים מבלוגרים של מסחר אלגוריתמי, התלהבת, פתחת את הלוח של OKX מוכן להתחיל לעבוד — ונתקעת כבר במשוכה הראשונה. נכנסת ל'ניהול API' ויש שם ערימת אפשרויות: apiKey, Secret, Passphrase, קריאה, מסחר, משיכה, רשימת IP מורשים. כל מילה מוכרת, אבל ביחד אין לך מושג מה למלא. אז סגרת את הדף ואמרת לעצמך "בפעם אחרת".

המאמר הזה נועד לעזור לך לעבור את המשוכה הזאת. אנחנו (צוות המערכת של MeowQuant) פירקנו את כל התהליך — מפתיחת API מאפס ועד הרצת סקריפט ההזמנה הראשון ב-Python — לכמה צעדים, וכל צעד עברנו בעצמנו, כולל המהמורות שהתיעוד הרשמי לא מזכיר אבל סביר שתיתקל בהן. בסוף הקריאה אתה אמור להיות מסוגל: ליצור API Key בטוח בלוח של OKX, לוודא שהוא עובד בעזרת עשר-עשרים שורות קוד, ואז להזין ולבטל את הפקודה הראשונה שלך בחשבון הדמו. אתה לא צריך להיות מתכנת, רק להעתיק ולעקוב.

קודם תשאל את עצמך: אתה באמת צריך API?

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

ב'מסחר אסטרטגי' המובנה בלוח של OKX יש בוטים מוכנים: בוט רשת, DCA, ארביטראז' חוזים ועוד. אתה מגדיר פרמטרים בכמה לחיצות באתר או באפליקציה, והוא רץ במקומך בלי שורת קוד אחת. עבור הרוב המוחלט של המתחילים שרק רוצים שהתוכנה תציב פקודות קנייה ומכירה, הבוטים המובנים מספיקים — ובנוסף, כשמשהו משתבש יש ממשק שאפשר לראות ולעצור בו ישירות.

אז מתי באמת שווה לפתוח API? לפי השיפוט שלנו, במצבים האלה:

• הלוגיקה האסטרטגית שאתה רוצה לא ניתנת לביצוע בבוט מובנה — למשל התאמת פוזיציה דינמית לפי אינדיקטור מסוים, או ריצה מתואמת על פני כמה מטבעות.
• אתה רוצה לעשות בדיקות היסטוריות (backtest) ולמשוך נרות היסטוריים בכמות ולדמות עסקאות.
• אתה רוצה להריץ כמה אסטרטגיות במקביל, וניהול מאוחד בסקריפט יעיל יותר מלחיצות ידניות.
• אתה פשוט רוצה ללמוד מסחר אלגוריתמי, ולהשתמש בבורסה כארגז חול לתרגול.

אם זיהית את עצמך — המשך לקרוא. אם גילית שבעצם אתה רק רוצה "להציב רשת ולתת לה לתפוס לי תנודות בזמן שאני ישן", שווה דווקא ללכת קודם לפתוח רשת מובנית בלוח, וכשתיתקל באמת בתקרה של הכלים המובנים תוכל לחזור ולפתוח API. יש לנו מאמר נפרד על איך מגדירים פרמטרים של בוט רשת, שמתאים למי שהולך בדרך הזאת.

שלושה דברים שצריך להבין לפני פתיחת מפתח

לפני שאתה ניגש באמת ליצור מפתח, יש שלושה דברים שצריך להבין. אם תלחץ 'צור' בלי להבין אותם, סביר שאו שלא תצליח להתחבר, או שתטמין לעצמך פצצת אבטחה.

① תקבל שלושה אישורים, לא שניים

הרבה אנשים חושבים ש-API זה "שם משתמש וסיסמה". כשמגיעים ל-OKX מתבלבלים — הוא נותן לך שלושה דברים:

• apiKey: המזהה הציבורי של המפתח, מקביל ל"שם משתמש".
• secret (Secret Key): המפתח לחתימת בקשות, מקביל ל"סיסמה", ומוצג רק פעם אחת בעת היצירה.
• Passphrase: מחרוזת סיסמה שאתה מגדיר בעצמך בעת היצירה, ייחודית ל-OKX.

השלישי, ה-Passphrase, הוא אזור האסון של מתחילים. זאת לא סיסמת ההתחברות שלך ל-OKX, אלא מחרוזת תווים נפרדת שהגדרת כשיצרת את המפתח הזה. וגרוע מזה — בספריית ה-ccxt של Python השדה הזה לא נקרא passphrase, אלא password. וכך אינספור אנשים ממלאים מתוך הנחה את סיסמת ההתחברות, ואז שוברים את הראש מול שגיאת "אימות נכשל". פשוט תזכור משפט אחד: השדה password ב-ccxt = ה-Passphrase שהגדרת בעת יצירת המפתח.

② סמן רק 'מסחר', לעולם לא 'משיכה'

בעת יצירת המפתח OKX נותן לך לבחור מה המפתח הזה יכול לעשות, בעיקר שלוש רמות:

• קריאה: בדיקת שער, יתרה והזמנות. הסיכון הנמוך ביותר.
• מסחר: הזמנה, ביטול ושינוי הזמנה. חיוני להרצת אסטרטגיה.
• משיכה: העברת מטבעות החוצה מהחשבון.

כאן יש קו אדום של אבטחה כמעט בלי יוצא מן הכלל: למפתח שמריץ מסחר אלגוריתמי סמן רק 'קריאה' ו'מסחר', ולעולם אל תסמן 'משיכה'. ההיגיון ישיר — גם אם שלושת האישורים שלך ידלפו יום אחד, כל עוד אין למפתח הרשאת משיכה, מי שישיג אותו יוכל לכל היותר להזין פקודות פרועות בחשבון שלך (שזה כמובן רע מאוד), אבל לא יוכל לסחוב את הכסף שלך. וברגע שתסמן משיכה, דליפה שווה למסירת המפתח של הכספת. מסחר אוטומטי בכלל לא משתמש בפעולת המשיכה, אז ההרשאה הזאת רק תזיק לך בלי שום תועלת.

③ האם להגדיר רשימת IP מורשים

OKX מאפשר לקשור למפתח רשימת IP מורשים — רק בקשות שמגיעות מ-IP מוגדר יתקבלו. זה ביטוח נוסף ששווה מאוד.

הקריטריון פשוט: אם הסקריפט שלך רץ על מכונה עם IP קבוע (למשל שרת ענן, או חיבור ביתי עם IP ציבורי קבוע), הוסף את ה-IP הזה לרשימה, והאבטחה עולה מיד מדרגה. אם אתה מריץ על המחשב שלך והחיבור הביתי משנה IP לעיתים קרובות, רשימה מורשית דווקא תגרום לדחיות יומיומיות בגלל שינויי IP, וזה ייסורים חוזרים. במצב כזה אפשר לא להגדיר אותה כרגע, אבל חובה לשמור היטב על האישורים. כשתעביר את הסקריפט לריצה ארוכת טווח על שרת עם IP קבוע, תוסיף את הרשימה.

הפקת API Key בלוח של OKX

הבנת את שלושת הדברים — עכשיו לך אל הלוח וצור מפתח. להלן הנתיב האמיתי, לפי הלוח הנוכחי של OKX (הממשק משתנה מעט מדי פעם, אבל הלוגיקה קבועה):

1. היכנס ל-OKX, העבר את העכבר לאווטר בפינה העליונה, ובתפריט הנפתח מצא 'API' או 'ניהול API' ולחץ עליו.
2. בדף ניהול ה-API, לחץ 'צור API Key'. אם הוא שואל למטרת השימוש, בחר מסחר אישי ולא חיבור צד שלישי.
3. תן למפתח שם (הערה), למשל meow-grid-bot, כדי שתזהה במבט אחד למה הוא משמש.
4. הגדר Passphrase. בשלב הזה אתה מגדיר מחרוזת סיסמה בעצמך, ותזכור אותה היטב — ccxt צריך אותה בהמשך, היא קשורה רק למפתח הזה, ואם תאבד אותה תוכל רק למחוק את המפתח וליצור מחדש.
5. סמן הרשאות: סמן 'קריאה' ו'מסחר', אל תסמן 'משיכה'. (ראה את הקו האדום מהסעיף הקודם.)
6. אם אתה מריץ על מכונה עם IP קבוע, מלא רשימת IP מורשים; אם לא בטוח, השאר ריק לעת עתה.
7. לחץ אישור ועבור את האימות הדו-שלבי (טלפון / מייל / Google Authenticator).
8. הדף יציג את ה-apiKey ואת ה-Secret Key. ה-Secret מוצג רק פעם אחת — העתק ושמור מיד במקום בטוח. אחרי סגירת הדף לא תראה אותו שוב, ואם תאבד אותו תוכל רק למחוק את המפתח וליצור מחדש.

בשלב הזה אמורים להיות בידיך שלושה דברים: apiKey, Secret, וה-Passphrase שהגדרת בעצמך. שמור אותם בקובץ מקומי שלא יסונכרן ויעלה לרשת — אל תצלם ותשלח בצ'אט, אל תדביק בשום פנקס מקוון. בצעד הבא נשתמש בשלושת האישורים האלה כדי להתחבר.

להתחבר עם Python + ccxt ולוודא שזה עובד

קיבלת את האישורים — עכשיו צריך לוודא שהם באמת עובדים. אנחנו משתמשים בספרייה ccxt — היא עוטפת את ה-API של מאות בורסות לממשק אחיד, כך שאתה לא צריך להתעמק בפרטי החתימה הגולמיים של OKX, ובכמה שורות קוד תוכל לבדוק יתרה ולהזין הזמנות.

קודם התקן את הספרייה. פתח טרמינל (שורת פקודה) והקלד:

pip install ccxt

אחרי ההתקנה, צור קובץ חדש okx_check.py, העתק לתוכו את הקטע הבא, והחלף את שלושת מצייני המקום שבמרכאות באישורים שלך:

import ccxt

# שלושה אישורים: apiKey, secret, password (=Passphrase)
okx = ccxt.okx({
    'apiKey':   'ה_apiKey_שלך',
    'secret':   'ה_secret_שלך',
    'password': 'ה_Passphrase_שלך',   # ייחודי ל-OKX, זה מה שמתחילים מפספסים הכי הרבה
})

# משיכת יתרת חשבון, לאישור שהאימות עובר
balance = okx.fetch_balance()
print('USDT זמין:', balance['USDT']['free'])
print('USDT סך הכל:', balance['USDT']['total'])

שמור, והרץ בטרמינל python okx_check.py. אם הוא הדפיס את יתרת ה-USDT שלך (גם אם היא 0) — מזל טוב, האימות עבר וה-API מחובר. אם הוא מחזיר שגיאה, אל תיבהל — סביר שאחד משלושת האישורים מולא שגוי או חסר. דלג לסעיף "המהמורות שמתחילים נתקלים בהן הכי הרבה" שבמאמר הזה והשווה לאיתור הבעיה; שם מפורטות הסיבות שמתאימות לכל שגיאה.

עוד מילה על שמירת האישורים: למעלה, לשם הבהירות, כתבנו את האישורים ישירות בקוד, אבל זה מתאים רק לבדיקה מקומית חד-פעמית. ברגע שהסקריפט אמור לרוץ לאורך זמן, ובוודאי כשהוא עולה לשרת, אל תכתוב את האישורים קשיח בקוד — עבור למשתני סביבה או לקובץ תצורה נפרד, וודא שהקובץ הזה לא יסונכרן ולא יוגש למאגר קוד. זה ההרגל המרכזי שמוריד את הסיכוי לגניבת החשבון למינימום.

סקריפט ההזמנה הראשון: הזמנה וביטול

אם אתה יכול לבדוק יתרה, סימן שהרשאת הקריאה תקינה; עכשיו נבדוק את הרשאת המסחר — נזין הזמנה ונבטל אותה. כאן נשתמש בהזמנת limit ולא ב-market, כי בהזמנת limit אתה קובע את המחיר בעצמך, ואם תקבע אותו רחוק מאוד ממחיר השוק היא לא תתבצע מיד — וכך תוכל לתרגל הזמנה וביטול בלי להוציא כסף באמת.

לפני ההזמנה צריך להבין שני דברים קטנים:

איך כותבים symbol (צמד מסחר). ב-ccxt, צמד מסחר ספוט נכתב באופן אחיד בפורמט מטבע_בסיס/מטבע_תמחור, למשל ביטקוין מול USDT הוא BTC/USDT, ואת'ריום מול USDT הוא ETH/USDT. שים לב — קו נטוי קדמי, אותיות גדולות. כתיבת פורמט שגוי היא מקור שגיאות נפוץ נוסף.

פרמטרים של הזמנה. שיטת ההזמנה ב-ccxt היא create_order(symbol, type, side, amount, price), וחמשת הפרמטרים הם: צמד מסחר, סוג הזמנה (limit / market), כיוון (buy / sell), כמות, ומחיר.

הקטע הבא מזין הזמנת קנייה limit במחיר נמוך שבכוונה לא תתבצע, מקבל את מספר ההזמנה ומבטל אותה מיד. חובה להריץ קודם בדמו (הסעיף הבא מסביר איך מתחברים לדמו):

import ccxt, time

okx = ccxt.okx({
    'apiKey':   'ה_apiKey_שלך',
    'secret':   'ה_secret_שלך',
    'password': 'ה_Passphrase_שלך',
})

symbol = 'BTC/USDT'

# הזמנת קנייה limit שבכוונה לא תתבצע: מחיר נמוך בהרבה ממחיר השוק
order = okx.create_order(
    symbol=symbol,
    type='limit',
    side='buy',
    amount=0.0001,     # כמות קטנה מאוד, התחל לפי הכמות המינימלית הניתנת להזמנה
    price=20000,       # נמוך בהרבה ממחיר ה-BTC הנוכחי, ישב ולא יתבצע
)
order_id = order['id']
print('הוזמן, מספר הזמנה:', order_id)

time.sleep(2)

# ביטול ההזמנה שזה עתה הוזמנה
canceled = okx.cancel_order(order_id, symbol)
print('בוטל:', canceled['id'])

אחרי שזה עובד תראה שתי שורות פלט: קודם מספר ההזמנה, ושתי שניות לאחר מכן אישור ביטול. זה אומר שהסקריפט שלך כבר יודע לבצע "הזמנה–ביטול" באופן מלא, ושתי הפעולות הבסיסיות ביותר של אלגו מוכנות. שאר האסטרטגיות — רשת, DCA, גידור — הן בעצם רק הוספת לוגיקת תנאים ולולאות מעל שתי הפעולות האלה.

לגבי amount (כמות): לכל צמד מסחר יש כמות מינימלית ומגבלת דיוק, ומילוי קטן מדי יידחה על ידי הבורסה. אם תקבל "הכמות אינה תואמת לכללים", תוכל קודם להשתמש ב-okx.load_markets() כדי לבדוק את ה-limits וה-precision של הצמד הזה, ולמלא לפי המינימום הנדרש.

קודם בדמו: להריץ עם כסף מדומה

את כל הקוד למעלה אנחנו ממליצים בחום להריץ קודם בדמו, לוודא שהכל תקין, ורק אז לעבור לכסף אמיתי. הדמו משתמש בכסף וירטואלי, והזמנה שגויה או לוגיקה שגויה לא יגרמו לך הפסד אמיתי — זה הצעד המשתלם ביותר בשלב הלמידה, וכמעט אין סיבה לדלג עליו.

הדמו של OKX נקרא Demo Trading (מסחר מדומה), ואפשר לעבור אליו גם באפליקציה וגם באתר. היתרון: הוא חולק את אותו API Key עם החשבון האמיתי שלך, ואתה לא צריך ליצור מפתח נפרד לדמו. כדי לגרום ל-ccxt לשלוח את הבקשות לדמו ולא לחשבון האמיתי, פשוט הדלק את מתג ה-sandbox אחרי האתחול:

import ccxt

okx = ccxt.okx({
    'apiKey':   'ה_apiKey_שלך',
    'secret':   'ה_secret_שלך',
    'password': 'ה_Passphrase_שלך',
})

# השורה המכרעת: מעבר לדמו (Demo Trading)
okx.set_sandbox_mode(True)

# מכאן והלאה כל הבקשות נשלחות לדמו, עם כסף וירטואלי
balance = okx.fetch_balance()
print('USDT זמין בדמו:', balance['USDT']['free'])

חלק מהגרסאות תומכות גם בכתיבה בתצורה 'options': {'sandboxMode': True}, עם אותו אפקט; בחר אחת מהן שעובדת אצלך. אחרי המעבר לדמו תוכל להריץ שוב ושוב בביטחון את סקריפט ההזמנה-ביטול הקודם: גם אם תכתוב בטעות מחיר קרוב למחיר השוק והוא יתבצע באמת, מה שתבזבז הוא USDT וירטואלי.

ההרגל שלנו: כל אסטרטגיה חדשה, כל קוד ששונה, קודם רץ ברצף בדמו למשך פרק זמן, מוודאים ש-callbacks של הזמנה, ביטול ושינויי יתרה כולם כמצופה, ורק אז מסירים את השורה set_sandbox_mode(True), עוברים לחשבון האמיתי — והפעם הראשונה בחשבון האמיתי היא תמיד בסכום קטן מאוד. הסדר הזה הציל אותנו כמה פעמים — כמה באגים לוגיים נחשפו כבר בשלב הדמו, ואילו עלינו ישר לכסף אמיתי, המחיר היה יותר מסתם כסף.

המהמורות שמתחילים נתקלים בהן הכי הרבה

הסעיף הזה הוא החלק שהכי כדאי לשמור במאמר הזה. כל אחת מהשורות למטה היא שגיאה שאנחנו בעצמנו נתקלנו בה, או שראינו שוב ושוב בקהילות, והשוואה אליהן באיתור התקלות תחסוך לך כמה שעות.

Passphrase חסר / שגוי (הכי תכוף)

השגיאה בדרך כלל מסוג אימות (משהו כמו "Invalid sign" או "passphrase incorrect"). בדוק אם השדה password ב-ccxt מולא עם ה-Passphrase שהגדרת בעת יצירת המפתח, ולא עם סיסמת ההתחברות או ה-secret. זה לבדו תופס יותר ממחצית מכשלי האימות של מתחילים.

שגיאת חותמת זמן / בקשה שפגה

ל-OKX יש סובלנות לחותמת הזמן בבקשה, ואם השעון של המחשב או השרת שלך לא מדויק (סטייה של עשרות שניות ויותר), החתימה תידחה כי חותמת הזמן פגה. הפתרון הוא לסנכרן את שעון המערכת לזמן רשת מדויק (הדלקת NTP לכוונון אוטומטי). שרתי ענן בדרך כלל מדליקים זאת כברירת מחדל, מכונות מקומיות לפעמים סוטות.

אין הרשאה

אם אתה יכול לבדוק יתרה אבל לא להזין הזמנה, בדרך כלל סימנת רק 'קריאה' ולא 'מסחר' בעת יצירת המפתח. חזור לניהול ה-API והוסף למפתח הזה את הרשאת המסחר, בלי צורך ביצירה מחדש.

הגעה למגבלת קצב (Rate Limit)

אם בלולאה אתה בודק שער או מזין/מבטל הזמנות בטירוף, תיתקל במגבלת קצב הממשק ותקבל משהו כמו "Too Many Requests". הדרך הקלה ביותר היא להדליק את מגביל הקצב של ccxt באתחול: ccxt.okx({..., 'enableRateLimit': True}), והוא ישתול אוטומטית מרווחים בין הבקשות. אל תשתמש ב-while True בלי שום השהיה כדי להפציץ את הממשק.

symbol שגוי

כתיבת BTC/USDT בתור BTCUSDT, btc/usdt, או שימוש בפורמט של חוזים כדי להזין הזמנת ספוט — כל אלה יחזירו "צמד המסחר לא קיים". זכור שספוט הוא אותיות גדולות/אותיות גדולות עם קו נטוי; אם לא בטוח, קודם print(okx.load_markets().keys()) כדי לראות איך באמת נראים הצמדים הזמינים.

IP מחוץ לרשימה המורשית

מי שהגדיר רשימה מורשית, ואז שינה סביבת רשת (למשל הדליק proxy, או שה-IP הביתי השתנה), ייתקל בדחייה. ודא שכתובת ה-IP היוצאת הנוכחית שלך עדיין ברשימה של המפתח הזה, ואם לא — לך ללוח ועדכן את הרשימה.

ניהול סיכונים והלך רוח: אלגו אינו רווח מובטח

עכשיו כשאתה יכול להריץ סקריפט, אנחנו חייבים לשפוך עליך קצת מים קרים. למסור את המסחר לתוכנה לא יגרום לך להרוויח אוטומטית — היא רק מבצעת את ההחלטות שלך מהר יותר ובלי רגש. אם האסטרטגיה עצמה מפסידה, האוטומציה רק תגרום לך להפסיד מהר יותר ובאופן יציב יותר.

ובנוסף, לאוטומציה דרך API יש סיכון ייחודי משלה: התוכנה לא מהססת כמו אדם. לולאה שכתובה שגוי, כיוון קנייה/מכירה הפוך, כמות עם נקודה עשרונית חסרה — בפעולה ידנית אולי היית מבחין בזה לפני הלחיצה על אישור, אבל הסקריפט יבצע את הטעות בנאמנות וברציפות עשרות פעמים. כבר בשלב הדמו ראינו לולאה שכתבנו בעצמנו מציבה תוך שניות שורת פקודות שלא היו אמורות להיות מוצבות, בגלל תנאי שיפוט שנכתב הפוך. אילו זה היה בחשבון אמיתי, זה היה הפסד כסף אמיתי.

אז כמה עצות מעשיות למי שרק מתחיל:

• קודם בסכום קטן. הפעם הראשונה בחשבון אמיתי — בסכום שגם אם תפסיד את כולו לא יכאב לך. תתייחס אליו כשכר לימוד, לא כקרן.
• הגדר תקרת פוזיציה. כתוב קשיח בסקריפט תקרה לפוזיציה הבודדת ולסך הפוזיציות, ואל תיתן לתוכנה הזדמנות לזרוק את כל ההון שלך פנימה.
• השאר סטופ-לוס. לא משנה כמה האסטרטגיה נראית יפה, צרף לה קו סטופ-לוס או drawdown מקסימלי ברור, ובהפעלתו — לעצור.
• היזהר מחוזים ומינוף. המאמר הזה כולו עוסק בספוט. חוזים עם מינוף יכולים לאפס את הקרן בזמן קצרצר, ובשלב המתחיל אנחנו ממליצים בחום לעשות קודם רק ספוט, ולייצב את התהליך ואת הלך הרוח.
• צפה בו רץ תקופה. בימים הראשונים של אסטרטגיה חדשה בחשבון אמיתי, אל תרפה ממנה לגמרי — עקוב אחריה, וודא שההתנהגות שלה תואמת למה שראית בדמו.

שאלות נפוצות

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