אינטגרציה של Copper.co API: היכן נשברת סליקה מחוץ לבורסה
על הנייר סליקה מחוץ לבורסה נראית ישרה: הנכס מוחזק במשמורת, העסקה מבוצעת בבורסה, וההעברה נסגרת בסוף היום. בסביבת העבודה הכול נשען על סטטוסים — אינטגרציה של Copper.co API נחשבת להשלמה רק כשהאישור מגיע משני מקורות בלתי תלויים: ממרשם המשמורת ומהמערכת המסחרית של הבורסה.
זה נשבר בממשק. התראה על שינוי סטטוס מגיעה לפני שהבורסה רשמה אצלה את הביצוע, והתשובה לבקשה לא מגיעה בזמן שהוקצב. הלקוח חוזר על הקריאה — ובלי הגנה מכפילויות נוצרת במרשם פעולה שנייה לאותה עסקה. מכאן התאמה תקועה: חלק מהפוזיציות מסומנות כפתוחות משני הצדדים, וחלק — כסגורות רק אצל המשמורת.
המחיר של חוסר סנכרון כזה נמדד לא בשניות אלא בסיכונים. מגבלות על צד נגדי ועל מכשיר מחושבות לפי יתרה מיושנת, הבטוחות לא מתיישבות עם הפוזיציות בפועל, והדיווח לסוף היום דורש הסברים ידניים. הגרוע מכל הוא שהפער לא נראה בבקרה השוטפת עד ליתרה הראשונה שלא מתיישבת.
אנחנו מתחילים ממפת מצבי העסקה: אילו מעברים ה־API מספק, היכן האישור מגיע באופן אסינכרוני, והיכן נדרש לבדוק אותו באופן יזום. בהמשך — חזרות על קריאות שלא יוצרות כפילויות, התאמה אוטומטית של מרשמים לפי לוח זמנים, וטיפול בפערים לפני שהם נכנסים לדיווח. בהמשך נפרט איך זה נסגר.
מה נותנים משמורת וסליקה מחוץ לבורסה
הנכסים נשארים בחשבון המשמורת, ולא במאזן הבורסה: העסקה מבוצעת, אבל הכספים לא עוזבים את מעגל המשמורת עד לרגע הסליקה מחוץ לבורסה. הפלטפורמה רואה רק את הפוזיציה הסופית, ומפתחות ומדיניות חתימה לא מועברים לצד שלה. לכן פגיעה בחשבון המסחר לא נותנת גישה לנכס עצמו — אפשר לגנוב גישה, אבל לא למשוך.
האפקט נמדד במדדים תפעוליים. שיעור הפעולות בלי התערבות ידנית עובר את 90%: קבלה, הקצאה ומשיכה מתנהלות לפי כללים, ובן אדם מתערב רק בעסקאות שאינן בתבנית. התאמת פעולות מפסיקה להיות משימה שבועית — פוזיציות מותאמות אוטומטית לפי מזהי עסקאות, ופערים צפים באותו יום, ולא בתקופת הדיווח.
מגבלות משיכה נקבעות במדיניות, ולא בהרגל של המפעיל: רשימת כתובות מורשות, ספי פעילות יומיים, וחתימה שנייה חובה על סכומים מעל למוגדר. זה מסיר סוג שלם של כשלים — כתובת שגויה, משיכה לארנק לא מאומת, ואובדן חד־פעמי בעת דליפת מפתח אחד.
תרחיש נפרד — אי־זמינות של הבורסה. בעת עצירת מסחר או השהיית משיכות, הנכסים לא חסומים: הסליקה ממשיכה להתבצע בזירות האחרות, ומשיכת חירום מהמשמורת מתבצעת לפי נוהל שסוכם מראש עם כמה חתימות.
את האינטגרציה של Copper.co אנחנו בונים סביב התרחישים האלה: חיבור ל־API, התאמה בין הרישום הפנימי למזהי המשמורת, ומעגל בדיקות עם הרצה של נהלי חירום. בסוף — מטריצת הרשאות וספים, שממנה רואים מי ומה יכול לחתום.
מצבי חיבור למשמורת ואפשרויות סליקה
מצב החיבור קובע היכן פיזית נמצאים הנכסים ברגע העסקה ומי אחראי להעברתם. אינטגרציה ישירה עם Copper.co דרך API מנהלת סליקה לפי כתובות נפרדות: כל תנועה חתומה ומופיעה בדף חשבון, וההתאמה מתבצעת לפי יומן חיצוני. תוכנית עם מאגר נכסים משותף מפחיתה עלויות תנועה, אבל דורשת רישום פנימי שחייב להתיישב עם המשמורת.
| אפשרות | מתי מתאימה | מגבלות סליקה |
|---|---|---|
| חיבור ישיר למשמורת | נדרשים רישום נפרד וביקורת לכל לקוח | המתנה לאישורים ברשת, חלק מהנכסים אינם זמינים למשיכה מיידית |
| מאגר נכסים משותף | הרבה עסקאות קטנות, חשוב לצמצם תנועות | פער בין היתרה הפנימית למשמורת לאחר תקלה מטופל ידנית |
| ClearLoop | מסחר בזירה בלי להוציא כספים מהמשמורת | לא כל הנכסים והזירות נתמכים, יש מגבלות על נפח וחלון סשן |
| ארנק הבורסה | אב טיפוס, נפחים קטנים | הנכסים במאזן הזירה, החזרה רק לפי התקנון שלה |
ClearLoop מסיר את הסיכון המרכזי: הנכס לא עוזב את מעגל המשמורת, והזירה מקבלת רק אישור על בטוחות. הסליקה מוגבלת לרשימת הנכסים הנתמכים ולזמן סשן המסחר — בעת ניתוק בין המשמורת לבורסה, ייתכן שההזמנה לא תיסלק.
את מגבלות הסליקה קובעים שלושה דברים: סט הנכסים, חלון הסשן ומגבלת הנפח. אנחנו בודקים תאימות של כל זוג לפני תחילת האינטגרציה, אחרת את העסקה יהיה צריך לנהל במצב אחר.
סדר היישום: מביקורת ועד מסירה לעבודה
ClearLoop מעביר את הסליקה מהבורסה למעגל המשמורת: הנכסים נשארים בחשבון אצל Copper.co, הזירה המסחרית מקבלת רק מסגרת מוקצית, והקיזוזים נסגרים בסוף החלון. מחיר הטעות כאן גבוה יותר מאשר באינטגרציה רגילה: הקצאה שתכנונה שגוי משחררת יותר מהנדרש, והפער צף כבר בהתאמה. לכן העבודה מתבצעת בשלבים, וכל שלב מסתיים בארטיפקט שניתן לבדוק, ולא בהסכמה בעל פה.
- ביקורת של תוכנית הסליקה. מפרקים איך כיום נעים הכספים בין המשמורת, הבורסות והרישום הפנימי: מי יוזם העברות, היכן נשארים עקבות של פעולות, ואילו מגבלות הוגדרו ידנית.
- תרשים זרימות. מרכיבים מפה: תת־חשבונות, הקצאות לכל זירה, מסלול ההזמנה, החזרת היתרה, ונקודות שבהן אפשרי נתק בין מצב המשמורת למצב הבורסה.
- תכנון האינטגרציה. קובעים אילו קריאות מתבצעות בזמן אמת, אילו — בקבוצות, איך מטופלות בקשות חוזרות בלי כפילויות, ומה מאשר את תוצאת ההתאמה.
- הגדרת הרשאות. מפרידים בין הרשאות מסחר להרשאות משיכה בין תפקידים, מפעילים אישור דו־שלבי, ומגדירים תיעוד יומן והתראות על כל פעולה עם מגבלה.
- בדיקה על נפחים קטנים. מריצים מחזור מלא — הקצאה, עסקה, החזרה, קיזוז — על סכומים מינימליים, ומתאימים כל פוזיציה בשני הצדדים. טעויות בשלב הזה זולות, במעגל הייצור — לא.
- מסירה וליווי. מוסרים תקנונים, תצורות, נוהל חזרה אחורה וסט מדדים: פער התאמה, זמן אישור הקצאה, ושיעור קריאות שנדחו.
תארו את תוכנית הסליקה הנוכחית — נחזור עם הערכה ותוכנית שלבים.
תצורות, תרשימים ותקנונים: מה נשאר אצלכם
אחרי היישום נשאר אצלכם לא «גישה לפלטפורמה», אלא ערכת ארטיפקטים עובדת: לפיהם משמרת תורנית סוגרת תקלה בלי לפנות אלינו, ומהנדס חדש נכנס לפרויקט תוך ימים ולא שבועות. הכול נשמר במאגר שלכם, במאגר הסודות ובבסיס הידע — עם ניהול גרסאות והיסטוריית עריכות.
- תצורות חיבור — פרמטרים של סביבות, רשימת משתנים, כללי אחסון מפתחות חתימה: רק במאגר סודות, עם רוטציה לפי לוח זמנים.
- מטריצת הרשאות — מי רשאי ליזום העברה לסליקה, מי מאשר במפתח שני, מי רואה רק יתרות; הרשאות מפתחות API מוגבלות לרשימת כתובות ולסט פעולות.
- תרשים זרימות כספים — מסלול הנכס מהפקדה עד סליקה מחוץ לבורסה: היכן הוא נמצא ב־custody, באיזה רגע מחליף מחזיק, ואילו אירועים מתעדים זאת.
- תקנון התאמה — מה ובאיזו תדירות מתיישב עם תפוקות, סף פער מותר, ונוהל הסלמה בחריגה ממנו.
- תיעוד האינטגרציה — חוזי בקשה ותשובה, קודי שגיאה, מפתחות אידמפוטנטיים ואסטרטגיית ניסיונות חוזרים לכל תרחיש כשל.
- הוראות למשמרת תורנית — פעולות שלב אחר שלב בעת timeout, בקשה שנדחתה, סליקה תקועה ושלילת מפתח, עם ציון את מי להעיר.
- נהלי רוטציה ושלילה — החלפת מפתחות בלי השבתה, ניתוק הרשאות עם עזיבת עובד, וצ'ק־ליסט מסירת משימות לצוות אחר.
אנחנו מוסרים הכול עם הסבר: מראים לפי איזה ארטיפקט בודקים מה ברגע תקלה, ומקבעים אחראים לכל תקנון בצד שלכם.
מקרה בוחן: סליקה מחוץ לבורסה בלי פעולות תקועות
לקוח — חברת מסחר שהחזיקה בטוחות בכמה זירות, ובכל בוקר התאימה יתרות במשמורת ובחשבון הבורסה. ההתאמה נעשתה ידנית לפי תפוקות: 4–6 שעות עבודה, והפער צף רק אחרי פתיחת הסשן. אחד מכל עשרים מחזורי סליקה נתקע: חלק מהפוזיציות אי אפשר היה לסגור עד למחרת, וזה נתקל במגבלות סיכון.
מה שינו: העבירו את הסליקה למצב מחוץ לבורסה דרך Copper.co ClearLoop — הנכסים נשארים במשמורת, והעסקאות נסגרות בחשבונות מראה בלי להעביר בטוחות לזירה. האינטגרציה נבנתה על API: לכל הזמנה יש מזהה משלה, בקשה חוזרת יוצאת עם אותו מפתח, ולכן ניתוק קשר לא יוצר כפילות עסקה או חיוב כפול. המצבים נמשכים באמצעות אירועים, והפער נתפס ברגע הופעתו, ולא בהתאמת הבוקר.
מדדים לפני ואחרי
| מדד | לפני | אחרי |
|---|---|---|
| סגירת סליקה | 4–6 שעות | 12–20 דקות |
| כשלי סליקה | מחזור אחד מתוך 20 | אף אחד ברבעון תצפיות |
| התאמת משמורת וחשבון הבורסה | ידנית, פעם ביום | אוטומטית, לפי כל אירוע |
סוג הכשלים בהתאמה נעלם כולו: הפער כבר לא שורד עד הבוקר, כי הפוזיציה במשמורת ובחשבון הבורסה מתיישבת בזרימת אירועים אחת. אפקט נפרד — יומן: לכל סליקה רואים הזמנה, חשבון וסטטוס, ולכן טיפול בתקלה או בקשה מביקורת נסגרים תוך דקות, ולא תוך ימים.
מקרה הבוחן של האינטגרציה מראה את העיקר: הערך כאן אינו בחיבור עצמו ל־API, אלא באופן שבו בנויים ניסיונות חוזרים, אירועים וגבולות אחריות בין המשמורת לבורסה. תארו את מערך הזירות והנכסים שלכם — נחזור עם הערכה ותוכנית עבודה.
במה שונה אינטגרציה דרך משמורת מסליקה בבורסה?
בסליקה בבורסה, כספי הלקוח נמצאים בחשבון הבורסה: כדי לבצע עסקה, צריך להעביר את הנכס לכתובת הבורסה ולהחזיק אותו שם עד למשיכה.
כל עוד הכספים בבורסה, הם כפופים לכללים שלה — בדיקת ציות יכולה לעכב משיכה, מחיקת זוג מהמסחר סוגרת את הפוזיציה בכפייה, ותקלה טכנית משאירה את ההון חסום בלי גישה מבחוץ.
סליקה מחוץ לבורסה בנויה אחרת — מנגנון כזה, בין היתר, מיישם Copper.co: הנכסים נשארים בחשבונות נפרדים של המשמורת, הבורסה מקבלת רק זכות לבצע את העסקה, והאספקה מתבצעת בהעברה בין ארנקים בשליטת המשמורת.
מפתחות האחסון לא מועברים לבורסה, ולכן סיכון חסימת כספים בצד הבורסה נעלם, ומגבלות משיכה מפסיקות להשפיע על הסליקה.
ההבדל מתגלה בתפעול. בתוכנית בורסאית כל תנועה היא טרנזקציה נפרדת עם אישור ידני והתאמת מאזנים, ובמצב המשמורת API מפעיל סליקה לפי אירוע, התראות מחזירות סטטוס אספקה, והפער ביתרות נראה מיד. זה מפחית את היקף הפעולות הידניות ומסיר את החלון שבו ההון נמצא מחוץ לשליטתכם.
ספקות טכניים: הרשאות, מגבלות, עמידות
הרשאות גישה, מגבלות והתנהגות בעת תקלה נבדקות לפני שדרך ClearLoop תעבור העסקת הסליקה הראשונה. בהמשך — מה שבדרך כלל צף בשלב החיבור ל־Copper.co ודורש החלטה בארכיטקטורה, ולא אחרי העלייה לעבודה.
איך מופרדות הרשאות גישה?
מפתחות מונפקים לפי תפקיד, ולא «לשירות כולו»: למערכת המסחר — רק הצבת הזמנות וביטולן, למערכת הדיווח — קריאת יתרות והיסטוריית עסקאות, והרשאת משיכה לאוטומציה לא ניתנת בכלל.
כל מפתח מקושר לכתובות קבועות, והרוטציה מתבצעת עם חלון חפיפה — החלפת מפתח לא מפילה שירות פעיל ולא דורשת עצירת סליקות.
אילו מגבלות פעולות צריך לקבוע מראש?
המגבלות מגיעות בשכבות: תדירות פניות בצד ספק המשמורת, מגבלות על גודל ומספר הזמנות בבורסה, וחלונות סליקה של ClearLoop. אנחנו מציבים תור בקשות עם בקרת תדירות וניסיונות חוזרים, ומפזרים פעולות קבוצתיות לאורך זמן — פרץ פעילות לא הופך לדחיות בגלל מגבלות ברגע סגירת פוזיציות.
מה קורה בעת תקלה בבורסה או במשמורת?
הנכסים נשארים בחשבון המשמורת, ולא במאזן הבורסה, ולכן אי־זמינות של זירת המסחר לא משמעה אובדן גישה לכספים. כל פעולה מסומנת במזהה משלה: בקשה חוזרת לאחר ניתוק קשר לא יוצרת עסקה כפולה.
עם חידוש החיבור מופעלת אוטומטית התאמת מצבים — פער בפוזיציות וביתרות נראה בדוח, ולא מתברר ידנית לפי פירוטים.
נדון במשימה ונחזור עם הערכה ותוכנית
כדי שהערכת האינטגרציה תישען על עובדות ולא על הנחות, נתחיל בשיחה עניינית. תארו את המשימה: אילו פעולות צריכות לעבור דרך ClearLoop, אילו צוותים עובדים עם הפלטפורמה, ואילו מערכות כבר מחוברות לרישום הנכסים.
כדאי להכין:
- רשימת תרחישים — מה עובר ל־off-exchange settlement ומה נשאר ב־custody;
- רשימת מערכות משתתפות: מערכת המסחר, רישום פנימי, דיווח, בקרת סיכונים;
- דרישות להרשאות ולהפרדת זכויות — מי ואילו פעולות יכול ליזום;
- מגבלות על מצב העבודה: חלונות מסחר, תקנון התאמה, חלונות תחזוקה;
- בקשות לניטור: אילו אירועים ובאיזו רמת פירוט צריך לראות;
- אנשי קשר מצד הפלטפורמה והצוותים הפנימיים, כדי לא לבזבז זמן על תיאומים.
זה מספיק כדי לחזור עם תוכנית עבודה: שלבי חיבור ובדיקות, סדר העלייה לייצור, הרכב התיעוד הנמסר, ונקודות שבהן נדרש אישור מצדכם. את ההערכה ניתן בטווח לפי שלבים, ונציין בנפרד מה משפיע עליה — בלי הנחות נסתרות ובלי סעיפים «תקועים».
תארו את המשימה בצורה נוחה לכם: תיאור קצר, תרשים זרימות או התכתבות עם צוות הפלטפורמה. זה יספיק כדי לדון בפרטים ולחזור עם הערכה ותוכנית.