Оракул цен для смарт-контрактов: валюты, золото, индексы и акции 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, примерно через минуту после подписи (выгодные отчёты нельзя копить). Цены — середина между bid и ask с 8 знаками после запятой; spreadBps — спред bid-ask. Когда вы отправляете отчёт в собственной транзакции, вы платите за этот газ. Востребованные фиды также время от времени сохраняются on-chain нашим релейером (чтение бесплатно), но всегда проверяйте возраст сохранённой цены.

Торговые часы

Каждый отчёт указывает статус рынка: 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. Чтение цен, уже сохранённых on-chain, бесплатно.

Сценарии использования наших on-chain ценовых фидов

• Токенизированные активы и RWA: оценивайте токенизированные акции, токены, обеспеченные золотом, и другие реальные активы по ценовым данным с учётом торговых часов.
• DeFi-кредитование и залоги: оценивайте залоги, обеспеченные валютой и сырьём, по свежим проверяемым ценам с безопасной для ликвидаций проверкой актуальности.
• Синтетические активы и on-chain FX: рассчитывайте синтетические позиции по валютам, индексам и сырью по подписанным справочным ценам.
• Стейблкоины и платежи: конвертируйте валюты on-chain по живым курсам EUR/USD, GBP/USD и другим.

Почему подписанный pull-оракул?

Push-оракулы обновляются по расписанию, и кто-то платит газ за каждое обновление. С pull-оракулом ваш контракт получает свежую криптографически подписанную цену ровно тогда, когда она нужна: ниже затраты, свежее данные и та же on-chain проверка. Статус рынка, спред bid-ask и срок действия входят в каждый подписанный отчёт.

Рекомендуется: pull-схема (всегда свежие цены)

Не полагайтесь на цену, уже сохранённую 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. Отчёты действуют около минуты, поэтому получайте их прямо перед отправкой транзакции.