Oracle de prix pour smart contracts : forex, or, indices et actions on-chain

Comment ça marche

1. Récupérez un rapport signé : GET /oracle/report avec votre clé API.
2. Soumettez-le dans votre transaction : notre contrat vérificateur contrôle la signature avec ecrecover.
3. Utilisez le prix vérifié ; rejetez-le s’il est trop ancien pour votre cas d’usage.

Les rapports sont des données typées EIP-712 PriceReport(bytes32 feedId,int256 price,uint64 timestamp,uint64 validUntil,uint8 marketStatus,uint32 spreadBps), liées à une chaîne et à un contrat vérificateur (aucun rejeu ailleurs) et acceptées seulement jusqu’à validUntil, environ une minute après la signature (impossible d’accumuler des rapports favorables). Les prix sont le milieu entre achat et vente avec 8 décimales ; spreadBps est l’écart achat-vente. Quand vous soumettez un rapport dans votre propre transaction, vous payez ce gas. Les flux demandés sont aussi enregistrés on-chain de temps en temps par notre relayeur (lecture gratuite), mais vérifiez toujours l’âge d’un prix enregistré.

Heures de marché

Chaque rapport indique le statut du marché : OPEN (un prix en direct, datant d’au plus 60 secondes), CLOSED (le dernier prix officiel avant la clôture, identique pour tous, signé à tout moment tant que le marché est fermé) ou HALTED (cotation suspendue). getPriceNoOlderThan ne renvoie que des prix OPEN, si bien qu’un prix de clôture ne peut jamais passer pour un prix en direct. Les jetons adossés à des actifs devraient régler les ordres passés marché fermé au prochain prix OPEN (forward pricing, comme le font les fonds et les ETF).

Coupe-circuit

Chaque flux peut avoir un saut maximal autorisé. Un mouvement plus important n’est pas enregistré : le flux se met en pause jusqu’à ce que nous l’ayons vérifié et rouvert, si bien qu’un prix erroné ou manipulé n’atteint jamais votre contrat.

Flux

Réseaux

Adresse du signataire : 0x83fa2d8836525251FAd214A78A72038D0864f877. Liste lisible par machine : /oracle/feeds.

Intégrer

1. Récupérer un rapport signé

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

Renvoie report (le tuple encodé en ABI) et signature (65 octets) par symbole. Votre clé a besoin de la portée read:oracle.

2. Le vérifier dans votre contrat

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

Les consommateurs de type Chainlink peuvent lire un flux via le MarketApiFeedAdapter (latestRoundData(), AggregatorV3Interface).

Tarifs

5 crédit(s) par rapport signé, payé(s) sur votre solde API habituel. La lecture des prix déjà enregistrés on-chain est gratuite.

Cas d’usage de nos flux de prix on-chain

• Actifs tokenisés et RWA : valorisez des actions tokenisées, des jetons adossés à l’or et d’autres actifs réels avec des données de prix tenant compte des heures de marché.
• Prêts DeFi et collatéral : valorisez un collatéral adossé au forex et aux matières premières avec des prix frais et vérifiables et des contrôles de fraîcheur sûrs pour les liquidations.
• Actifs synthétiques et change on-chain : réglez des positions synthétiques sur forex, indices et matières premières contre des prix de référence signés.
• Stablecoins et paiements : convertissez entre devises on-chain avec les taux EUR/USD, GBP/USD et autres en direct.

Pourquoi un oracle pull signé ?

Les oracles push se mettent à jour selon un calendrier et quelqu’un paie le gas de chaque mise à jour. Avec un oracle pull, votre contrat récupère un prix frais et signé cryptographiquement exactement quand il en a besoin : coût plus faible, données plus fraîches et la même vérification on-chain. Le statut du marché, l’écart achat-vente et l’expiration font partie de chaque rapport signé.

Recommandé : le modèle pull (des prix toujours frais)

Ne vous fiez pas au prix déjà stocké on-chain. Récupérez un rapport fraîchement signé et soumettez-le dans la même transaction qui l’utilise : votre contrat voit toujours le prix actuel, et vous ne payez que vos propres mises à jour.

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

Les champs report et signature du rapport fournis par l’API sont exactement les deux arguments de submit. Les rapports sont valables environ une minute, récupérez-les donc juste avant d’envoyer la transaction.