📦 Datasets
Hyperliquid Oracle Prices
Hyperliquid oracle and mark price updates, including daily references and input prices.
Hyperliquid Oracle Prices
Overview
The Hyperliquid Oracle Prices data type provides per-coin pricing updates from the Hyperliquid L4 stream. Each row contains mark, oracle, and external perpetual values, including daily references and source input fields.
[!NOTE]
This data type is available only for symbols on the
HYPERLIQUIDL4exchange.
File Organization
Hyperliquid Oracle Prices data is organized in the coinapi bucket using the structure below.
T-HLORACLEPRICES/
└── D-{YYYYMMDD | YYYYMMDDHH}/
└── E-HYPERLIQUIDL4/
└── IDDI-[IDENTIFIER]+SC-[COINAPI_SYMBOL_ID]+S-[EXCHANGE_SYMBOL].csv.gzExample:
T-HLORACLEPRICES/D-2026060900/E-HYPERLIQUIDL4/IDDI-47427873+SC-HYPERLIQUIDL4_PERP_BTC_USDC+S-BTC.csv.gz
Where:
T-HLORACLEPRICES: Indicates the data type (Hyperliquid Oracle Prices)D-{YYYYMMDD | YYYYMMDDHH}defines the time partition:YYYYMMDDincoinapi-> legacy daily partitions published before 2026-06-09YYYYMMDDHHincoinapi-> hourly partitions for data published on or after 2026-06-09
E-HYPERLIQUIDL4: Hyperliquid L4 exchange identifierIDDI-[IDENTIFIER]: CoinAPI internal identifierSC-[COINAPI_SYMBOL_ID]: CoinAPI symbol identifierS-[EXCHANGE_SYMBOL]: Symbol as identified by the exchange
File Format
Files are in CSV format, compressed with gzip. Each row represents one oracle price update.
Data Fields
| Column Name | Type | Description |
|---|---|---|
| time_exchange | datetime | UTC timestamp of the update from the exchange stream. |
| time_coinapi | datetime | UTC timestamp when CoinAPI received the update. |
| coin_id | string | Coin identifier from Hyperliquid. |
| update_class | string | Update source class. Typical values: Deployer, Fallback. |
| mark_px | decimal | Current mark price. |
| mark_daily_px | decimal | Daily mark reference price. |
| oracle_px | decimal | Current oracle price. |
| oracle_daily_px | decimal | Daily oracle reference price. |
| external_perp_px | decimal | External perpetual reference price. |
| external_perp_daily_px | decimal | Daily external perpetual reference price. |
| spot_px_input | decimal | Spot input used by exchange pricing logic. |
| mark_px_input | decimal | Mark input value, when provided. |
| external_perp_px_input | decimal | External perpetual input value, when provided. |
Example Data
time_exchange;time_coinapi;coin_id;update_class;mark_px;mark_daily_px;oracle_px;oracle_daily_px;external_perp_px;external_perp_daily_px;spot_px_input;mark_px_input;external_perp_px_input
2026-06-09T00:00:00.0050000;2026-06-09T00:00:00.6819304;BTC;Deployer;63058.12;62980.44;63061.55;62985.10;63059.90;62982.23;63060.20;63058.00;63059.70Data Collection Process
- We maintain a real-time connection to Hyperliquid L4 market data streams.
- Oracle and mark updates are captured, normalized, and written into per-symbol files.
- Data is uploaded to the
coinapibucket as hourly partitions for data published on or after 2026-06-09. Legacy daily partitions published before that date remain incoinapi.
Corner Cases and Special Considerations
- Some pricing fields are optional and may be empty on specific updates.
update_classreflects exchange-side source logic and may evolve over time.- Minor differences between
time_exchangeandtime_coinapiare expected due to network latency.