אינטגרציה של KuCoin API: היכן בוט המסחר נשבר
בוט מסחר מפסיק להיות אמין לא ברגע ההפעלה, אלא ברגע הניתוק הראשון. חיבור של בוט מסחר לבורסה הוא חילוף מתמיד: זרם ציטוטים, אישורים על הזמנות, עדכונים על החשבון.
די בכך שהערוץ ייקפא לעשרה שניות, והבוט מקבל החלטות על בסיס תמונה מיושנת של השוק, שולח הזמנה בשנית ומקבל ביתרה שתי פוזיציות במקום אחת.
קטיעת החיבור לבורסה כמעט תמיד יוצרת שכפול הזמנות: הבקשה יצאה, התשובה לא חזרה, הבוט רואה בניסיון כלא-מוצלח וחוזר עליו באותה כוונה. אם להזמנה אין מזהה ייחודי מצד הלקוח, הבורסה מקבלת את שתי הבקשות כשונות.
לצד זה חיה הבעיה השנייה — סטטוסים תקועים של הזמנות: חלק מהעסקאות כבר בוצעו, חלק בוטלו, והמצב הפנימי של הבוט נשאר בשלב "נשלח".
משם מתחילה הסטייה בין היתרה לפוזיציות. התאמת לילה מראה שהיתרה החופשית קטנה מהצפוי, מחיר הכניסה הממוצע שונה, וביומן העסקאות הופיעו תיקונים ידניים — מישהו תיקן נתון כדי שהדוח יתאם.
לאחר מכן הבוט והבורסה נפרדים לנצח: הסיכון מחושב מנתונים שגויים, ועצירה נכונה של המסחר ללא הפסדים כבר אינה אפשרית.
מפרקים כיצד זה נסגר באינטגרציה של KuCoin API: שחזור מצב לאחר ניתוק, הגנה מפני כפילויות ברמת מזהה ההזמנה, התאמת פוזיציות מול הבורסה כשלב חובה במחזור.
מה משתנה לאחר ההטמעה: מהירות, שלמות, זמני השבתה
חיבור מהונדס בקפידה ל-KuCoin מסיר את מקור ההפסדים המרכזי — ההשהיה בין אירוע שוק לפעולת הבוט. במקום סקר תקופתי של מחירים, הבוט נרשם לזרם השינויים של ספר ההזמנות ומגיב ברגע הופעת האירוע, ולא במרווח קבוע. זמן התגובה מתקצר משניות לעשיריות השנייה — זה מספיק כדי שההזמנה תיכנס לתור לפני החלקה בספר דק.
שלמות הביצוע של הזמנות גדלה הודות לשליחה אידמפוטנטית ולהתאמת מצב מפורשת. כל הזמנה מקבלת מזהה פנימי, תשובת הבורסה נשמרת, וסטיות מנותחות אוטומטית ולא בעיני התורן. חלק ההזמנות המאושרות בניסיון הראשון מגיע לרמה יציבה, ושליחות חוזרות אינן יוצרות פוזיציות כפולות.
השבתה של קו המסחר פוגעת יותר מכל: כל עוד הקו מושבת, פוזיציות פתוחות נותרות ללא ניהול. לכן חיבור מחדש בהשהיה גדלה, בקרת רעננות נתונים ומעבר חירום למצב "סגירה בלבד" מוטמעים בלוגיקה.
הקו שורד קטיעת חיבור והפעלה מחדש של הצומת ללא התערבות ידנית, וחלק הפעולות הידניות במחזור היומי יורד לנגיעות בודדות.
היציבות נשענת לא על סקריפט אחד, אלא על הפרדת תפקידים: שכבת האותות, שכבת הביצוע ושכבת רישום המצב. כשל של כל אחת מהן אינו הופך לאובדן שליטה — הבוט מפסיק להציב הזמנות חדשות, אך ממשיך ללוות את הפתוחות.
אפשרויות עבודה עם KuCoin: מפתח, תת-חשבון, תור הזמנות
חיבור לבורסה רק לעתים רחוקות מסתכם בדרך אחת: לכל אפשרות יש מחיר משלה בדמות מגבלות. בוט אחד בחשבון אחד וחמש אסטרטגיות על יתרה משותפת — אלה דרישות שונות להרשאות המפתח, לחלוקת מגבלות הבקשות ולטיפול בתקריות. להלן — חלופות ממשיות, שביניהן בוחרים בהתחלה ולא מתוך הרגל.
| אפשרות | מתי מתאימה | מגבלות |
|---|---|---|
| מפתח מסחר עם הרשאות מוגבלות | אסטרטגיה אחת, חשבון אחד, הפעלה מהירה | ההרשאות ניתנות על כל החשבון: משיכת כספים נאסרת מיד, אך אי אפשר לחלק סיכונים בין אסטרטגיות |
| תת-חשבון לאסטרטגיה | מספר אסטרטגיות, נדרשת בידוד יתרה ודיווח נפרד | הניהול דורש גישת מאסטר, כספים מועברים בין תת-חשבונות ידנית, ההגדרות מתרבות |
| תור הזמנות וחזרות | הרשת אינה יציבה, והזמנה שהוחמצה יקרה | נדרשת הגנה מפני כפילויות: ללא רישום מצב ההזמנה, החזרה יוצרת עסקה שנייה במקום שחזור הראשונה |
| שכבת חיבור מתווכת | אסטרטגיות רבות, תדירות גבוהה, דרישות לביקורת פעולות | יקר יותר בתמיכה: נדרש יומן מצבים, התאמת פוזיציות וטיפול בחוסר סנכרון |
את הבחירה מקבעים לפני תחילת העבודה: ממנה תלוי היכן חי רישום המצב, כיצד מסובבים את המפתח ללא עצירת המסחר ומה ייכנס ליומן בעת ניתוח תקלה. בהמשך נראה כיצד זה בנוי בצד שלנו.
סדר העבודות: ביקורת, סכמה, חיבור, בדיקה, מסירה
סדר העבודות בנוי כך שכל שלב נשען על תוצאת קודמו: תחילה מפרקים את לוגיקת האסטרטגיה, לאחר מכן מתכננים את האינטראקציה שלה עם הבורסה, ורק אחר כך מופיעים מפתחות וקו מסחר חי. מעבר הלאה ללא שלב קודם סגור כמעט תמיד מייצר שגיאות, שהיקרות ביותר במצב עבודה.
- ביקורת אסטרטגיית המסחר. מפרקים את תנאי הכניסה והיציאה, העבודה עם נפח, הטיפול בביצועים חלקיים ובביטולים. מקבעים את הכללים שהבוט מחויב לפעול לפיהם, ואת נקודות המחלוקת בלוגיקה.
- סכמת האינטראקציה עם הבורסה. קובעים מה מתקבל בזרם, מה נדרש לפי לוח זמנים וכיצד מתאימים את ההזמנות שלנו למצב החשבון. מתאמים את הסכמה לפני כתיבת הקוד.
- הרשאות גישה ומפתחות. מפתח מונפק עם ההרשאות המינימליות הנדרשות, גישת מסחר וגישת מידע מופרדות, סודות נשמרים מחוץ למאגר ומוגבלים לפי כתובות.
- קו בדיקה. סביבה מבודדת עם מצב הדגמה של הבורסה ותיעוד זרם נתונים אמיתי. מריצים ביצוע חלקי, קטיעת חיבור, כשל בקשה, עלייה חדה בתנודתיות.
- בדיקות קבלה. מתאימים הזמנות לאותות האסטרטגיה, סטייה בין הפוזיציה המחושבת לזו שבפועל, זמן התגובה לאות, תקינות העצירה וההפעלה מחדש.
- מסירה לתפעול. מוסרים סכמה, רשימת הגדרות, נוהל הפעלה ושחזור לאחר תקלה, הוראות אבחון. מלווים את תקופת העבודה הראשונה.
ערכת האספקה: קונפיגורציות, סכמות, נהלים, הרשאות
את ערכת האספקה מרכיבים כך שאת הבוט ניתן יהיה לתפעל בלעדינו: מהנדס מהצוות שלך מקים את המתקן לפי התיאור, ולא לפי זיכרון המחבר. את כל המפורט מוסרים בקו שלך — במאגר ובבסיס הידע הפנימי, עם היסטוריית שינויים.
- קונפיגורציות של בוט המסחר — קבצים עם זוגות מסחר, גדלי פוזיציות, מגבלות סיכון ופרופילי סביבות (פרודקשן ובדיקה). לכל פרמטר תיאור, טווח מותר וערך ברירת מחדל.
- סכמת זרמי הנתונים — המסלול מציטוטי השוק ועד אישור ביצוע ההזמנה, עם נקודות כשל, זמני המתנה מקסימליים וסדר הניסיונות החוזרים.
- מדיניות גישה למפתחות — אילו הרשאות ניתנות לבוט בצד KuCoin, מסחר ללא משיכת כספים, הצמדה לכתובות מהימנות, סדר סבב ושלילה בעת פגיעה.
- תיעוד עסקאות — רשומות מובנות לכל הזמנה: פרמטרי כניסה, ביצוע בפועל, עמלה, סיבת דחייה. ייצוא להתאמה עם היסטוריית הבורסה.
- נוהל תגובה לתקלות — מטריצת "תסמין → פעולה → אחראי": קטיעת זרם נתונים, הזמנה שנדחתה, סטיית יתרה, מעבר ידני של הבוט למצב בטוח.
- סדר עדכון וחזרה לאחור — כיצד מוצאת גרסה חדשה של הלוגיקה, היכן נשמרת הקונפיגורציה הקודמת וכמה צעדים נדרשים לחזור אליה.
בנפרד מגיעה מטריצת ההרשאות: מי מעובדיך רואה ומה משנה. בקבלה עוברים על כל סעיף יחד עם המהנדס שלך — המסמכים נבדקו בפועל, ולא רק נמסרו כקבצים.
מקרה בוחן: בוט על שלושה זוגות — מדדים לפני ואחרי
לפני העיבוד מחדש, הבוט סחר על שלושה זוגות דרך KuCoin, אך החזיק את החיבור בזרם סקר אחד. בעת קטיעת החיבור ההזמנות נותרו במצב לא מוגדר, שליחה חוזרת יצרה כפילויות, וסטיית הפוזיציות התגלתה ידנית — כבר לאחר סדרת עסקאות.
| מדד | לפני | אחרי |
|---|---|---|
| זמן שחזור לאחר תקלה | 20–40 דקות, ידנית | פחות מדקה, אוטומטית |
| כפילויות הזמנות בעת קטיעת חיבור | באופן קבוע | 0 לאורך כל תקופת התצפית |
| התאמת מצב מול הבורסה | אחת ל-1–2 ימים | כל 30 שניות |
| זיהוי כשל | לפי סטיית יתרה | התראה תוך 10–15 שניות |
מה שינו בקו
נתוני שוק ופקודות מסחר הופרדו לשני ערוצים בלתי תלויים: קטיעת זרם הציטוטים אינה חוסמת עוד הצבת הזמנות. כל הזמנה מקבלת מזהה לקוח, ולכן חזרה לאחר תקלה אינה יוצרת הזמנה שנייה, ומצב הפוזיציות מותאם מול הבורסה לפי יומן העסקאות, ולא לפי מטמון מקומי.
הניטור של קו המסחר בנוי על שלושה אותות: השהיית תגובה לפקודה, סטיית יתרה וחלק ההזמנות שנדחו. חריגה מהסף מכבה את המסחר בזוג המסוים ושולחת התראה — במקום מסחר עיוור הבוט עוצר. זמן השחזור לאחר תקלה חדל מלהיות פעולה ידנית.
במה שונה חיבור ישיר משכבת תיווך?
חיבור ישיר — הוא כאשר תהליך המסחר עצמו פונה אל KuCoin: מקבל יתרה, מציב ומסיר הזמנות, מאזין לעדכוני סטטוסים. פחות חוליות — האות מגיע לבורסה ללא החלפות מיותרות, והתנהגות הבוט מתוארת כולה בקוד אחד.
מחיר הפתרון — כל היכולת לצפות חי בתוך אותו תהליך: יומנים, מוני כשלים וניסיונות חוזרים יש להטמיע בתוך האסטרטגיה עצמה.
שכבת תיווך מוציאה את החילוף עם הבורסה לרכיב נפרד. האסטרטגיה מפרסמת כוונה, השכבה בודקת מגבלות, מקצה מזהה לפעולה, שולחת בקשות, מנהלת יומן מצבים וחוזרת על משלוח בעת קטיעת חיבור. הזמנות, ביצועים חלקיים וביטולים הופכים לאירועים עם היסטוריה — עבור כל אחד מהם אפשר לשחזר מה ומתי קרה. בד בבד מוסרת התלות בפלטפורמה אחת: החלפת בורסה נוגעת במתאם, ולא בלוגיקת האסטרטגיה.
ההבדל מתגלה בליווי האינטגרציה. חיבור ישיר מתוקן מהר יותר: שינו כלל — הוציאו גרסה, וזה הכל. אך ניתוח תקלה הופך לחיפוש ביומן של תהליך אחד, ולעתים קרובות אי אפשר לשחזר תקלה על ההיסטוריה.
לשכבה יש יותר רכיבים ותפעולה יקרה יותר, אך היכולת לצפות בבוט המסחר הופכת לשגרתית: רואים את חלק ההזמנות שנדחו, את הזמן מהאות ועד אישור הבורסה, ואת הסטייה בין היתרה המחושבת לזו שבפועל.
הבחירה אינה בינארית. באסטרטגיה אחת ותיקונים נדירים מספיק חיבור ישיר עם תיעוד קפדני. כאשר יש כמה אסטרטגיות, המסחר מתנהל ברציפות ונדרשת ביקורת של כל פעולה, עדיפה שכבה דקה: הביצוע נשאר ישיר, ולמעלה מוציאים רק את מה שמעניק שליטה והיסטוריה.
ספקות טכניים: מגבלות, מפתחות, עמידות בכשלים
לפני ההתחלה, המהנדסים של הלקוח בודקים לא את רווחיות האסטרטגיה, אלא את התנהגות המערכת בגבול הכשל: מה יקרה לפוזיציות פתוחות אם החיבור יאבד ברגע העסקה.
את החיבור ל-KuCoin דרך API אנחנו בונים כך שהחלטות קריטיות יתקבלו בצד הבורסה, ולא בתוך התהליך שלנו — להלן שאלות שבדרך כלל עולות לפני ההתחלה.
אילו הרשאות להנפיק למפתח המסחר?
רק מסחר וקריאת יתרה: משיכת כספים מנותקת בהגדרות המפתח ואינה מופעלת לעולם. את המפתח מצמידים לפי IP של השרת ושומרים במאגר מאובטח, ולא לצד הקוד.
מה עושה הבוט בעת הגבלת תדירות בקשות?
הבקשות עוברות בתור בהתחשב במשקל המתודה, ולא לפי טיימר קשיח. סמוך למגבלה המערכת מורידה את תדירות הסקר ומעלה את עדיפות ביטול ההזמנות והגנת הפוזיציה — ההזמנה אינה נותרת ללא שליטה.
מה קורה בעת כשל בתקשורת?
כל הזמנה מקבלת מזהה משלה, ולכן חזרה לאחר חיבור מחדש אינה יוצרת כפילות. המצב נכתב ליומן על הדיסק, הזמנות סטופ ממוקמות בצד הבורסה, ולכן פוזיציות פתוחות שורדות נפילה של התהליך.
כיצד מתבצע השחזור לאחר כשל?
מתאימים את היומן מול העסקאות בפועל: פוזיציות נלקחות לליווי, סטיות מוציאות לדוח להחלטה ידנית ומתרים את המהנדס. כך המערכת חוזרת לעבודה ללא הרכבה ידנית של המצב.
נדון במשימה ונחזור עם הערכה ותוכנית עבודה
כדי לדון במשימת האינטגרציה בצורה עניינית, ולא "בהערכה לפי העין", נדרש סט מינימלי של נתוני מקור — את השאר המהנדסים שלנו יבהירו בעצמם.
- תיאור לוגיקת המסחר: לפי אילו אותות, באילו זוגות ובאיזו תדירות הבוט פותח וסוגר פוזיציות;
- מצב נוכחי: יש קוד מוכן שכרגע עובד ידנית, או שהאינטגרציה עם KuCoin נבנית מאפס;
- אילו נקודות קצה כבר מעורבות — הצבת הזמנות, יתרות, היסטוריית עסקאות, זרם ציטוטים;
- כיצד בנויים מפתחות הגישה: היכן נשמרים, מי מסובב אותם, האם נדרש שלב ידני למשיכת כספים;
- מצב עבודה: קו בדיקה של הבורסה, חשבון אמיתי או מעבר הדרגתי מאחד לשני;
- מגבלות תדירות בקשות ועומס, כדי שהבוט לא ייתקל בדחיות מהבורסה ברגע של תנודתיות.
בתגובה תקבלו הערכה ותוכנית עבודה: הרכב השלבים, סדר ההתחלה ונקודות שבהן נדרשת הוולידציה שלך. גבולות האחריות מקבעים מיד — בצד שלנו האינטגרציה, הטיפול בכשלים ובחזרות, תיעוד העסקאות, הגנת המפתחות והיכולת לצפות; בצד שלך — אסטרטגיית המסחר, ניהול הסיכונים והחלק המשפטי.
תארו את המשימה ושלחו את מה שיש — נחזור עם הערכה, תוכנית וסדר התחלה.