# Hyperliquid Spot Tracker — Every Spot Pair Live Price + Vol (`gochujang/hyperliquid-spot-tracker`) Actor

Complete live snapshot of every Hyperliquid spot pair: mid/mark/oracle price, 24h volume, circulating supply, market cap. Complements HL perp data for full picture. Direct from Hyperliquid's free public API. PPE $0.001/pair.

- **URL**: https://apify.com/gochujang/hyperliquid-spot-tracker.md
- **Developed by:** [Hojun Lee](https://apify.com/gochujang) (community)
- **Categories:** Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.00 / 1,000 pair trackeds

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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### Hyperliquid Spot Tracker — 300+ HLP Spot Trading Pairs, Live Prices & Market Cap

**Hyperliquid spot tracker** for all 300+ **HLP spot market** trading pairs — live mid/mark price, 24h volume, 24h change, circulating and total supply, and implied market cap. The fastest way to monitor **Hyperliquid DEX data** and catch spot breakouts before tokens appear on centralized exchanges. No API key required. Runs on Apify's cloud in seconds — no local infrastructure needed.

**Keywords:** Hyperliquid spot tracker · HLP spot trading · Hyperliquid DEX data · Hyperliquid spot market · HL token price · spot DEX breakout · HYPE PURR price · Hyperliquid listing

***

### What does the Hyperliquid Spot Tracker do?

The **Hyperliquid Spot Tracker** queries the Hyperliquid Info API (`spotMetaAndAssetCtxs`) and returns a normalized snapshot of every spot pair currently trading on the Hyperliquid DEX. Each record includes **mid price, mark price, previous-day price, 24-hour volume in USD and base-token units, circulating supply, total supply, and implied market cap**. Filters let you narrow to specific symbols, minimum volume thresholds, or minimum market cap — and results are sortable by gainers, losers, volume, or market cap. Because Apify hosts and schedules the actor, you can run recurring sweeps without managing rate limits or server uptime yourself.

***

### Why use the Hyperliquid Spot Tracker?

- **HL spot breakouts precede CEX listings.** HYPE, PURR, and native ecosystem tokens build price discovery on Hyperliquid's spot market before they reach Binance or Coinbase. Monitoring this feed gives you a structural head start.
- **Perp and spot triangulation.** Combining this actor with the Hyperliquid Whale Tracker gives full ecosystem coverage — spot momentum plus large-position flow on the perp side.
- **New-listing alpha.** Diff the pair list between two runs to detect newly-listed tokens the moment they appear — before any aggregator picks them up.
- **Cross-venue arbitrage screening.** For tokens listed on both Hyperliquid spot and a CEX, compare prices programmatically to surface arb opportunities.
- **Ecosystem growth metrics.** Rising HL spot volume share relative to perp volume signals genuine on-chain liquidity migration, not just speculative leverage.

***

### How to use the Hyperliquid Spot Tracker

1. Open the actor on [Apify Store](https://apify.com/gochujang/hyperliquid-spot-tracker) and click **Try for free**.
2. Configure inputs — defaults return the top 100 pairs by 24h volume. Add `symbols` to filter to specific tokens, or set `sortBy: "change_24h_desc"` to find the day's biggest movers.
3. Click **Start** — results are ready in under 30 seconds.
4. Access output via the **Dataset** tab as JSON or CSV, or connect to your pipeline via the Apify API.
5. Schedule runs every hour or every 15 minutes using Apify's built-in cron scheduler to build a live Hyperliquid DEX data feed.

***

### Input

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `symbols` | array | all | Filter by base token symbols, e.g. `["HYPE", "PURR"]`. Empty = all pairs |
| `minVolume24hUsd` | integer | `10,000` | Skip pairs with less than this USD 24h volume |
| `minMarketCapUsd` | integer | `0` | Skip pairs below this implied market cap |
| `sortBy` | string | `volume_24h_desc` | `volume_24h_desc`, `market_cap_desc`, `change_24h_desc`, `change_24h_asc`, `symbol_asc` |
| `limit` | integer | `100` | Maximum number of pairs returned |
| `alertChange24hPct` | number | `0` | Send Telegram alert when any pair's absolute 24h change reaches this threshold. 0 = disabled |
| `telegramBotToken` | string | — | Telegram bot token for alerts |
| `telegramChatId` | string | — | Telegram chat ID to receive alerts |

**Example — Top 20 movers with liquidity filter:**

```json
{"sortBy": "change_24h_desc", "minVolume24hUsd": 100000, "limit": 20}
```

**Example — Full liquid spot leaderboard:**

```json
{"sortBy": "volume_24h_desc", "limit": 30}
```

***

### Output

Each item represents one Hyperliquid spot trading pair with price, volume, supply, and market cap.

```json
[
  {
    "pair": "HYPE/USDC",
    "pair_index": 0,
    "base_token": "HYPE",
    "quote_token": "USDC",
    "mid_price": 28.42,
    "mark_price": 28.43,
    "prev_day_price": 26.15,
    "change_24h_pct": 8.68,
    "volume_24h_usd": 142800000,
    "volume_24h_base": 5042000,
    "circulating_supply": 333800000,
    "total_supply": 1000000000,
    "market_cap_usd": 9486796000,
    "is_canonical": true
  },
  {
    "pair": "PURR/USDC",
    "pair_index": 1,
    "base_token": "PURR",
    "quote_token": "USDC",
    "mid_price": 0.0094,
    "mark_price": 0.0094,
    "prev_day_price": 0.0089,
    "change_24h_pct": 5.62,
    "volume_24h_usd": 3200000,
    "volume_24h_base": 340400000,
    "circulating_supply": 499000000000,
    "total_supply": 500000000000,
    "market_cap_usd": 4690000,
    "is_canonical": true
  }
]
```

***

### Data fields

| Field | Type | Description |
|-------|------|-------------|
| `pair` | string | Trading pair in `BASE/QUOTE` format |
| `pair_index` | integer | Hyperliquid internal asset index |
| `base_token` | string | Base token symbol |
| `quote_token` | string | Quote token (typically `USDC`) |
| `mid_price` | number | Mid-market price (best bid/ask average) |
| `mark_price` | number | Hyperliquid mark price |
| `prev_day_price` | number | Previous day's closing price for 24h change calculation |
| `change_24h_pct` | number | Percentage price change over past 24 hours |
| `volume_24h_usd` | number | 24-hour notional volume in USD |
| `volume_24h_base` | number | 24-hour volume in base token units |
| `circulating_supply` | number | Circulating token supply |
| `total_supply` | number | Maximum total token supply |
| `market_cap_usd` | number | Implied market cap (mid price x circulating supply) |
| `is_canonical` | boolean | Whether this is the canonical/primary listing for the token |

***

### Cost estimation

This actor uses **Pay-Per-Event (PPE)** pricing — you pay only for pairs returned.

| Use case | Pairs returned | Estimated cost |
|----------|----------------|----------------|
| Top 20 movers | 20 | **$0.020** |
| Top 100 by volume | 100 | **$0.100** |
| Full sweep (~300 pairs) | 300 | **$0.300** |
| Specific symbols (10 tokens) | 10 | **$0.010** |

**Rate: $0.001 per pair returned.** A daily full-sweep schedule costs under $10/month.

***

### FAQ

**Does this actor require a Hyperliquid API key?**
No. The actor uses Hyperliquid's public Info API (`POST https://api.hyperliquid.xyz/info`) with no authentication. There are no rate limits at typical actor volumes.

**How often does Hyperliquid DEX data update?**
Hyperliquid's API reflects near real-time order book state. The actor fetches data at run time. For a live feed, schedule runs every 5–15 minutes via Apify's built-in scheduler.

**Can I detect newly listed tokens automatically?**
Yes — request the full pair list in two consecutive runs and diff the `pair_index` or `base_token` sets. New entries represent tokens freshly listed on HLP spot markets. This is one of the most common use cases for early-listing alpha.

> **Disclaimer:** This actor fetches publicly available market data from Hyperliquid's API. Nothing in this output constitutes financial advice or a recommendation to trade any token. Market data may lag during periods of extreme volatility. All trading decisions are made at your own risk.

***

### Related Actors

- **[Hyperliquid Whale Tracker](https://apify.com/gochujang/hyperliquid-whale-tracker)** — Monitor large perp positions on the Hyperliquid derivatives side.
- **[Long-Short OI Aggregator](https://apify.com/gochujang/long-short-oi-aggregator)** — Compare HL perp positioning against the broader crypto derivatives market.
- **[Smart Money Wallet Tracker](https://apify.com/gochujang/smart-money-tracker)** — Track on-chain whale activity for HL-listed tokens.
- **[CEX Funding Rate Aggregator](https://apify.com/gochujang/cex-funding-aggregator)** — Cross-reference spot HL prices with funding rates on Binance, Bybit, and OKX.

***

### Live Sample Run

A real run executed on 2026-06-10 with default inputs:

| Field | Value |
|-------|-------|
| Items in dataset | 15 |
| Dataset (JSON) | `https://api.apify.com/v2/datasets/hI0ygZ64dj7IB5kC1/items?clean=1&format=json` |
| Dataset (CSV) | `https://api.apify.com/v2/datasets/hI0ygZ64dj7IB5kC1/items?clean=1&format=csv` |
| Run summary (KVS) | `https://api.apify.com/v2/key-value-stores/2nVsOFrPyB2gBDH2g/records/SUMMARY` |
| Run details | `https://api.apify.com/v2/actor-runs/g5AETgGcui0NJ0KG6` |

### Feedback

[Leave a review on Apify Store](https://apify.com/gochujang/hyperliquid-spot-tracker#reviews)

# Actor input Schema

## `symbols` (type: `array`):

Limit to specific base symbols (e.g. HYPE, PURR). Empty = all 300+ pairs.

## `minVolume24hUsd` (type: `integer`):

Skip illiquid pairs below this notional 24h volume.

## `minMarketCapUsd` (type: `integer`):

Skip pairs below this market cap.

## `sortBy` (type: `string`):

Sort order.

## `limit` (type: `integer`):

Maximum number of pairs to return.

## `alertChange24hPct` (type: `number`):

Telegram alert when any pair's |24h change| ≥ X%. 0 = disabled.

## `telegramBotToken` (type: `string`):

Telegram bot token.

## `telegramChatId` (type: `string`):

Telegram chat ID to send alerts to (get it from @userinfobot)

## `includeExtendedHistory` (type: `boolean`):

Optional parameter: includeExtendedHistory

## Actor input object example

```json
{
  "symbols": [],
  "minVolume24hUsd": 10000,
  "minMarketCapUsd": 0,
  "sortBy": "volume_24h_desc",
  "limit": 100,
  "alertChange24hPct": 0,
  "telegramChatId": ""
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `summary` (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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("gochujang/hyperliquid-spot-tracker").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("gochujang/hyperliquid-spot-tracker").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 '{}' |
apify call gochujang/hyperliquid-spot-tracker --silent --output-dataset

```

## MCP server setup

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

```

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/MebZTweVuzeEub5ar/builds/NYuOaUAQ0Ia54Sreb/openapi.json