---
type: "firecrawl-provider"
description: "Hyperliquid perpetual markets: live funding and open interest, historical funding, candles, order books, trades, per-address positions, fills (with liquidations), funding payments and ledger, plus vault details, from Hyperliquid's public info API."
use_when: "Hyperliquid perpetual markets: live funding and open interest, historical funding, candles, order books, trades, per-address positions, fills (with liquidations), funding payments and ledger, plus vault details, from Hyperliquid's public info API."
categories: "Finance"
capabilities: 12
credits_per_call: 5
---
# Hyperliquid on Firecrawl Alexandria

Hyperliquid perpetual markets: live funding and open interest, historical funding, candles, order books, trades, per-address positions, fills (with liquidations), funding payments and ledger, plus vault details, from Hyperliquid's public info API.

- Categories: Finance
- Category index: [Finance category](https://firecrawl.dev/alexandria/agents/categories/finance)
- Provider key: `hyperliquid-xyz`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/hyperliquid-xyz)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/openapi.json)

## Capabilities

- [Account](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/account): Perpetual account state for an address: margin summaries, withdrawable balance and open positions with entry, liquidation price, leverage and cumulative funding.
- [Account fills](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/account_fills): Fills for an address in a time window, oldest first, up to 2000 per page; each fill that was a liquidation carries the liquidated user, mark price and method.
- [Account funding](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/account_funding): Funding payments an address paid or received in a time window, oldest first, with the position size and rate behind each payment.
- [Account ledger](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/account_ledger): Non-funding ledger entries for an address in a time window, oldest first: deposits, withdrawals, transfers, vault flows and liquidation ledger entries, each with the API's full delta.
- [Candles](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/candles): OHLCV candles for one market over a time window (perp or spot), oldest first, up to 5000 candles per page.
- [Exchange stats](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/exchange_stats): Exchange-wide totals (all-time and 24h volume, user count, open interest) and the perps currently at their open-interest cap.
- [Funding history](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/funding_history): Historical hourly funding rates for one perpetual over a time window, oldest first, up to 500 rows per page with a cursor for the next page.
- [Markets](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/markets): Live perpetual markets on Hyperliquid (native dex or one HIP-3 builder dex): metadata plus current mark, oracle and mid prices, hourly funding, open interest and 24h volume for every perp, or for one coin.
- [Order book](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/order_book): Level-2 order book snapshot for one market: aggregated bid and ask levels with price, size and order count.
- [Predicted fundings](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/predicted_fundings): Predicted next funding rate per coin on Hyperliquid alongside Binance and Bybit perps, with each venue's next funding time and interval.
- [Recent trades](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/recent_trades): Most recent public trades for one market, newest first, with price, size, side, time, transaction hash and counterparties.
- [Vault](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/vault): Details of one vault: name, leader, description, APR, leader fraction and commission, deposit state, parent/child relationship, portfolio summary per window and optionally its followers.

## 1. Choose this provider when

