स्मार्ट कॉन्ट्रैक्ट के लिए प्राइस ओरेकल: फ़ॉरेक्स, सोना, इंडेक्स और स्टॉक ऑन-चेन

यह कैसे काम करता है

1. हस्ताक्षरित रिपोर्ट प्राप्त करें: अपनी API कुंजी के साथ GET /oracle/report।
2. इसे अपने ट्रांज़ैक्शन में सबमिट करें: हमारा वेरिफ़ायर कॉन्ट्रैक्ट ecrecover से हस्ताक्षर जाँचता है।
3. सत्यापित कीमत का उपयोग करें; अगर वह आपके उपयोग के लिए बहुत पुरानी हो तो उसे अस्वीकार करें।

रिपोर्ट EIP-712 टाइप्ड डेटा PriceReport(bytes32 feedId,int256 price,uint64 timestamp,uint64 validUntil,uint8 marketStatus,uint32 spreadBps) हैं, एक चेन और एक वेरिफ़ायर कॉन्ट्रैक्ट से बँधी (कहीं और दोबारा उपयोग नहीं) और केवल validUntil तक स्वीकार, यानी हस्ताक्षर के लगभग एक मिनट बाद तक (अनुकूल रिपोर्ट जमा नहीं की जा सकतीं)। कीमतें बिड और आस्क का मध्य हैं, 8 दशमलव के साथ; spreadBps बिड-आस्क स्प्रेड है। जब आप अपने ट्रांज़ैक्शन में रिपोर्ट सबमिट करते हैं, तो वह गैस आप चुकाते हैं। माँग वाली फ़ीड हमारा रिलेयर भी समय-समय पर ऑन-चेन संग्रहीत करता है (पढ़ना मुफ़्त), पर संग्रहीत कीमत की उम्र हमेशा जाँचें।

बाज़ार का समय

हर रिपोर्ट बाज़ार की स्थिति बताती है: OPEN (लाइव कीमत, अधिकतम 60 सेकंड पुरानी), CLOSED (बंद होने से पहले की आधिकारिक अंतिम कीमत, सबके लिए एक जैसी, बाज़ार बंद रहने तक कभी भी हस्ताक्षरित) या HALTED (ट्रेडिंग रुकी)। getPriceNoOlderThan केवल OPEN कीमतें लौटाता है, इसलिए क्लोज़िंग कीमत कभी लाइव के रूप में नहीं चल सकती। एसेट-समर्थित टोकन को बाज़ार बंद रहते दिए गए ऑर्डर अगली OPEN कीमत पर सेटल करने चाहिए (फ़ॉरवर्ड प्राइसिंग, जैसे फ़ंड और ETF करते हैं)।

सर्किट ब्रेकर

हर फ़ीड की अधिकतम अनुमत छलाँग हो सकती है। बड़ी चाल संग्रहीत नहीं होती: फ़ीड तब तक रुकी रहती है जब तक हम उसे जाँचकर फिर से न खोलें, इसलिए ग़लत या हेरफेर की गई कीमत कभी आपके कॉन्ट्रैक्ट तक नहीं पहुँचती।

फ़ीड

नेटवर्क

हस्ताक्षरकर्ता का पता: 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 बैलेंस से भुगतान। ऑन-चेन पहले से संग्रहीत कीमतें पढ़ना मुफ़्त है।

हमारी ऑन-चेन प्राइस फ़ीड के उपयोग

• टोकनाइज़्ड एसेट और RWA: बाज़ार के समय को ध्यान में रखने वाले प्राइस डेटा से टोकनाइज़्ड स्टॉक, सोना-समर्थित टोकन और अन्य वास्तविक-दुनिया की संपत्तियों का मूल्य तय करें।
• DeFi उधार और कोलैटरल: फ़ॉरेक्स और कमोडिटी-समर्थित कोलैटरल का मूल्य ताज़ा, सत्यापन-योग्य कीमतों और लिक्विडेशन-सुरक्षित पुरानेपन की जाँच से तय करें।
• सिंथेटिक एसेट और ऑन-चेन FX: सिंथेटिक फ़ॉरेक्स, इंडेक्स और कमोडिटी पोज़िशन हस्ताक्षरित संदर्भ कीमतों पर सेटल करें।
• स्टेबलकॉइन और भुगतान: लाइव EUR/USD, GBP/USD और अन्य फ़ॉरेक्स दरों से ऑन-चेन मुद्राओं में बदलें।

हस्ताक्षरित पुल ओरेकल क्यों?

पुश ओरेकल तय समय पर अपडेट होते हैं और हर अपडेट का गैस कोई चुकाता है। पुल ओरेकल के साथ आपका कॉन्ट्रैक्ट ठीक तभी ताज़ा, क्रिप्टोग्राफ़िक रूप से हस्ताक्षरित कीमत लेता है जब उसे ज़रूरत हो: कम लागत, ताज़ा डेटा और वही ऑन-चेन सत्यापन। बाज़ार की स्थिति, बिड-आस्क स्प्रेड और समाप्ति हर हस्ताक्षरित रिपोर्ट का हिस्सा हैं।

सुझाया गया: पुल पैटर्न (हमेशा ताज़ा कीमतें)

ऑन-चेन पहले से संग्रहीत कीमत पर निर्भर न रहें। ताज़ा हस्ताक्षरित रिपोर्ट लें और उसे उसी ट्रांज़ैक्शन में सबमिट करें जो उसका उपयोग करता है: आपका कॉन्ट्रैक्ट हमेशा मौजूदा कीमत देखता है, और आप केवल अपने अपडेट के लिए भुगतान करते हैं।

// 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)
    }
}

API से मिली रिपोर्ट के report और signature फ़ील्ड ठीक submit के दो आर्ग्युमेंट हैं। रिपोर्ट लगभग एक मिनट मान्य रहती हैं, इसलिए ट्रांज़ैक्शन भेजने से ठीक पहले उन्हें लें।