Hyperliquid Perpetuals Meta Scraper
Pricing
from $7.50 / 1,000 results
Hyperliquid Perpetuals Meta Scraper
Scrapes Hyperliquid perpetual futures metadata and per-asset context data. Returns each market as a flat row with symbol, index, mark price, open interest, funding rate, and full context fields.
Pricing
from $7.50 / 1,000 results
Rating
0.0
(0)
Developer
ParseForge
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
2 days ago
Last modified
Categories
Share
Hyperliquid Perpetuals Meta Scraper
Scrape Hyperliquid perpetual futures metadata and asset contexts in one flat dataset. Every row returns the symbol, index, mark price, open interest, funding rate, and full asset context. No API key or RPC node required. Export to CSV, JSON, Excel, or XML.
Hyperliquid's on-chain perpetual exchange exposes its market state through a public API, but querying it asset by asset and normalizing the nested context fields into a flat table is slow, manual work. This Actor reads the exchange meta endpoint and the per-asset context endpoint in parallel, filters by symbol or delisted status, and returns every perpetual market in one consistent schema. You get a snapshot of the entire derivatives book without writing a single WebSocket or RPC call.
| Who uses it | What they scrape Hyperliquid for |
|---|---|
| DeFi quants | Build a funding-rate arbitrage screener across all Hyperliquid perpetuals in one pull. |
| Market makers | Monitor open interest and mark prices to adjust inventory and spreads. |
| Crypto hedge funds | Feed a daily snapshot of the entire perp universe into a risk model. |
| On-chain analysts | Track new listings and delistings by diffing consecutive scrapes. |
What it does
This Actor collects Hyperliquid perpetual futures metadata and per-asset context data, and returns each market as a flat row with its index, mark price, open interest, funding rate, and full context fields.
- ๐ Full market snapshot: Pulls every active perpetual market from the exchange meta endpoint, then enriches each with its live asset context.
- ๐ Symbol filter: Narrow the scrape to a single ticker such as BTC, ETH, or SOL to monitor only the contracts you trade.
- ๐๏ธ Delisted exclusion: Skip assets that have been removed from the exchange so your dataset stays clean and tradeable.
- โก Parallel enrichment: Fetches the meta list and all per-asset contexts concurrently, so a full scrape finishes in seconds, not minutes.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with Hyperliquid data
๐ Build a funding-rate monitor.
A quant pulls all Hyperliquid perpetuals every hour, sorts by funding rate, and triggers a long-short pair trade when the spread exceeds a threshold.
๐ Audit new listings and delistings.
An analyst scrapes the full meta list daily, diffs the symbols against the previous run, and publishes a watchlist of newly listed and recently delisted contracts.
๐ Feed a market screener dashboard.
A front-end developer schedules the Actor every five minutes, stores the flat rows in a database, and renders a sortable table of open interest, mark price, and index price for every perp.
๐ Research per-asset context parameters.
A protocol researcher scrapes the full asset context fields to study margin requirements, position limits, and oracle configurations across all markets in one export.
Why choose this scraper
| What you get | |
|---|---|
| Flat schema | Nested context fields are unpacked into top-level columns ready for a DataFrame or SQL import. |
| No RPC node | Reads the public REST API directly. No WebSocket, no RPC endpoint, no wallet connection. |
| One call per run | A single run returns every perpetual market. No pagination logic or rate-limit backoff to code. |
| Deterministic output | The same input always produces the same columns, so scheduled scrapes feed a reliable pipeline. |
How it compares
This Actor focuses on the exchange meta and per-asset context endpoints, while the Hyperliquid Pro Scraper targets traders, vaults, and markets data. They return complementary datasets from different Hyperliquid API surfaces.
| Feature | ParseForge | Hyperliquid Pro Scraper - Traders, Vaults & Markets |
|---|---|---|
| Perpetual market metadata (symbol, index, mark price, OI, funding) | Yes | Not listed |
| Per-asset context (margin, position limits, oracle config) | Yes | Not listed |
| Trader leaderboard and wallet positions | Not listed | Yes |
| Vault performance data | Not listed | Yes |
| Symbol filter | Yes | Not listed |
| Delisted asset exclusion | Yes | Not listed |
Configure the run
Drive the Actor from the full exchange meta list, optionally narrowed to a single symbol, and exclude delisted assets so only active, tradeable perpetuals reach your dataset. The Input tab lists every parameter.
A first run with the defaults:
A larger pull:
Pricing
Pay-per-result: $0.0085 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $0.85 |
| 1,000 results | $8.50 |
| 10,000 results | $85.00 |
New Apify accounts start with $5 in free credit.
Free users
Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the Hyperliquid Perpetuals Meta Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to Hyperliquid through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting only 10 results?
Free Apify accounts are capped at 10 items for preview. Upgrade to a paid plan and set the 'Maximum assets' input to a higher number, up to 1,000,000.
Why is my symbol filter returning no results?
Check the casing. Hyperliquid symbols are uppercase (BTC, ETH, SOL). A lowercase input will not match. Also confirm the symbol is a perpetual market, not a spot asset.
Why do some rows have empty context fields?
A small number of assets may not have a published context object, or the context endpoint may have returned an error for that asset. The Actor preserves the row and leaves the context columns empty so your schema stays consistent.
Why did the run fail with a timeout?
If you set 'Maximum assets' to a very large number, the parallel context fetches may saturate the network. Lower the max items or run during a quieter period. The Hyperliquid API is public and rate-limited.
Can I get historical snapshots?
The Actor returns live data at the moment of the run. For historical snapshots, schedule the Actor and store each run's dataset. Apify's data retention and webhook integrations make this straightforward.
FAQ
| Question | Answer |
|---|---|
| What data does this Actor return? | It returns the exchange meta list (symbol, index, mark price, open interest, funding rate, and more) plus the full per-asset context for every perpetual market, all flattened into one row per asset. |
| Do I need a Hyperliquid API key? | No. The Actor reads the public REST endpoints that the Hyperliquid front-end itself uses. No API key, no wallet signature, and no RPC node are required. |
| Can I filter to a single ticker? | Yes. Set the Symbol input to a ticker such as BTC, ETH, or SOL, and the Actor will return only that asset's meta and context. |
| How many assets can I scrape in one run? | Free users are limited to 10 assets for preview. Paid users can scrape up to 1,000,000 assets, which covers the full exchange universe many times over. |
| Does this Actor handle delisted markets? | Yes. By default it includes all markets, but you can check 'Exclude delisted' to skip assets that are no longer tradeable. |
| What format is the output? | The Actor returns a flat dataset that you can export to CSV, JSON, Excel, or XML directly from the Apify platform. |
| How often should I run this Actor? | Funding rates and open interest change continuously. Most users run it every 5 to 15 minutes for a screener, or once daily for a research snapshot. |
| Does this Actor scrape order books or trade history? | No. This Actor focuses on market metadata and asset contexts. For order books, trade history, or user positions, consider a dedicated Hyperliquid L2 scraper. |
| Is this the same as the Hyperliquid Pro Scraper? | No. The Pro Scraper targets traders, vaults, and leaderboard data. This Actor targets the perpetual market meta and per-asset context endpoints, returning a different, complementary dataset. |
| Can I schedule this Actor? | Yes. Apify schedules let you run it every minute, hour, or day, and push the results to a webhook, S3 bucket, or database. |
| What is the asset context? | The asset context is a per-market configuration object that includes margin requirements, position limits, oracle settings, and other parameters that govern how a perpetual contract behaves on Hyperliquid. |
| Does this work on Hyperliquid testnet? | The Actor reads the mainnet public API. For testnet data you would need an Actor configured to point at the testnet endpoints. |
Related actors
Browse the full ParseForge collection for more scrapers.
๐ Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.
โ ๏ธ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Hyperliquid Labs. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.
