# Hyperliquid Scraper: Funding Rates, Open Interest & Candles API (`johto.data/hyperliquid-market-data`) Actor

Hyperliquid perpetuals data in one row per coin: OHLCV candles, funding rate history, current funding, open interest, mark, oracle and mid price, 24h volume. For trading bots, dashboards, backtests and AI agents. $0.90 per 1,000 snapshots.

- **URL**: https://apify.com/johto.data/hyperliquid-market-data.md
- **Developed by:** [Johto Data](https://apify.com/johto.data) (community)
- **Categories:** Developer tools, AI, Automation
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.90 / 1,000 coin snapshots

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Hyperliquid Scraper: Funding Rates, Open Interest & Candles API

Get Hyperliquid perpetual futures data in one row per coin: OHLCV candles, funding rate history, current funding, open interest (coins and USD), mark, oracle and mid price, and 24h notional volume. Built for trading bots, funding rate dashboards, backtests and AI agents.

### Pricing

**$0.90 per 1,000 coin snapshots.** No start fee. A snapshot is one coin with its candles, funding history and open interest. Unknown coins are not charged.

Example: 4 coins every hour for 30 days is 2,880 snapshots, so $2.59.

### Quick start

1. Click **Try for free**. The input is prefilled with BTC, ETH, SOL and HYPE.
2. Pick an `interval` (1m to 1M) and `lookbackHours` (1 to 720).
3. Click **Start**. Runs take a few seconds. Schedule it hourly for a live feed.

### Example input

```json
{ "coins": ["BTC", "ETH", "SOL", "HYPE"], "interval": "1h", "lookbackHours": 24 }
```

### Output

One row per coin (trimmed, from a real run on Nov 8, 2026):

```json
{
  "coin": "BTC",
  "markPx": 76016.0,
  "oraclePx": 76040.0,
  "openInterest": 41779.56,
  "openInterestUsd": 3175915309.66,
  "fundingRate": 0.0000125,
  "premium": -0.000263,
  "dayNtlVlm": 447814729.78,
  "interval": "1h",
  "candleCount": 25,
  "fundingCount": 24,
  "candles": [{ "t": 1794067200000, "o": 75740.0, "h": 75782.0, "l": 75671.0, "c": 75722.0, "v": 388.11, "n": 5163 }],
  "fundingHistory": [{ "time": 1794153600026, "fundingRate": 0.0000125, "premium": -0.000317 }],
  "source": "Hyperliquid public info API (api.hyperliquid.xyz)"
}
```

| Field | What you get |
|---|---|
| `markPx`, `oraclePx`, `midPx` | Current prices |
| `fundingRate`, `premium` | Current hourly funding and premium |
| `fundingHistory` | Funding rate per hour over the lookback window |
| `openInterest`, `openInterestUsd` | Open interest in coins and USD |
| `dayNtlVlm` | 24h notional volume |
| `candles` | OHLCV candles: time, open, high, low, close, volume, trade count |

### Use with AI agents and automation

**Apify MCP server (Claude, Cursor, ChatGPT, any MCP client).** Add `https://mcp.apify.com?tools=johto.data/hyperliquid-market-data` as a remote MCP server. The agent gets one tool that takes the input below and returns one row per coin with candles, funding history and open interest.

**API, one call.** Runs and returns the dataset in the same request:

```bash
curl -X POST "https://api.apify.com/v2/acts/johto.data~hyperliquid-market-data/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"coins":["BTC","ETH","SOL","HYPE"],"interval":"1h","lookbackHours":24}'
```

**LangChain (Python).**

```python
from langchain_apify import ApifyActorsTool
tool = ApifyActorsTool("johto.data/hyperliquid-market-data")
```

**n8n, Make, Zapier.** Use the Apify app or node, choose **Run Actor**, enter `johto.data/hyperliquid-market-data` and paste the input JSON. Then map dataset fields into Sheets, a CRM or a database.

### FAQ

**How does the price compare?** $0.90 per 1,000 snapshots, no start fee. Other Hyperliquid funding actors list $0.90 to $1.00 per 1,000 rows, some with a start fee, and most return funding only (checked Nov 8, 2026).

**Annualized funding?** Hyperliquid funding is hourly. Multiply `fundingRate` by 24 x 365 for a simple APR.

**Which coins work?** Any listed Hyperliquid perp. Unknown symbols return `error: "unknown_coin"` and are not charged.

### Source and terms

Data comes from the public Hyperliquid info API. Check Hyperliquid's terms for your jurisdiction. Requests are paced under the documented rate limits. Not financial advice.

### Support

Open an issue in the **Issues** tab. Built and maintained by [Johto Data](https://johtodata.com).

# Actor input Schema

## `coins` (type: `array`):

Perp coin names, e.g. BTC, ETH, SOL, HYPE.

## `interval` (type: `string`):

Candle interval

## `lookbackHours` (type: `integer`):

Window for candles and funding history.

## Actor input object example

```json
{
  "coins": [
    "BTC",
    "ETH",
    "SOL",
    "HYPE"
  ],
  "interval": "1h",
  "lookbackHours": 24
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "coins": [
        "BTC",
        "ETH",
        "SOL",
        "HYPE"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("johto.data/hyperliquid-market-data").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "coins": [
        "BTC",
        "ETH",
        "SOL",
        "HYPE",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("johto.data/hyperliquid-market-data").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "coins": [
    "BTC",
    "ETH",
    "SOL",
    "HYPE"
  ]
}' |
apify call johto.data/hyperliquid-market-data --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,johto.data/hyperliquid-market-data"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/DaIFSbdiZp9ayUIhE/builds/H6KdoyOAjT82TfK2G/openapi.json