אורקל מחירים לחוזים חכמים: מט״ח, זהב, מדדים ומניות on-chain

איך זה עובד

1. קבלו דוח חתום: GET /oracle/report עם מפתח ה-API שלכם.
2. שלחו אותו בעסקה שלכם: חוזה המאמת שלנו בודק את החתימה עם ecrecover.
3. השתמשו במחיר המאומת; דחו אותו אם הוא ישן מדי לשימוש שלכם.

הדוחות הם נתונים מוקלדים EIP-712 ‏PriceReport(bytes32 feedId,int256 price,uint64 timestamp,uint64 validUntil,uint8 marketStatus,uint32 spreadBps), קשורים לרשת אחת ולחוזה מאמת אחד (אין שימוש חוזר במקום אחר) ומתקבלים רק עד validUntil, כדקה אחרי החתימה (אי אפשר לאגור דוחות נוחים). המחירים הם האמצע בין קנייה למכירה עם 8 ספרות אחרי הנקודה; spreadBps הוא מרווח הקנייה-מכירה. כששולחים דוח בעסקה משלכם, אתם משלמים את הגז הזה. פידים מבוקשים נשמרים גם on-chain מדי פעם על ידי הממסר שלנו (קריאה בחינם), אבל תמיד בדקו את גיל המחיר השמור.

שעות מסחר

כל דוח מציין את מצב השוק: OPEN (מחיר חי, לכל היותר בן 60 שניות), CLOSED (המחיר הרשמי האחרון לפני הסגירה, זהה לכולם, נחתם בכל עת כל עוד השוק סגור) או HALTED (המסחר הופסק). getPriceNoOlderThan מחזיר רק מחירי OPEN, כך שמחיר סגירה לעולם לא ייחשב כמחיר חי. טוקנים מגובי נכסים צריכים לסלק פקודות שניתנו כשהשוק סגור לפי מחיר ה-OPEN הבא (תמחור קדימה, כמו שעושות קרנות ותעודות סל).

מפסק זרם

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

פידים

רשתות

כתובת החותם: 0x83fa2d8836525251FAd214A78A72038D0864f877. רשימה קריאה למכונה: /oracle/feeds.

שילוב

1. קבלת דוח חתום

curl -H "Authorization: Bearer $API_KEY" \
  "https://api.marketapi.app/v1/oracle/report?symbols=EURUSD&chain_id=10"

מחזיר report (הטאפל המקודד ב-ABI) ו-signature (65 בתים) לכל סימול. המפתח שלכם צריך את ההיקף read:oracle.

2. אימות בחוזה שלכם

interface IMarketApiOracle {
    struct PriceReport { bytes32 feedId; int256 price; uint64 timestamp; uint64 validUntil;
                         uint8 marketStatus; uint32 spreadBps; }
    function submit(PriceReport calldata r, bytes calldata sig) external returns (bool);  // verifies, stores if newer
    function getPriceNoOlderThan(bytes32 feedId, uint256 maxAge)
        external view returns (int256 price, uint64 timestamp);   // OPEN and fresh only, else reverts
    function getPrice(bytes32 feedId) external view
        returns (int256 price, uint64 timestamp, uint8 marketStatus, uint32 spreadBps);   // incl. CLOSED
}

contract MyVault {
    IMarketApiOracle immutable oracle;
    bytes32 constant EURUSD = keccak256("EURUSD");
    constructor(IMarketApiOracle o) { oracle = o; }

    function act(IMarketApiOracle.PriceReport calldata r, bytes calldata sig) external {
        oracle.submit(r, sig);                                       // reverts on a bad signature
        (int256 price, ) = oracle.getPriceNoOlderThan(EURUSD, 60);   // 8 decimals
        // ... use price ...
    }
}

צרכנים בסגנון Chainlink יכולים לקרוא פיד דרך MarketApiFeedAdapter ‏(latestRoundData(), ‏AggregatorV3Interface).

מחירון

5 קרדיטים לכל דוח חתום, בתשלום מיתרת ה-API הרגילה שלכם. קריאת מחירים שכבר שמורים on-chain היא בחינם.

שימושים לפידי המחירים on-chain שלנו

• נכסים שעברו טוקניזציה ו-RWA: תמחרו מניות שעברו טוקניזציה, טוקנים מגובי זהב ונכסים אחרים מהעולם האמיתי עם נתוני מחירים שמתחשבים בשעות המסחר.
• הלוואות DeFi ובטוחות: העריכו בטוחות מגובות מט״ח וסחורות עם מחירים טריים וניתנים לאימות ובדיקות עדכניות בטוחות לחיסולים.
• נכסים סינתטיים ו-FX on-chain: סלקו פוזיציות סינתטיות של מט״ח, מדדים וסחורות מול מחירי ייחוס חתומים.
• מטבעות יציבים ותשלומים: המירו בין מטבעות on-chain עם שערי EUR/USD, ‏GBP/USD ושערי מט״ח נוספים בזמן אמת.

למה אורקל משיכה חתום?

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

מומלץ: דפוס המשיכה (מחירים טריים תמיד)

אל תסתמכו על המחיר שכבר שמור on-chain. קבלו דוח חתום טרי ושלחו אותו באותה עסקה שמשתמשת בו: החוזה שלכם תמיד רואה את המחיר הנוכחי, ואתם משלמים רק על העדכונים שלכם.

// 1) off-chain: GET https://api.marketapi.app/v1/oracle/report?symbols=EURUSD&chain_id=CHAIN_ID  (header: Authorization: Bearer KEY)
// 2) on-chain: verify, store and use the report atomically
interface IMarketApiOracle {
    struct PriceReport { bytes32 feedId; int256 price; uint64 timestamp; uint64 validUntil; uint8 marketStatus; uint32 spreadBps; }
    function submit(PriceReport calldata r, bytes calldata sig) external returns (bool);
    function getPriceNoOlderThan(bytes32 feedId, uint256 maxAge) external view returns (int256 price, uint64 timestamp);
}

contract MyVault {
    IMarketApiOracle immutable oracle;
    bytes32 constant EURUSD = keccak256("EURUSD");
    constructor(IMarketApiOracle o) { oracle = o; }

    function settle(IMarketApiOracle.PriceReport calldata r, bytes calldata sig) external {
        oracle.submit(r, sig);                                         // ignored if an equal/newer price is stored
        (int256 price, ) = oracle.getPriceNoOlderThan(EURUSD, 60);    // reverts unless OPEN and fresh
        // ... use price (8 decimals)
    }
}

השדות report ו-signature של הדוח מה-API הם בדיוק שני הארגומנטים של submit. דוחות תקפים כדקה, אז קבלו אותם ממש לפני שליחת העסקה.