Preis-Oracle für Smart Contracts: Devisen, Gold, Indizes und Aktien on-chain

So funktioniert es

1. Abrufen eines signierten Berichts: GET /oracle/report mit Ihrem API-Schlüssel.
2. Übermitteln Sie ihn in Ihrer Transaktion: Unser Verifier-Vertrag prüft die Signatur mit ecrecover.
3. Verwenden Sie den verifizierten Kurs; lehnen Sie ihn ab, wenn er für Ihren Anwendungsfall zu alt ist.

Berichte sind EIP-712-typisierte Daten PriceReport(bytes32 feedId,int256 price,uint64 timestamp,uint64 validUntil,uint8 marketStatus,uint32 spreadBps), an eine Chain und einen Verifier-Vertrag gebunden (keine Wiederverwendung anderswo) und nur bis validUntil akzeptiert, etwa eine Minute nach der Signatur (kein Horten günstiger Berichte). Kurse sind der Mittelwert aus Geld und Brief mit 8 Dezimalstellen; spreadBps ist die Geld-Brief-Spanne. Wenn Sie einen Bericht in Ihrer eigenen Transaktion übermitteln, zahlen Sie dieses Gas. Gefragte Feeds werden von unserem Relayer zudem von Zeit zu Zeit on-chain gespeichert (kostenlos lesbar), prüfen Sie aber immer das Alter eines gespeicherten Kurses.

Handelszeiten

Jeder Bericht nennt den Marktstatus: OPEN (ein Live-Kurs, höchstens 60 Sekunden alt), CLOSED (der offizielle letzte Kurs vor dem Schluss, für alle gleich, jederzeit signiert, solange der Markt geschlossen ist) oder HALTED (Handel ausgesetzt). getPriceNoOlderThan gibt nur OPEN-Kurse zurück, sodass ein Schlusskurs nie als Live-Kurs durchgehen kann. Vermögensgedeckte Token sollten Orders, die bei geschlossenem Markt erteilt wurden, zum nächsten OPEN-Kurs abrechnen (Forward Pricing, wie bei Fonds und ETFs).

Circuit Breaker

Jeder Feed kann einen maximal erlaubten Sprung haben. Eine größere Bewegung wird nicht gespeichert: Der Feed pausiert, bis wir ihn geprüft und wieder geöffnet haben, sodass ein falscher oder manipulierter Kurs nie Ihren Vertrag erreicht.

Feeds

Netzwerke

Signer-Adresse: 0x83fa2d8836525251FAd214A78A72038D0864f877. Maschinenlesbare Liste: /oracle/feeds.

Integrieren

1. Signierten Bericht abrufen

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

Gibt pro Symbol report (das ABI-codierte Tupel) und signature (65 Byte) zurück. Ihr Schlüssel braucht den Scope read:oracle.

2. In Ihrem Vertrag verifizieren

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 ...
    }
}

Consumer im Chainlink-Stil können einen Feed über den MarketApiFeedAdapter lesen (latestRoundData(), AggregatorV3Interface).

Preise

5 Guthaben pro signiertem Bericht, bezahlt von Ihrem normalen API-Guthaben. Das Lesen bereits on-chain gespeicherter Kurse ist kostenlos.

Anwendungsfälle für unsere On-Chain-Preis-Feeds

• Tokenisierte Vermögenswerte und RWA: Bepreisen Sie tokenisierte Aktien, goldgedeckte Token und andere Real-World-Assets mit Kursdaten, die die Handelszeiten berücksichtigen.
• DeFi-Kredite und Sicherheiten: Bewerten Sie durch Devisen und Rohstoffe gedeckte Sicherheiten mit frischen, überprüfbaren Kursen und liquidationssicheren Aktualitätsprüfungen.
• Synthetische Vermögenswerte und On-Chain-FX: Rechnen Sie synthetische Devisen-, Index- und Rohstoffpositionen gegen signierte Referenzkurse ab.
• Stablecoins und Zahlungen: Rechnen Sie on-chain mit Live-Kursen für EUR/USD, GBP/USD und andere Devisen zwischen Währungen um.

Warum ein signiertes Pull-Oracle?

Push-Oracles aktualisieren nach Zeitplan, und jemand zahlt Gas für jedes Update. Mit einem Pull-Oracle ruft Ihr Vertrag genau dann einen frischen, kryptografisch signierten Kurs ab, wenn er ihn braucht: geringere Kosten, frischere Daten und dieselbe On-Chain-Verifizierung. Marktstatus, Geld-Brief-Spanne und Ablaufzeit sind Teil jedes signierten Berichts.

Empfohlen: das Pull-Muster (immer frische Kurse)

Verlassen Sie sich nicht auf den bereits on-chain gespeicherten Kurs. Rufen Sie einen frisch signierten Bericht ab und übermitteln Sie ihn in derselben Transaktion, die ihn verwendet: Ihr Vertrag sieht immer den aktuellen Kurs, und Sie zahlen nur für Ihre eigenen Updates.

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

Die Felder report und signature des Berichts aus der API sind genau die beiden Argumente von submit. Berichte sind etwa eine Minute gültig, rufen Sie sie also direkt vor dem Senden der Transaktion ab.