Hyperliquid Market Data Scraper

Hyperliquid Market Data Scraper — Perpetual Market Prices and Asset Statistics

Overview

Collect Hyperliquid market data, including mid prices and perpetual market asset statistics. Choose a collection mode, filter by coin symbols, and limit the number of records saved. Export structured results in JSON, CSV, Excel, or other supported dataset formats.

Features

• Mid price collection: Capture current mid prices for available coins.
• Perpetual market statistics: Collect funding rates, open interest, mark prices, oracle prices, and other available asset metrics.
• Coin filtering: Focus on specific symbols such as BTC and ETH.
• Configurable record limits: Control the maximum number of saved items.
• Structured datasets: Prepare market snapshots for spreadsheets, dashboards, and analysis.
• Scheduled collection: Refresh market data periodically using Apify scheduling.

Collection Modes

1. Mid Prices

Collect mid prices for available coins. Each record contains a coin symbol and its corresponding mid price.

2. Perpetual Market Contexts

Collect perpetual market metadata alongside matching asset statistics. Depending on availability, records can include funding rates, open interest, previous-day prices, trading volume, mark prices, oracle prices, and leverage information.

Use Cases

• Mid price snapshots: Export current prices for a selected watchlist.
• Funding and open interest analysis: Compare perpetual market metrics across assets.
• Market research: Examine differences between mid, mark, and oracle prices.
• Market catalog monitoring: Track assets available in the perpetual market.
• Historical snapshots: Collect recurring datasets for later comparisons and analysis.
• Research pipelines: Supply structured market data to spreadsheets and data-processing workflows.

Input Parameters

Parameter	Type	Default	Description
mode	String	mids	Selects the collection mode: mids or contexts.
coins	Array	[]	Coin symbols to include, such as BTC or ETH. Leave empty to include all available coins, subject to maxItems.
maxItems	Integer	100	Maximum number of records to save, up to 1000.
requestDelaySecs	Number	1	Configured delay between requests, where applicable.
requestTimeoutSecs	Integer	30	Maximum waiting time for a request, in seconds.

Example Input

{
  "mode": "mids",
  "coins": ["BTC", "ETH"],
  "maxItems": 50,
  "requestDelaySecs": 1,
  "requestTimeoutSecs": 30
}

This configuration collects mid prices for BTC and ETH, saving up to 50 matching records.

What Data Does This Actor Extract?

The actor collects coin-level price information and, in perpetual market contexts mode, additional asset metadata and trading statistics.

Extracted Data Fields

Field	Description
coin	Coin or asset symbol.
mid	Mid-market price, available in mid prices mode.
funding	Perpetual funding rate, when available.
openInterest	Current open interest, when available.
prevDayPx	Previous-day price, when available.
dayNtlVlm	Daily notional trading volume, when available.
premium	Premium metric, when available.
oraclePx	Oracle price, when available.
markPx	Mark price, when available.
szDecimals	Asset size precision.
maxLeverage	Maximum leverage value reported for the asset.
scraped_at	Date and time when the record was collected.

Fields depend on the selected mode and the information available for each asset. Context-specific fields may be absent from mid price records.

Example Output

{
  "coin": "BTC",
  "mid": "84051.5",
  "funding": "0.0000067964",
  "openInterest": "38049.72006",
  "prevDayPx": "83020.0",
  "dayNtlVlm": "1474964057.0020473003",
  "premium": "-0.0004602174",
  "oraclePx": "84090.7",
  "markPx": "84051.0",
  "szDecimals": 5,
  "maxLeverage": 40,
  "scraped_at": "2026-10-26T00:00:00+00:00"
}

This example illustrates a perpetual market context record. Actual values and available fields may vary between assets and collection modes.

Working with Your Dataset

After collection finishes, open the dataset in Apify to inspect records or export them for analysis.

• JSON: Use structured records in data-processing applications.
• CSV: Compare coin prices and market metrics in spreadsheet software.
• Excel: Create watchlists, tables, and market reports.
• Other supported formats: Select from the dataset export formats available in Apify.

Important Notes

• Use mode to select mid prices or perpetual market contexts.
• Set coins to filter the results by symbol.
• Leave coins empty to include all available coins, subject to the configured record limit.
• maxItems limits the number of saved records; it does not determine how many assets exist in the market.
• Market values can change frequently. Each collection represents a snapshot rather than a guarantee of future prices.
• This actor provides market information for research and does not execute trades.

FAQ

Who is this actor for?

It is designed for traders, market researchers, analysts, and developers who need structured Hyperliquid market data.

What is the difference between the two modes?

The mids mode collects coin mid prices. The contexts mode collects perpetual market metadata and corresponding asset statistics when available.

How do I collect only BTC and ETH?

Set coins to ["BTC", "ETH"] to restrict the results to those symbols.

Can I collect all available coins?

Yes. Leave coins empty and configure maxItems to control the number of records saved.

What export formats are supported?

You can export JSON, CSV, Excel, and other formats supported by Apify datasets.

Can I schedule recurring collections?

Yes. Configure an Apify schedule to refresh the market dataset at your preferred interval.

Disclaimer

This actor is an independent tool and is not affiliated with, endorsed by, sponsored by, or officially associated with Hyperliquid. Market information is provided for research and informational purposes only. Cryptocurrency trading involves substantial risk, and collected data should not be treated as financial advice or a guarantee of trading outcomes.

Is Web Scraping Legal?

Collecting information that is already public is generally legal. and there is no single law that bans it. The limits are the usual ones: do not break into accounts, do not take private or confidential data, and be careful with personal data and copyrighted works. A site's terms can also restrict how you access it. Facts such as a public name, price, or rating are not the same thing as republishing someone's article or photo.

This actor collects information from public pages. It does not log in and it does not bypass access controls.

For a longer explanation, see Apify's article Is web scraping legal?.