Hyperliquid perpetual markets: live funding and open interest, historical funding, candles, order books, trades, per-address positions, fills (with liquidations), funding payments and ledger, plus vault details, from Hyperliquid's public info API.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "hyperliquid-xyz",
  "capability": "markets/account",
  "options": {
    "address": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `address` (string, required): 0x-prefixed 40-hex address (user, sub-account or vault). Case-insensitive; normalized to lowercase in the output. Pattern: ^0x[0-9a-fA-F]{40}$. Example: `<address>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "hyperliquid-xyz",
    capability: "markets/account",
    options: {
      address: "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "hyperliquid-xyz",
  "capability": "markets/account",
  "options": {
    "address": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "hyperliquid-xyz",
    "capability": "markets/account",
    "options": {
      "address": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'hyperliquid-xyz/markets/account' \
  --options '{"address":"0xdfc24b077bc1425ad1dea75bcb6f8158e10df303"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "hyperliquid-xyz",
  "capability": "markets/account",
  "options": {
    "address": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "hyperliquid-xyz",
  "capability": "markets/account",
  "options": {
    "address": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "address": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
  "cross_maintenance_margin_used": "0.0",
  "cross_margin_summary": {
    "account_value": "45198916.2830799967",
    "total_margin_used": "0.0",
    "total_ntl_pos": "0.0",
    "total_raw_usd": "45198916.2830799967"
  },
  "margin_summary": {
    "account_value": "45199394.1504769996",
    "total_margin_used": "477.867397",
    "total_ntl_pos": "0.0",
    "total_raw_usd": "45199394.1504769996"
  },
  "observed_at_ms": 1790118559561,
  "position_count": 0,
  "positions": [],
  "time": 1790118559212,
  "url": "https://app.hyperliquid.xyz/explorer/address/0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
  "withdrawable": "45198916.2830799967"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Account

- Capability: `markets/account`
- Description: Perpetual account state for an address: margin summaries, withdrawable balance and open positions with entry, liquidation price, leverage and cumulative funding.
- Instructions: Positions and liquidation prices for a trader, sub-account or vault address (from recent_trades users, account_fills or a vault). An address the chain has never seen is not_found; an empty account is a success with no positions.
- Cost: 5 credits per call
- Capability file: [Account](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/account)

Accepted options:
- `address` (string, required): 0x-prefixed 40-hex address (user, sub-account or vault). Case-insensitive; normalized to lowercase in the output. Pattern: ^0x[0-9a-fA-F]{40}$. Example: `<address>`

Response schema example:
```json
{
  "address": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
  "cross_maintenance_margin_used": "0.0",
  "cross_margin_summary": {
    "account_value": "45198916.2830799967",
    "total_margin_used": "0.0",
    "total_ntl_pos": "0.0",
    "total_raw_usd": "45198916.2830799967"
  },
  "margin_summary": {
    "account_value": "45199394.1504769996",
    "total_margin_used": "477.867397",
    "total_ntl_pos": "0.0",
    "total_raw_usd": "45199394.1504769996"
  },
  "observed_at_ms": 1790118559561,
  "position_count": 0,
  "positions": [],
  "time": 1790118559212,
  "url": "https://app.hyperliquid.xyz/explorer/address/0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
  "withdrawable": "45198916.2830799967"
}
```

### Account fills

- Capability: `markets/account_fills`
- Description: Fills for an address in a time window, oldest first, up to 2000 per page; each fill that was a liquidation carries the liquidated user, mark price and method.
- Instructions: Trade and liquidation history for an address. Give start_time (unix ms) and optionally end_time; follow next_cursor as cursor. This is the only per-event liquidation record in the public API.
- Cost: 5 credits per call
- Capability file: [Account fills](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/account_fills)

Accepted options:
- `address` (string, required): 0x-prefixed 40-hex address (user, sub-account or vault). Case-insensitive; normalized to lowercase in the output. Pattern: ^0x[0-9a-fA-F]{40}$. Example: `<address>`
- `aggregate_by_time` (boolean): Combine partial fills of one order at the same time into one row, as the API offers. Example: `false`
- `cursor` (string): next_cursor from the previous page: the millisecond start time of the next page. Send it instead of start_time with the same other inputs. Pattern: ^[0-9]{1,16}$. Example: `<cursor>`
- `end_time` (number): Window end, unix milliseconds (inclusive). Defaults to now. Example: `10`
- `start_time` (number): Window start, unix milliseconds (inclusive). Either start_time or cursor is required. Example: `10`

Response schema example:
```json
{
  "address": "0xab112398e16f586bd2be0bbe490b9c08ca08f86e",
  "count": 6,
  "end_time": 1790101150000,
  "fills": [
    {
      "builder_fee": null,
      "cloid": "0x0000000000000023000001a0ca4e609e",
      "closed_pnl": "0.3784",
      "coin": "ETH",
      "crossed": false,
      "dir": "Close Long",
      "fee": "0.070825",
      "fee_token": "USDC",
      "hash": "0x20db88b15c78ee2a22550444fa32d70201c40096f77c0cfcc4a434041b7cc814",
      "liquidation": null,
      "oid": 553275566228,
      "px": "2752.5",
      "side": "A",
      "start_position": "1.5132",
      "sz": "0.7568",
      "tid": 343569771423886,
      "time": 1790100533456,
      "twap_id": null,
      "url": "https://app.hyperliquid.xyz/explorer/tx/0x20db88b15c78ee2a22550444fa32d70201c40096f77c0cfcc4a434041b7cc814"
    },
    {
      "builder_fee": null,
      "cloid": "0x0000000000000019000001a0ca4f5452",
      "closed_pnl": "0.3782",
      "coin": "ETH",
      "crossed": true,
      "dir": "Close Long",
      "fee": "0.530907",
      "fee_token": "USDC",
      "hash": "0x149eb053cce3cf5316180444fa35e60201d8003967e6ee25b8675ba68be7a93d",
      "liquidation": null,
      "oid": 553276329224,
      "px": "2752.5",
      "side": "A",
      "start_position": "0.7564",
      "sz": "0.7564",
      "tid": 821380648068269,
      "time": 1790100592117,
      "twap_id": null,
      "url": "https://app.hyperliquid.xyz/explorer/tx/0x149eb053cce3cf5316180444fa35e60201d8003967e6ee25b8675ba68be7a93d"
    },
    {
      "builder_fee": null,
      "cloid": "0x0000000000000017000001a0ca4fe43a",
      "closed_pnl": "0.0",
      "coin": "ETH",
      "crossed": false,
      "dir": "Open Short",
      "fee": "0.070836",
      "fee_token": "USDC",
      "hash": "0x495fbe610f9fbb0b4ad90444fa38080202110046aa92d9dded2869b3ce9394f5",
      "liquidation": null,
      "oid": 553276836632,
      "px": "2750.4",
      "side": "A",
      "start_position": "0.0",
      "sz": "0.7575",
      "tid": 780551410390203,
      "time": 1790100634829,
      "twap_id": null,
      "url": "https://app.hyperliquid.xyz/explorer/tx/0x495fbe610f9fbb0b4ad90444fa38080202110046aa92d9dded2869b3ce9394f5"
    },
    {
      "builder_fee": null,
      "cloid": "0x000000000000001f000001a0ca50778c",
      "closed_pnl": "0.0",
      "coin": "ETH",
      "crossed": false,
      "dir": "Open Short",
      "fee": "0.070835",
      "fee_token": "USDC",
      "hash": "0x9464d7f3b7db486e95de0444fa39e202047300d952de6740382d834676df2259",
      "liquidation": null,
      "oid": 553277291368,
      "px": "2750.0",
      "side": "A",
      "start_position": "-0.7575",
      "sz": "0.7576",
      "tid": 758037615725834,
      "time": 1790100668758,
      "twap_id": null,
      "url": "https://app.hyperliquid.xyz/explorer/tx/0x9464d7f3b7db486e95de0444fa39e202047300d952de6740382d834676df2259"
    },
    {
      "builder_fee": null,
      "cloid": "0x000000000000001e000001a0ca5102cf",
      "closed_pnl": "0.0",
      "coin": "ETH",
      "crossed": false,
      "dir": "Open Short",
      "fee": "0.070734",
      "fee_token": "USDC",
      "hash": "0x7c981b51af04187f7e110444fa3c910205b300374a0737512060c6a46e07f26a",
      "liquidation": null,
      "oid": 553277861157,
      "px": "2753.7",
      "side": "A",
      "start_position": "-1.5151",
      "sz": "0.7555",
      "tid": 1005149489126465,
      "time": 1790100717717,
      "twap_id": null,
      "url": "https://app.hyperliquid.xyz/explorer/tx/0x7c981b51af04187f7e110444fa3c910205b300374a0737512060c6a46e07f26a"
    },
    {
      "builder_fee": null,
      "cloid": "0x000000000000001b000001a0ca57394a",
      "closed_pnl": "-4.709328",
      "coin": "ETH",
      "crossed": true,
      "dir": "Close Short",
      "fee": "0.530695",
      "fee_token": "USDC",
      "hash": "0xa61f6a1e5fc77757a7990444fa51dc0202e80003faca962949e815711ecb5142",
      "liquidation": null,
      "oid": 553283289629,
      "px": "2757.6",
      "side": "B",
      "start_position": "-2.2706",
      "sz": "0.7547",
      "tid": 782798706848205,
      "time": 1790101109641,
      "twap_id": null,
      "url": "https://app.hyperliquid.xyz/explorer/tx/0xa61f6a1e5fc77757a7990444fa51dc0202e80003faca962949e815711ecb5142"
    }
  ],
  "liquidation_count": 0,
  "next_cursor": null,
  "observed_at_ms": 1790118563448,
  "start_time": 1790100000000
}
```

### Account funding

- Capability: `markets/account_funding`
- Description: Funding payments an address paid or received in a time window, oldest first, with the position size and rate behind each payment.
- Instructions: Realized funding for a trader or vault. Give start_time and optionally end_time; follow next_cursor as cursor.
- Cost: 5 credits per call
- Capability file: [Account funding](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/account_funding)

Accepted options:
- `address` (string, required): 0x-prefixed 40-hex address (user, sub-account or vault). Case-insensitive; normalized to lowercase in the output. Pattern: ^0x[0-9a-fA-F]{40}$. Example: `<address>`
- `cursor` (string): next_cursor from the previous page: the millisecond start time of the next page. Send it instead of start_time with the same other inputs. Pattern: ^[0-9]{1,16}$. Example: `<cursor>`
- `end_time` (number): Window end, unix milliseconds (inclusive). Defaults to now. Example: `10`
- `start_time` (number): Window start, unix milliseconds (inclusive). Either start_time or cursor is required. Example: `10`

Response schema example:
```json
{
  "address": "0xab112398e16f586bd2be0bbe490b9c08ca08f86e",
  "count": 6,
  "end_time": 1787961600000,
  "next_cursor": null,
  "observed_at_ms": 1790118567283,
  "rows": [
    {
      "coin": "ETH",
      "funding_rate": "0.0000120664",
      "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "n_samples": 24,
      "szi": "2.0203208333",
      "time": 1787529600000,
      "usdc": "-1.4227"
    },
    {
      "coin": "ETH",
      "funding_rate": "0.0000088097",
      "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "n_samples": 24,
      "szi": "1.2294541667",
      "time": 1787616000000,
      "usdc": "-0.645498"
    },
    {
      "coin": "ETH",
      "funding_rate": "0.0000121879",
      "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "n_samples": 24,
      "szi": "0.9811916667",
      "time": 1787702400000,
      "usdc": "-0.700685"
    },
    {
      "coin": "ETH",
      "funding_rate": "0.0000130854",
      "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "n_samples": 24,
      "szi": "1.28535",
      "time": 1787788800000,
      "usdc": "-1.014551"
    },
    {
      "coin": "ETH",
      "funding_rate": "0.000012506",
      "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "n_samples": 24,
      "szi": "-3.2343791667",
      "time": 1787875200000,
      "usdc": "2.419204"
    },
    {
      "coin": "ETH",
      "funding_rate": "0.0000125",
      "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "n_samples": 24,
      "szi": "-1.1937291667",
      "time": 1787961600000,
      "usdc": "0.870594"
    }
  ],
  "start_time": 1787529600000
}
```

### Account ledger

- Capability: `markets/account_ledger`
- Description: Non-funding ledger entries for an address in a time window, oldest first: deposits, withdrawals, transfers, vault flows and liquidation ledger entries, each with the API's full delta.
- Instructions: Money movements and liquidation ledger entries for an address. Give start_time and optionally end_time; follow next_cursor as cursor.
- Cost: 5 credits per call
- Capability file: [Account ledger](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/account_ledger)

Accepted options:
- `address` (string, required): 0x-prefixed 40-hex address (user, sub-account or vault). Case-insensitive; normalized to lowercase in the output. Pattern: ^0x[0-9a-fA-F]{40}$. Example: `<address>`
- `cursor` (string): next_cursor from the previous page: the millisecond start time of the next page. Send it instead of start_time with the same other inputs. Pattern: ^[0-9]{1,16}$. Example: `<cursor>`
- `end_time` (number): Window end, unix milliseconds (inclusive). Defaults to now. Example: `10`
- `start_time` (number): Window start, unix milliseconds (inclusive). Either start_time or cursor is required. Example: `10`

Response schema example:
```json
{
  "address": "0xab112398e16f586bd2be0bbe490b9c08ca08f86e",
  "count": 4,
  "end_time": 1789913000000,
  "next_cursor": null,
  "observed_at_ms": 1790118570945,
  "rows": [
    {
      "delta": {
        "amount": "5.79",
        "destination": "0xab112398e16f586bd2be0bbe490b9c08ca08f86e",
        "destinationDex": "",
        "fee": "0.0",
        "feeToken": "",
        "nativeTokenFee": "0.0",
        "nonce": 1789902107149,
        "sourceDex": "",
        "token": "USDC",
        "type": "send",
        "usdcValue": "5.79",
        "user": "0xc48d982ebb61fcdf5a5f95f91f9a285532c17d57"
      },
      "hash": "0x8557437891799d4186d00444cfdc2e0202a1005e2c7cbc13291feecb507d772c",
      "time": 1789902107660,
      "type": "send",
      "url": "https://app.hyperliquid.xyz/explorer/tx/0x8557437891799d4186d00444cfdc2e0202a1005e2c7cbc13291feecb507d772c"
    },
    {
      "delta": {
        "amount": "23.45",
        "destination": "0xab112398e16f586bd2be0bbe490b9c08ca08f86e",
        "destinationDex": "",
        "fee": "0.0",
        "feeToken": "",
        "nativeTokenFee": "0.0",
        "nonce": 1789905713424,
        "sourceDex": "",
        "token": "USDC",
        "type": "send",
        "usdcValue": "23.45",
        "user": "0xc48d982ebb61fcdf5a5f95f91f9a285532c17d57"
      },
      "hash": "0xade9810059d5b046af630444d0a1840201e900e5f4d8cf1851b22c5318d98a31",
      "time": 1789905713917,
      "type": "send",
      "url": "https://app.hyperliquid.xyz/explorer/tx/0xade9810059d5b046af630444d0a1840201e900e5f4d8cf1851b22c5318d98a31"
    },
    {
      "delta": {
        "amount": "31.27",
        "destination": "0xab112398e16f586bd2be0bbe490b9c08ca08f86e",
        "destinationDex": "",
        "fee": "0.0",
        "feeToken": "",
        "nativeTokenFee": "0.0",
        "nonce": 1789909318297,
        "sourceDex": "",
        "token": "USDC",
        "type": "send",
        "usdcValue": "31.27",
        "user": "0xc48d982ebb61fcdf5a5f95f91f9a285532c17d57"
      },
      "hash": "0x8e252b446f2c48738f9e0444d1688d020219002a0a2f674531edd6972e20225e",
      "time": 1789909318769,
      "type": "send",
      "url": "https://app.hyperliquid.xyz/explorer/tx/0x8e252b446f2c48738f9e0444d1688d020219002a0a2f674531edd6972e20225e"
    },
    {
      "delta": {
        "amount": "6.51",
        "destination": "0xc48d982ebb61fcdf5a5f95f91f9a285532c17d57",
        "destinationDex": "",
        "fee": "0.0",
        "feeToken": "",
        "nativeTokenFee": "0.0",
        "nonce": 1789912924080,
        "sourceDex": "",
        "token": "USDC",
        "type": "send",
        "usdcValue": "6.51",
        "user": "0xab112398e16f586bd2be0bbe490b9c08ca08f86e"
      },
      "hash": "0x8433661bcb4520d685ad0444d22dcf020561000166483fa827fc116e8a48fac1",
      "time": 1789912924612,
      "type": "send",
      "url": "https://app.hyperliquid.xyz/explorer/tx/0x8433661bcb4520d685ad0444d22dcf020561000166483fa827fc116e8a48fac1"
    }
  ],
  "start_time": 1789900000000
}
```

### Candles

- Capability: `markets/candles`
- Description: OHLCV candles for one market over a time window (perp or spot), oldest first, up to 5000 candles per page.
- Instructions: Price history for a coin from markets. Intervals: 1m 3m 5m 15m 30m 1h 2h 4h 8h 12h 1d 3d 1w 1M. Follow next_cursor as cursor for more.
- Cost: 5 credits per call
- Capability file: [Candles](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/candles)

Accepted options:
- `coin` (string, required): Market name as Hyperliquid states it: a native perp such as BTC, a HIP-3 builder perp prefixed with its dex such as xyz:TSLA, or a spot pair such as PURR/USDC or @107. Pattern: ^[A-Za-z0-9@#][A-Za-z0-9:@#._/-]{0,63}$. Example: `<coin>`
- `cursor` (string): next_cursor from the previous page: the millisecond start time of the next page. Send it instead of start_time with the same other inputs. Pattern: ^[0-9]{1,16}$. Example: `<cursor>`
- `end_time` (number): Window end, unix milliseconds (inclusive). Defaults to now. Example: `10`
- `interval` (string, required): interval Example: `1m`
- `start_time` (number): Window start, unix milliseconds (inclusive). Either start_time or cursor is required. Example: `10`

Response schema example:
```json
{
  "candles": [
    {
      "close": "81119.0",
      "close_time": 1789855199999,
      "high": "81253.0",
      "low": "80933.0",
      "open": "81180.0",
      "open_time": 1789851600000,
      "trades": 9421,
      "volume": "647.0671"
    },
    {
      "close": "81287.0",
      "close_time": 1789858799999,
      "high": "81289.0",
      "low": "81000.0",
      "open": "81119.0",
      "open_time": 1789855200000,
      "trades": 5573,
      "volume": "289.0026"
    },
    {
      "close": "81292.0",
      "close_time": 1789862399999,
      "high": "81403.0",
      "low": "81252.0",
      "open": "81286.0",
      "open_time": 1789858800000,
      "trades": 4923,
      "volume": "302.18103"
    },
    {
      "close": "81330.0",
      "close_time": 1789865999999,
      "high": "81364.0",
      "low": "81233.0",
      "open": "81292.0",
      "open_time": 1789862400000,
      "trades": 5288,
      "volume": "456.33562"
    },
    {
      "close": "81125.0",
      "close_time": 1789869599999,
      "high": "81328.0",
      "low": "81044.0",
      "open": "81328.0",
      "open_time": 1789866000000,
      "trades": 6464,
      "volume": "528.89961"
    },
    {
      "close": "80360.0",
      "close_time": 1789873199999,
      "high": "81185.0",
      "low": "80277.0",
      "open": "81125.0",
      "open_time": 1789869600000,
      "trades": 16987,
      "volume": "1885.99984"
    }
  ],
  "coin": "BTC",
  "count": 6,
  "end_time": 1789872000000,
  "interval": "1h",
  "next_cursor": null,
  "observed_at_ms": 1790118535560,
  "start_time": 1789854000000
}
```

### Exchange stats

- Capability: `markets/exchange_stats`
- Description: Exchange-wide totals (all-time and 24h volume, user count, open interest) and the perps currently at their open-interest cap.
- Instructions: A quick health and size read of the exchange; the at-cap list tells which markets cannot take new open interest right now.
- Cost: 5 credits per call
- Capability file: [Exchange stats](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/exchange_stats)

Accepted options:

Response schema example:
```json
{
  "at_open_interest_cap": [
    "CANTO",
    "FTM",
    "HMSTR",
    "JELLY",
    "LOOM",
    "RLB",
    "SAGA",
    "VINE",
    "ZEREBRO"
  ],
  "daily_volume": 9840173626.534851,
  "observed_at_ms": 1790118578959,
  "open_interest": "18057612537.8566093445",
  "total_volume": 5653190838511.517,
  "user_count": 2610570
}
```

### Funding history

- Capability: `markets/funding_history`
- Description: Historical hourly funding rates for one perpetual over a time window, oldest first, up to 500 rows per page with a cursor for the next page.
- Instructions: Historical funding for a coin from markets. Give start_time (unix ms) and optionally end_time; follow next_cursor as cursor until page.continuation is exhausted.
- Cost: 5 credits per call
- Capability file: [Funding history](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/funding_history)

Accepted options:
- `coin` (string, required): Market name as Hyperliquid states it: a native perp such as BTC, a HIP-3 builder perp prefixed with its dex such as xyz:TSLA, or a spot pair such as PURR/USDC or @107. Pattern: ^[A-Za-z0-9@#][A-Za-z0-9:@#._/-]{0,63}$. Example: `<coin>`
- `cursor` (string): next_cursor from the previous page: the millisecond start time of the next page. Send it instead of start_time with the same other inputs. Pattern: ^[0-9]{1,16}$. Example: `<cursor>`
- `end_time` (number): Window end, unix milliseconds (inclusive). Defaults to now. Example: `10`
- `start_time` (number): Window start, unix milliseconds (inclusive). Either start_time or cursor is required. Example: `10`

Response schema example:
```json
{
  "coin": "BTC",
  "count": 6,
  "end_time": 1789531200000,
  "next_cursor": null,
  "observed_at_ms": 1790118454276,
  "rows": [
    {
      "coin": "BTC",
      "funding_rate": "0.0000091338",
      "premium": "-0.0004269295",
      "time": 1789509600043
    },
    {
      "coin": "BTC",
      "funding_rate": "0.0000102072",
      "premium": "-0.0004183428",
      "time": 1789513200062
    },
    {
      "coin": "BTC",
      "funding_rate": "0.0000108086",
      "premium": "-0.0004135313",
      "time": 1789516800021
    },
    {
      "coin": "BTC",
      "funding_rate": "0.0000121721",
      "premium": "-0.0004026232",
      "time": 1789520400024
    },
    {
      "coin": "BTC",
      "funding_rate": "0.0000125",
      "premium": "-0.0003856869",
      "time": 1789524000058
    },
    {
      "coin": "BTC",
      "funding_rate": "0.0000125",
      "premium": "-0.0003252958",
      "time": 1789527600035
    }
  ],
  "start_time": 1789509600000
}
```

### Markets

- Capability: `markets/markets`
- Description: Live perpetual markets on Hyperliquid (native dex or one HIP-3 builder dex): metadata plus current mark, oracle and mid prices, hourly funding, open interest and 24h volume for every perp, or for one coin.
- Instructions: Start here to discover coin identifiers and read live funding and open interest. Pass dex for a HIP-3 builder dex (from a dex-prefixed coin such as xyz:TSLA). Pass coin to get one market. History is in funding_history and candles.
- Cost: 5 credits per call
- Capability file: [Markets](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/markets)

Accepted options:
- `coin` (string): Market name as Hyperliquid states it: a native perp such as BTC, a HIP-3 builder perp prefixed with its dex such as xyz:TSLA, or a spot pair such as PURR/USDC or @107. Pattern: ^[A-Za-z0-9@#][A-Za-z0-9:@#._/-]{0,63}$. Example: `<coin>`
- `dex` (string): HIP-3 builder dex name (e.g. xyz). Omit for the native dex. Pattern: ^[a-z0-9]{1,12}$. Example: `<dex>`

Response schema example:
```json
{
  "collateral_token": 0,
  "count": 1,
  "dex": null,
  "markets": [
    {
      "coin": "BTC",
      "day_base_vlm": "31451.84186",
      "day_ntl_vlm": "2705934540.5221138",
      "dex": null,
      "funding": "0.0000125",
      "impact_pxs": [
        "86438.0",
        "86441.3"
      ],
      "is_delisted": false,
      "margin_mode": null,
      "margin_table_id": 56,
      "mark_px": "86420.0",
      "max_leverage": 40,
      "mid_px": "86438.5",
      "only_isolated": false,
      "open_interest": "46224.83712",
      "oracle_px": "86386.0",
      "premium": "0.0006019494",
      "prev_day_px": "86692.0",
      "sz_decimals": 5,
      "url": "https://app.hyperliquid.xyz/trade/BTC"
    }
  ],
  "observed_at_ms": 1790118449162
}
```

### Order book

- Capability: `markets/order_book`
- Description: Level-2 order book snapshot for one market: aggregated bid and ask levels with price, size and order count.
- Instructions: Current liquidity for a coin from markets. n_sig_figs (2-5) aggregates levels to fewer significant figures.
- Cost: 5 credits per call
- Capability file: [Order book](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/order_book)

Accepted options:
- `coin` (string, required): Market name as Hyperliquid states it: a native perp such as BTC, a HIP-3 builder perp prefixed with its dex such as xyz:TSLA, or a spot pair such as PURR/USDC or @107. Pattern: ^[A-Za-z0-9@#][A-Za-z0-9:@#._/-]{0,63}$. Example: `<coin>`
- `n_sig_figs` (number): Aggregate price levels to this many significant figures; omit for full precision. Example: `5`

Response schema example:
```json
{
  "ask_count": 20,
  "asks": [
    {
      "n": 29,
      "px": "86472.0",
      "sz": "6.87326"
    },
    {
      "n": 2,
      "px": "86473.0",
      "sz": "0.01885"
    },
    {
      "n": 6,
      "px": "86474.0",
      "sz": "0.11098"
    },
    {
      "n": 4,
      "px": "86475.0",
      "sz": "0.05679"
    },
    {
      "n": 7,
      "px": "86476.0",
      "sz": "1.48434"
    },
    {
      "n": 3,
      "px": "86477.0",
      "sz": "0.09951"
    },
    {
      "n": 6,
      "px": "86478.0",
      "sz": "2.65177"
    },
    {
      "n": 4,
      "px": "86479.0",
      "sz": "0.97701"
    },
    {
      "n": 12,
      "px": "86480.0",
      "sz": "4.20429"
    },
    {
      "n": 6,
      "px": "86481.0",
      "sz": "0.8717"
    },
    {
      "n": 7,
      "px": "86482.0",
      "sz": "0.7205"
    },
    {
      "n": 4,
      "px": "86483.0",
      "sz": "0.73871"
    },
    {
      "n": 6,
      "px": "86484.0",
      "sz": "2.22444"
    },
    {
      "n": 8,
      "px": "86485.0",
      "sz": "3.34708"
    },
    {
      "n": 6,
      "px": "86486.0",
      "sz": "5.29847"
    },
    {
      "n": 12,
      "px": "86487.0",
      "sz": "2.57518"
    },
    {
      "n": 9,
      "px": "86488.0",
      "sz": "2.42803"
    },
    {
      "n": 11,
      "px": "86489.0",
      "sz": "2.06986"
    },
    {
      "n": 9,
      "px": "86490.0",
      "sz": "3.33579"
    },
    {
      "n": 6,
      "px": "86491.0",
      "sz": "0.45904"
    }
  ],
  "bid_count": 20,
  "bids": [
    {
      "n": 12,
      "px": "86471.0",
      "sz": "71.93741"
    },
    {
      "n": 1,
      "px": "86468.0",
      "sz": "0.00047"
    },
    {
      "n": 3,
      "px": "86467.0",
      "sz": "1.07389"
    },
    {
      "n": 1,
      "px": "86466.0",
      "sz": "1.63812"
    },
    {
      "n": 1,
      "px": "86465.0",
      "sz": "0.00578"
    },
    {
      "n": 1,
      "px": "86464.0",
      "sz": "0.36769"
    },
    {
      "n": 11,
      "px": "86463.0",
      "sz": "1.07421"
    },
    {
      "n": 1,
      "px": "86462.0",
      "sz": "0.0022"
    },
    {
      "n": 2,
      "px": "86461.0",
      "sz": "0.02234"
    },
    {
      "n": 5,
      "px": "86460.0",
      "sz": "1.6655"
    },
    {
      "n": 7,
      "px": "86459.0",
      "sz": "1.74864"
    },
    {
      "n": 10,
      "px": "86458.0",
      "sz": "3.33441"
    },
    {
      "n": 7,
      "px": "86457.0",
      "sz": "1.33407"
    },
    {
      "n": 6,
      "px": "86456.0",
      "sz": "2.01345"
    },
    {
      "n": 6,
      "px": "86455.0",
      "sz": "0.29535"
    },
    {
      "n": 6,
      "px": "86454.0",
      "sz": "2.38219"
    },
    {
      "n": 4,
      "px": "86453.0",
      "sz": "0.21387"
    },
    {
      "n": 14,
      "px": "86452.0",
      "sz": "4.47118"
    },
    {
      "n": 6,
      "px": "86451.0",
      "sz": "9.55028"
    },
    {
      "n": 9,
      "px": "86450.0",
      "sz": "1.34091"
    }
  ],
  "coin": "BTC",
  "observed_at_ms": 1790118552063,
  "time": 1790118551558
}
```

### Predicted fundings

- Capability: `markets/predicted_fundings`
- Description: Predicted next funding rate per coin on Hyperliquid alongside Binance and Bybit perps, with each venue's next funding time and interval.
- Instructions: Compare upcoming funding across venues or fetch the next Hyperliquid funding for all coins in one call. Pass coin to filter to one market.
- Cost: 5 credits per call
- Capability file: [Predicted fundings](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/predicted_fundings)

Accepted options:
- `coin` (string): Market name as Hyperliquid states it: a native perp such as BTC, a HIP-3 builder perp prefixed with its dex such as xyz:TSLA, or a spot pair such as PURR/USDC or @107. Pattern: ^[A-Za-z0-9@#][A-Za-z0-9:@#._/-]{0,63}$. Example: `<coin>`

Response schema example:
```json
{
  "count": 1,
  "observed_at_ms": 1790118458248,
  "rows": [
    {
      "coin": "BTC",
      "venues": [
        {
          "funding_interval_hours": 8,
          "funding_rate": "-0.00000235",
          "next_funding_time": 1790121600000,
          "venue": "BinPerp"
        },
        {
          "funding_interval_hours": 1,
          "funding_rate": "0.0000125",
          "next_funding_time": 1790118000000,
          "venue": "HlPerp"
        },
        {
          "funding_interval_hours": 8,
          "funding_rate": "0.0000364",
          "next_funding_time": 1790121600000,
          "venue": "BybitPerp"
        }
      ]
    }
  ]
}
```

### Recent trades

- Capability: `markets/recent_trades`
- Description: Most recent public trades for one market, newest first, with price, size, side, time, transaction hash and counterparties.
- Instructions: Latest prints for a coin from markets. For a user's own fills use account_fills.
- Cost: 5 credits per call
- Capability file: [Recent trades](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/recent_trades)

Accepted options:
- `coin` (string, required): Market name as Hyperliquid states it: a native perp such as BTC, a HIP-3 builder perp prefixed with its dex such as xyz:TSLA, or a spot pair such as PURR/USDC or @107. Pattern: ^[A-Za-z0-9@#][A-Za-z0-9:@#._/-]{0,63}$. Example: `<coin>`

Response schema example:
```json
{
  "coin": "BTC",
  "count": 10,
  "observed_at_ms": 1790118555767,
  "trades": [
    {
      "coin": "BTC",
      "hash": "0x91329d669b63845692ac0444fe0bf70202eb004c3666a32834fb48b95a675e41",
      "px": "86472.0",
      "side": "B",
      "sz": "0.00325",
      "tid": 610637312180163,
      "time": 1790118554051,
      "url": "https://app.hyperliquid.xyz/explorer/tx/0x91329d669b63845692ac0444fe0bf70202eb004c3666a32834fb48b95a675e41",
      "users": [
        "0x785ea23df7740584127b290a695ac766f498317e",
        "0x6a072733f7249e6b794cae88c6d3cc7eb756a93c"
      ]
    },
    {
      "coin": "BTC",
      "hash": "0xf4506bbdc0e2305ff5ca0444fe0bf502028d00a35be54f32981917107fe60a4a",
      "px": "86472.0",
      "side": "B",
      "sz": "0.00101",
      "tid": 786756747642678,
      "time": 1790118553914,
      "url": "https://app.hyperliquid.xyz/explorer/tx/0xf4506bbdc0e2305ff5ca0444fe0bf502028d00a35be54f32981917107fe60a4a",
      "users": [
        "0xb0060bc88738b915a37246ca650463ef9b9eddf3",
        "0x6a072733f7249e6b794cae88c6d3cc7eb756a93c"
      ]
    },
    {
      "coin": "BTC",
      "hash": "0x67a81f7e9f44f36569210444fe0bf402052800643a4812370b70cad15e48cd50",
      "px": "86471.0",
      "side": "A",
      "sz": "0.04484",
      "tid": 248749330185333,
      "time": 1790118553847,
      "url": "https://app.hyperliquid.xyz/explorer/tx/0x67a81f7e9f44f36569210444fe0bf402052800643a4812370b70cad15e48cd50",
      "users": [
        "0x78dce96236804d6958bf3c4598cf5efbc371629c",
        "0x8d97bdea1b8c4c5979b36634bc204d0357a441c8"
      ]
    },
    {
      "coin": "BTC",
      "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "px": "86471.0",
      "side": "A",
      "sz": "0.00045",
      "tid": 312065790568494,
      "time": 1790118553023,
      "url": null,
      "users": [
        "0x78dce96236804d6958bf3c4598cf5efbc371629c",
        "0xce75bb6f341975d377e7b68c7638a6f9d52f6885"
      ]
    },
    {
      "coin": "BTC",
      "hash": "0xf2630481226236c1f3dc0444fe0be50204b50066bd655594962bafd3e16610ac",
      "px": "86472.0",
      "side": "B",
      "sz": "0.00035",
      "tid": 512984801904099,
      "time": 1790118552822,
      "url": "https://app.hyperliquid.xyz/explorer/tx/0xf2630481226236c1f3dc0444fe0be50204b50066bd655594962bafd3e16610ac",
      "users": [
        "0xe4d40cb6bdf9de7f67370d91d75e0c386b217db3",
        "0x6a072733f7249e6b794cae88c6d3cc7eb756a93c"
      ]
    },
    {
      "coin": "BTC",
      "hash": "0xd92a4b8718a56da6daa40444fe0be2020308006cb3a88c787cf2f6d9d7a94791",
      "px": "86472.0",
      "side": "B",
      "sz": "0.00169",
      "tid": 894990029803250,
      "time": 1790118552622,
      "url": "https://app.hyperliquid.xyz/explorer/tx/0xd92a4b8718a56da6daa40444fe0be2020308006cb3a88c787cf2f6d9d7a94791",
      "users": [
        "0xd4c5368fff07c8c92350479bdcf0c35db47c59cf",
        "0x6a072733f7249e6b794cae88c6d3cc7eb756a93c"
      ]
    },
    {
      "coin": "BTC",
      "hash": "0x9558c199abc3678596d20444fe0bdf020225010446c6865739216cec6ac74170",
      "px": "86471.0",
      "side": "A",
      "sz": "0.00276",
      "tid": 770275249543048,
      "time": 1790118552424,
      "url": "https://app.hyperliquid.xyz/explorer/tx/0x9558c199abc3678596d20444fe0bdf020225010446c6865739216cec6ac74170",
      "users": [
        "0xe57ed94d5f3c3e07ec8e221adaa37620b9faedc0",
        "0x02ba173d2f6a0a4a6648c18c487b6c5113a710d9"
      ]
    },
    {
      "coin": "BTC",
      "hash": "0x4180471f6244906e42fa0444fe0bdb0205150004fd47af40e548f27221486a58",
      "px": "86471.0",
      "side": "A",
      "sz": "0.00022",
      "tid": 904241744151910,
      "time": 1790118552152,
      "url": "https://app.hyperliquid.xyz/explorer/tx/0x4180471f6244906e42fa0444fe0bdb0205150004fd47af40e548f27221486a58",
      "users": [
        "0xe57ed94d5f3c3e07ec8e221adaa37620b9faedc0",
        "0xe00c1c24b1d6d69d979084e0fe5ae7a5737ff467"
      ]
    },
    {
      "coin": "BTC",
      "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "px": "86471.0",
      "side": "A",
      "sz": "0.00021",
      "tid": 79003390170044,
      "time": 1790118552020,
      "url": null,
      "users": [
        "0xe57ed94d5f3c3e07ec8e221adaa37620b9faedc0",
        "0xe598431b1f0d315ba693dfe2cab6da8ba9262cea"
      ]
    },
    {
      "coin": "BTC",
      "hash": "0x5f89da976794205661030444fe0bd602080b007d02973f28035285ea2697fa41",
      "px": "86471.0",
      "side": "A",
      "sz": "0.0318",
      "tid": 125784274742834,
      "time": 1790118551820,
      "url": "https://app.hyperliquid.xyz/explorer/tx/0x5f89da976794205661030444fe0bd602080b007d02973f28035285ea2697fa41",
      "users": [
        "0xe57ed94d5f3c3e07ec8e221adaa37620b9faedc0",
        "0x583bc1459ad20ff59aef8ee40fac9c6246c7803f"
      ]
    }
  ]
}
```

### Vault

- Capability: `markets/vault`
- Description: Details of one vault: name, leader, description, APR, leader fraction and commission, deposit state, parent/child relationship, portfolio summary per window and optionally its followers.
- Instructions: Look up a vault such as HLP by its address. Set include_followers for the depositor list.
- Cost: 5 credits per call
- Capability file: [Vault](https://firecrawl.dev/alexandria/agents/providers/hyperliquid-xyz/markets/vault)

Accepted options:
- `include_followers` (boolean): Return the follower (depositor) list; off by default because it is large. Example: `false`
- `vault_address` (string, required): 0x-prefixed 40-hex address (user, sub-account or vault). Case-insensitive; normalized to lowercase in the output. Pattern: ^0x[0-9a-fA-F]{40}$. Example: `<vault_address>`

Response schema example:
```json
{
  "allow_deposits": true,
  "always_close_on_withdraw": false,
  "apr": 0.032664394177099834,
  "description": "This community-owned vault provides liquidity to Hyperliquid through multiple market making strategies, performs liquidations, and accrues platform fees.",
  "follower_count": 100,
  "followers": null,
  "is_closed": false,
  "leader": "0x677d831aef5328190852e24f13c46cac05f984e7",
  "leader_commission": 0,
  "leader_fraction": 0.001956344504408804,
  "max_distributable": 45198960.23405,
  "max_withdrawable": 0,
  "name": "Hyperliquidity Provider (HLP)",
  "observed_at_ms": 1790118574977,
  "portfolio": [
    {
      "account_value": "184636928.8125460148",
      "first_time": 1790030354424,
      "last_time": 1790118574378,
      "pnl": "14833.844728",
      "points": 58,
      "vlm": "0.0",
      "window": "day"
    },
    {
      "account_value": "184636928.8125460148",
      "first_time": 1789503562833,
      "last_time": 1790118574378,
      "pnl": "92201.648095",
      "points": 64,
      "vlm": "0.0",
      "window": "week"
    },
    {
      "account_value": "184636928.8125460148",
      "first_time": 1787441317713,
      "last_time": 1790118574378,
      "pnl": "576746.973503",
      "points": 45,
      "vlm": "0.0",
      "window": "month"
    },
    {
      "account_value": "184636928.8125460148",
      "first_time": 1683758700034,
      "last_time": 1790118574378,
      "pnl": "138205815.0325460136",
      "points": 99,
      "vlm": "0.0",
      "window": "allTime"
    },
    {
      "account_value": "45199438.1014470011",
      "first_time": 1790030354424,
      "last_time": 1790118574378,
      "pnl": "21959.126508",
      "points": 58,
      "vlm": "0.0",
      "window": "perpDay"
    },
    {
      "account_value": "45199438.1014470011",
      "first_time": 1789503562833,
      "last_time": 1790118574378,
      "pnl": "155293.621155",
      "points": 64,
      "vlm": "0.0",
      "window": "perpWeek"
    },
    {
      "account_value": "45199438.1014470011",
      "first_time": 1787441317713,
      "last_time": 1790118574378,
      "pnl": "605857.310847",
      "points": 45,
      "vlm": "0.0",
      "window": "perpMonth"
    },
    {
      "account_value": "45199438.1014470011",
      "first_time": 1714607953536,
      "last_time": 1790118574378,
      "pnl": "89863845.3614470065",
      "points": 76,
      "vlm": "0.0",
      "window": "perpAllTime"
    }
  ],
  "relationship": {
    "child_addresses": [
      "0x010461c14e146ac35fe42271bdc1134ee31c703a",
      "0x2e3d94f0562703b25c83308a05046ddaf9a8dd14",
      "0x2ed5c4484ea3ff8b57d5f2fb152a40d9f2b68308",
      "0x31ca8395cf837de08b24da3f660e77761dfb974b",
      "0x469f690213c467c39a23efacfd2816896009d7d8",
      "0x5e177e5e39c0f4e421f5865a6d8beed8d921cb70",
      "0xb0a55f13d22f66e6d495ac98113841b2326e9540"
    ],
    "parent_address": null,
    "type": "parent"
  },
  "url": "https://app.hyperliquid.xyz/vaults/0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
  "vault_address": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303"
}
```