מדוע הבוט מאבד פקודות ב-Coinbase Advanced Trade API
האינטגרציה של בוט מסחר עם Coinbase Advanced Trade API נשברת לא באסטרטגיה, אלא בנקודת החיבור עם הבורסה. הפקודה נשלחת, התשובה מגיעה, אך מצב הפוזיציה אצל הבוט ואצל הבורסה אינו תואם — וכל עסקה הבאה מחושבת מבסיס שגוי.
נקודת הכשל הראשונה — חוסר סנכרון בין הסטטוסים. התשובה לשאילתה וזרם האירועים אינם מגיעים בו-זמנית: הבוט מחזיק פקודה כפתוחה כאשר היא כבר בוצעה, או ממתין לאישור עבור עסקה שבוטלה.
ביצוע חלקי מחמיר את התמונה: הבוט רואה את המקטע הראשון, מחשיב את הנפח כשלם ובונה פוזיציה על הנייר, בעוד היתרה ממשיכה להצטבר בספר הפקודות.
השנייה — כפילויות לאחר ניתוק החיבור. החיבור נקטע בין שליחת הפקודה לקבלת התשובה, הבוט חוזר על הבקשה ופותח פוזיציה שנייה במקום אחת. את הבעיה פותרים מזהה לקוח לצורך אידמפוטנטיות ויומן כוונות, הנכתב לפני השליחה ולא אחריה.
השלישית — פקודות שנדחו, שסיבתן אינה מנותחת על ידי הבוט. המגבלה על סוג הפקודה, הגודל או המחיר מגיעה בגוף התשובה, אך האוטומציה רואה רק קוד שגיאה ומחזירה על הניסיון באופן עיוור.
בדיווח זה יוצר אי-התאמה של עסקאות: מספר הביצועים והנפח אינם תואמים את היומן, והפוזיציה מתבררת כגדולה מהאמיתית. להלן נסביר כיצד זה נסגר ברמת החילוף עם הבורסה.
אפקט מדיד: מה משתנה לאחר הגדרת האינטגרציה
הבוט עובד עם Coinbase Advanced Trade דרך הממשק התקני של הבורסה, ולכן אין צורך לנחש את מצב הפקודה: הסטטוס, הנפח והיתרה מגיעים בתשובה לשאילתה, ולא משוחזרים לפי סימנים עקיפים. להלן — מה בדיוק משתנה בתפעול וכיצד זה נמדד.
שלמות הביצוע והתאמה אוטומטית של עסקאות
הפקודה מובאת למצב סופי: ביצועים חלקיים נאספים לפי העסקאות בפועל ואינם הולכים לאיבוד בעת התחברות מחדש. ההתאמה מתבצעת לפי יומן האירועים — פוזיציית הבוט והיתרה בצד הבורסה תואמות בכל איטרציה, ואי-ההתאמה צפה מיד, ולא בסוף המשמרת.
| מדד | לפני ההגדרה | אחרי |
|---|---|---|
| פקודות עם סטטוס סופי מאושר | 85–90% | ~100% |
| התאמות ידניות למשמרת | 5–10 | 0 |
| ניתוח אי-התאמת פוזיציה | שעות | דקות |
עמידות בפני ניתוקי חיבור ועומסי שיא
ניתוק חיבור, כשל בבקשה, חריגה ממגבלת הפניות — כל סוג מטופל בנפרד: הבוט מכניס את הפעולה לתור, חוזר עליה ללא שכפול עסקאות וממשיך לעבוד מאותו מצב. החזרות אידמפוטנטיות, ולכן כשל ברשת אינו הופך לפקודה כפולה, והתפרצות פעילות אינה מביאה להחמצת אותות.
תיעוד האירועים מתבצע באופן מקצה-לקצה: לכל פעולה יש חותמת זמן וסיבה, ולכל תשובת בורסה — קישור לבקשה. לפי יומן כזה, תקלה מנותחת בדקות, ולא מסופרת מחדש מהזיכרון.
API מסחר, החלפה בקבצים או עסקאות ידניות: השוואה
אופן החיבור בין לוגיקת המסחר לבורסה קובע עד כמה מהר המערכת מגיבה לשוק וכמה סיכונים עוברים לתשתית. בפועל בוחרים בין שלושה מצבים: חיבור ישיר באמצעות מפתחות מסחר דרך Coinbase Advanced Trade API, החלפה באמצעות ייצוא לקבצים ומצב חצי-אוטומטי שבו ההחלטה הסופית נשארת בידי האדם.
| אפשרות | מתי מתאימה | מגבלות |
|---|---|---|
| חיבור ישיר באמצעות מפתחות מסחר | נדרשת תגובה לאירוע בתוך שניות, זרם הבקשות קבוע | מפתחות המסחר מאוחסנים בשרת: נדרשים בידוד, רוטציה, חשבון נפרד ומגבלות על משיכה |
| החלפה באמצעות ייצוא (החלפה בקבצים) | תדירות עסקאות נמוכה, האסטרטגיה מחושבת מחדש פעם בשעה או לעתים רחוקות יותר | השהיה בין האות לביצוע, התאמה ידנית של אי-התאמות, סיכון לשכפול בקשה בייבוא חוזר |
| מצב חצי-אוטומטי | ההחלטה תלויה בהקשר שקשה לנסח אותו בכללים | תפוקה מוגבלת על ידי האדם, הביצוע תלוי בזמינות המפעיל |
חיבור ישיר באמצעות מפתחות מסחר
המפתחות נוצרים לחשבון נפרד עם הרשאות מצומצמות: מסחר מותר, משיכת כספים — לא. בקשות מסומנות במזהה משלנו, כדי ששליחה חוזרת לאחר ניתוק ברשת לא תפתח פוזיציה שנייה, ואת מצב הפקודות מתאימים מול הבורסה לפי לוח זמנים. שגיאות חיבור ובקשות שנדחו נרשמות ביומן עם הסיבה — ניתוח התקלה אורך דקות, ולא שעות.
מצב חצי-אוטומטי עם אישור אנושי
את האות מחשבת המערכת, את השליחה מאשר המפעיל — זה מסיר את סוג השגיאות של "גודל פוזיציה שגוי" ו"פעל על נתונים מיושנים". המחיר של השליטה הוא השהיה באישור: בקטע תנודתי חלק מהמחיר הולך לאיבוד בתנועה. המצב מוצדק כל עוד זרם העסקאות קטן וההחלטות דורשות הקשר שאינו מתואר בכללים.
שלבי ההטמעה: מבדיקת המפתחות ועד מסירת הנהלים
אינטגרציה של בוט עם Coinbase Advanced Trade API לעתים רחוקות מסתכמת בקריאה אחת: הרשאות המפתח, המגבלות על הצמדים וההתנהגות בביצוע חלקי קובעים אם הוא ישרוד את השוק האמיתי. לכן העבודה מתבצעת בשלבים, וכל אחד מסתיים בתוצאה ניתנת לבדיקה, ולא בסטטוס "בתהליך".
ביקורת הסכמה הנוכחית והרשאות הגישה
- ביקורת מפתחות מסחר: אילו פעולות מותרות, האם למפתח יש משיכת כספים, היכן מאוחסנים הסודות וכיצד מתבצעת רוטציה. בתוצאה — מפת גישות ורשימת הרשאות מיותרות, שאותן מסירים לפני תחילת העבודות.
- תכנון הזרימות: מסלול הבקשה מהאות ועד האישור, ההתנהגות בביצוע חלקי, בביטול ובניתוק חיבור. מתעדים את מצבי הפקודה ואת אלו מהם שאנו מחשיבים כסופיים.
- עיבוד תשובות הבורסה: מתאימים את קודי הדחייה לפעולות הבוט — חזרה עם אותו מזהה, המתנה, עצירה. בנפרד סוגרים את אי-ההתאמה בין המצב המקומי למצב הבורסה.
בדיקה על נתונים היסטוריים ובסביבת בדיקה
- הרצה על נתונים היסטוריים: מזינים את זרם הציטוטים המוקלט ומשווים את העסקאות המחושבות לאלו בפועל — שגיאות הלוגיקה נראות עוד לפני היציאה לחשבון אמיתי.
- סביבת בדיקה: משחזרים מגבלות על תדירות הפניות, השהיות וביצועים חלקיים, כדי לתפוס תרחישים שאינם קיימים בהיסטוריה.
- הרצה תחת עומס: ההתנהגות בהתפרצויות פעילות ובשחיקת החיבור, זמן ההתאוששות לאחר ניתוק.
- מסירת נהלים: תיעוד על המפתחות והרוטציה, סכמת הזרימות, כללי התגובה לדחיות ונוהל עצירה ידנית.
ערכת מסירה: קונפיגורציות, סכמות זרימה, נהלים
ערכת התיעוד בעת המסירה היא לא תיקיית קבצים, אלא כלי עבודה של משמרת התורנות. אנו מנהלים אותו עם גרסאות: לכל סעיף יש בעלים, תאריך התאמה עם הקונפיגורציה האמיתית וציון מה בדיוק נבדק.
מדיניות גישה והפרדת הרשאות
מפתחות ל-Coinbase Advanced Trade API מפרידים לפי ייעוד: קריאת חשבונות, הצגה וביטול פקודות, משיכת כספים. הרשאות משיכה לא ניתנות למעגל המסחר, ולכן פגיעה במפתח העבודה אינה פותחת גישה ליתרה, והרוטציה מתוארת כנוהל עם ביטול המפתח הישן.
- קונפיגורציות עבודה של הסביבות: כתובות חיבור, מגבלות על גודל ותדירות הפקודות, פרמטרים של ניסיונות חוזרים.
- סכמת זרימות הנתונים: המסלול מזרם השוק ועד רישום העסקה בספרים, עם נקודות של אובדן או שכפול אפשריים.
- מטריצת הרשאות: למי ניתן איזה מפתח, לכמה זמן, מי מאשר את הביטול.
- יומני אירועים: מה נרשם באופן חובה — בקשה, תגובה, דחייה, שינוי יתרה — וכמה זמן נשמר.
- נוהל טיפול בתקלות: רשימת המצבים והסימנים שלפיהם התורן מזהה כל אחד מהם.
- הוראה למשמרת: פעולות שלב-אחר-שלב, נקודות הסלמה, איסור על תיקונים ידניים של המצב ללא רישום ביומן.
נוהל פעולות בעת תקלה וניתוק חיבור
ניתוק חיבור עם הבורסה וכשל של השירות שלנו דורשים פעולות שונות, ולכן בנוהל הם מופרדים. כסעיף נפרד מופיעה התאמת הפוזיציות לאחר ההתאוששות: בלעדיה הבוט יציג פקודה כפולה, לאחר שיחשוב שהקודמת לא עברה.
את הערכה משלימים במהלך מחזור התפעול הראשון — במקומות שבהם הניסוחים התבררו כלא שלמים בעת ניתוח תקלות אמיתיות.
מקרה בוחן: התאמת עסקאות ועמידות הבוט תחת עומס
הלקוח — צוות עושי שוק הסוחר במספר צמדים דרך Coinbase Advanced Trade. הבוט הציג פקודות, אך מצב הפוזיציות תאם את דוחות הבורסה רק באופן ידני: ההתאמה הורצה פעם ביממה, ולכן אי-ההתאמה באחד הצמדים נמשכה עד הבוקר הבא.
היה: התאמות ידניות ואי-התאמות בדוחות
שיעור הפקודות שלא בוצעו עמד על כ-4% — חלק מהבקשות נדחו בצד הבורסה, והבוט לא הבדיל בין דחייה בשל מגבלה לבין שגיאת רשת, וחזר על השליחה. מכאן הכפילויות: בשעות שיא עד 12 בקשות לאות אחד, ואת אי-ההתאמה בין היומן המקומי להיסטוריית העסקאות מצאו בממוצע תוך 40 דקות. האנליסט השקיע בהתאמה עד שש שעות בשבוע, וכל תקלה משמעה השבתת מסחר של 20–30 דקות.
נעשה: התאמה אוטומטית וטיפול ברור בשגיאות
חילקנו את קודי התשובה לזמניים וקבועים: חזרה נשלחת רק במקום שבו היא הגיונית, ופקודה שנדחתה בשל מגבלה חוזרת לתור עם חישוב מחדש של הנפח. ההתאמה האוטומטית מתבצעת באופן רציף ומשווה את המצב המקומי למצב הבורסה לאחר כל סגירת בקשה, ולא פעם ביממה.
שיעור הפקודות שלא בוצעו ירד ל-0.3%, הכפילויות נעלמו, זמן גילוי אי-ההתאמה — שניות במקום 40 דקות. ההתאמות הידניות הצטמצמו ל-20 דקות בשבוע, והשבתת המסחר בתקלות — מחצי שעה ועד הפעלה מחדש של זרם אחד.
מה לעשות אם הבוט כבר סוחר, אך העסקאות אינן מתאמות?
אי-ההתאמה כמעט תמיד אינה באסטרטגיה, אלא באופן שבו הבוט לומד על גורל בקשתו. אם האישור לא הגיע בזמן, שליחה חוזרת יוצרת שכפול פקודות: בבורסה יש שתיים, בספרים — אחת.
המקור השני — ביצוע חלקי: הנפח נסגר במספר מנות, והבוט מחשיב את העסקה כיחידה ואינו מחשב מחדש את המחיר הממוצע ואת גודל הפוזיציה בפועל.
קודם כל, התאימו לא את המצב הפנימי של הבוט, אלא את יומן העסקאות בצד Coinbase Advanced Trade API. מקור האמת הוא המנות שבוצעו והיתרה הסופית, ולא מה שהבוט רשם לעצמו בזיכרון.
לאחר תקלות במסחר — ניתוקי חיבור, הפעלה מחדש של התהליך — הסיבה היא בדרך כלל באירועים שאבדו ובהיעדר מזהה ייחודי לפקודת הלקוח, שלפיו ניתן לזרוק את הבקשה החוזרת.
הסכמה העובדת מבוססת על שליחה אידמפוטנטית: הבקשה מסומנת במזהה משלה, וחזרה איתה אינה יוצרת פקודה חדשה. המצב השוטף מבוסס על זרם האירועים, וכל כמה דקות מתבצעת התאמה מלאה של פוזיציות, פקודות ועמלות עם היסטוריית הבורסה — כך אי-התאמת העסקאות נראית מיד, ולא כעבור יממה.
המעבר למעגל המתוקן מתבצע ללא עצירת המסחר. הלוגיקה החדשה מופעלת במקביל על אותם נתוני שוק במצב חישוב, ללא הצגת בקשות, ומושווית לתוצאות הנוכחיות; לאחר מכן עוברים כלי אחד בכל פעם, עם אפשרות להחזיר את הסכמה הקודמת.
ספקות טכניים נפוצים לפני תחילת העבודות
לפני ההתחלה מעלים בדרך כלל את אותן חמש שאלות — מהרשאות המפתח ועד להתנהגות הבוט כאשר הבורסה השיבה בשגיאה או קטעה את החיבור. להלן תשובות קצרות בנוגע ל-Coinbase Advanced Trade API; אם התרחיש שלכם רחב יותר, ננתח אותו בשיחה על המשימה.
אילו הרשאות לתת למפתח והאם ניתן לאסור משיכת כספים?
המפתח נוצר למסחר בלבד, ואפשרות המשיכה מושבתת בהגדרותיו. אם ההרשאות מצומצמות יותר מהנדרש, האינטגרציה נופלת כבר בהתחלה עם שגיאה ברורה — לפני הבקשה האמיתית הראשונה, ולא ברגע העסקה.
מה יקרה בעת ניתוק חיבור עם הבורסה?
הבוט מתחבר מחדש עם השהיה גדלה והולכת, ולאחר ההתאוששות מתאים את היתרות ואת הפקודות הפתוחות למצב החשבון בפועל. הבקשה נשלחת עם מפתח אידמפוטנטיות, ולכן שליחה חוזרת אינה יוצרת כפילות פוזיציה.
כיצד לבדוק את הלוגיקה לפני עסקאות אמיתיות?
העבודה מתבצעת בסביבת בדיקה: מריצים ביצוע חלקי, ביטול יתרה, דחייה בשל מגבלות פניות וניתוק סשן. רק לאחר מכן הבוט עולה לנפח מינימלי, שבו מתאימים את חישוב הפוזיציה לדוח הבורסה.
כיצד מטופל ביצוע חלקי?
המצב מנוהל עבור כל פקודה בנפרד: הבוט רושם את הנפח שבוצע, מחשב את היתרה ואינו מחשיב את הפוזיציה כסגורה עד לסטטוס הסופי. ביטול היתרה וכניסה מחדש אינם שוברים את הספרים.
כיצד מתבצעת רוטציה של מפתחות ומה כולל הליווי?
הגישות מאוחסנות בכספת סודות, החלפת המפתח מתבצעת ללא עצירת הבוט — הישן ממשיך לפעול עד לאפס תעבורה. הליווי של האינטגרציה: ניטור שגיאות הבורסה, התראות על אי-התאמת יתרה ובדיקות מתוכננות לאחר שינויים בצד זירת המסחר.
נדון במשימה: מה לשלוח להערכה ולתוכנית
כדי שהערכת לוחות הזמנים של האינטגרציה תתבסס על עובדות, ולא על "בערך כמו אצל כולם", נדרשים נתוני מקור להערכה לפי הסכמה שלכם. אוספים אותם לפני ההתחלה: כך איננו מבזבזים איטרציות על ניחושים כאשר הבוט כבר עומד על פקודות אמיתיות.
- תיאור הסכמה הנוכחית: היכן הבוט פועל, כיצד הוא מציג פקודות, כיצד הוא שומר את מצב הפוזיציות.
- ייצוא יומנים לתקופה — 2–4 שבועות של מסחר יחד עם דחיות ושגיאות, ולא רק עם עסקאות מוצלחות.
- רשימת הרשאות המפתחות: מה מותר, מה מושבת, האם יש מפתחות נפרדים לקריאה בלבד.
- גישות לביקורת — מפתחות לקריאה בלבד או ייצוא היסטוריית עסקאות, אם לא ניתן להעניק גישה מלאה.
- דוגמה לדוח הבוט: כיצד מחושבים מחיר הכניסה הממוצע, העמלות והפוזיציות הסגורות.
- תקלות ידועות: פקודות משוכפלות, חוסר סנכרון של פוזיציה, ניתוקי חיבור, דחיות מהבורסה.
- מגבלות על צמדי מסחר ותדירות פניות, אם כבר נתקלתם בהן.
- סביבת בדיקה: גישה לארגז חול או למפתחות בדיקה, אם היא כבר קיימת.
לאחר מכן — ניתוח הסכמה, איתור הקטעים שבהם האינטגרציה עם Coinbase Advanced Trade API מתנהגת אחרת מהצפוי, ותוכנית עבודה בשלבים: ביקורת, הרשאות מפתחות, עיבוד תשובות הבורסה, דיווח, קבלה בסביבת בדיקה.
נדון במשימה — תארו אותה בצורה חופשית. אם חלק מהנתונים עדיין אין, נתחיל ממה שיש, ונחזור עם הערכה ותוכנית.