Pa1m Hyperliquid

Official16 tools

by retampweb

Hyperliquid DEX data: prices, order books, candles, funding rates, portfolios. Pay-per-call, x402.

MCP Server: io.github.retampweb/pa1m-hyperliquid

This MCP server provides Hyperliquid DEX data access, including prices, order books, candles, funding rates, and portfolio information. It exposes functionality on a pay-per-call basis with an “x402” indicator. The server is identified by the slug io-github-retampweb-pa1m-hyperliquid and contains 16 tools.

🛠️ Key Features

Hyperliquid DEX data retrieval
Prices
Order books
Candles
Funding rates
Portfolios
16 tools exposed
Pay-per-call model (x402)

🚀 Use Cases

Fetch current Hyperliquid price and order book data
Access historical or aggregated candle data
Read funding rates for market assessment
Retrieve portfolio-related data

⚡ Developer Benefits

Structured tool set (16 tools) for DEX-related data
Direct access to core market datasets (prices, order books, candles, funding rates)
Portfolio data availability

⚠️ Limitations

Limited information provided beyond the listed data types
No additional implementation details are described

Captured live from the server via tools/list.

root__get

Root ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "root__getArguments"
}

health_health_get

Health ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "health_health_getArguments"
}

top_top_get

Top Free: mid prices for top 5 perps (BTC/ETH/SOL/BNB/XRP). 20 req/min per IP. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "top_top_getArguments"
}

favicon_favicon_ico_get

Favicon Serve Pa1m logo as favicon for x402scan and browser tabs. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "favicon_favicon_ico_getArguments"
}

llms_txt_llms_txt_get

Llms Txt ### Responses: **200**: Successful Response (Success Response) Content-Type: text/plain **Example Response:** ```json "string" ```

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "llms_txt_llms_txt_getArguments"
}

openapi_json_openapi_json_get

Openapi Json ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "openapi_json_openapi_json_getArguments"
}

prices_prices_get

Prices ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "prices_prices_getArguments"
}

meta_meta_get

Meta ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "meta_meta_getArguments"
}

orderbook_orderbookcoinget

Orderbook ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters1

coin

string

required

Coin ticker e.g. BTC

Raw schema

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Coin ticker e.g. BTC",
      "title": "coin"
    }
  },
  "required": [
    "coin"
  ],
  "title": "orderbook_orderbook__coin__getArguments"
}

candles_candlescoinget

Candles ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters3

coin	string	required	Coin ticker e.g. ETH
interval	string	optional	Candle interval: 1m,5m,15m,1h,4h,1d
lookback	integer	optional	Number of candles to return (max 5000)

Raw schema

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Coin ticker e.g. ETH",
      "title": "coin"
    },
    "interval": {
      "type": "string",
      "description": "Candle interval: 1m,5m,15m,1h,4h,1d",
      "default": "1h",
      "title": "interval"
    },
    "lookback": {
      "type": "integer",
      "description": "Number of candles to return (max 5000)",
      "default": 100,
      "title": "lookback"
    }
  },
  "required": [
    "coin"
  ],
  "title": "candles_candles__coin__getArguments"
}

funding_funding_get

Funding ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "funding_funding_getArguments"
}

predicted_funding_predicted_funding_get

Predicted Funding ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "predicted_funding_predicted_funding_getArguments"
}

portfolio_portfolioaddressget

Portfolio ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters1

address

string

required

Wallet address 0x...

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Wallet address 0x...",
      "title": "address"
    }
  },
  "required": [
    "address"
  ],
  "title": "portfolio_portfolio__address__getArguments"
}

history_historyaddressget

History ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters1

address

string

required

Wallet address 0x...

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Wallet address 0x...",
      "title": "address"
    }
  },
  "required": [
    "address"
  ],
  "title": "history_history__address__getArguments"
}

open_orders_open_ordersaddressget

Open Orders ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters1

address

string

required

Wallet address 0x...

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Wallet address 0x...",
      "title": "address"
    }
  },
  "required": [
    "address"
  ],
  "title": "open_orders_open_orders__address__getArguments"
}

leaderboard_leaderboard_get

Leaderboard ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

Parameters1

window

string

optional

Time window: day, week, month, allTime

Raw schema

{
  "type": "object",
  "properties": {
    "window": {
      "type": "string",
      "description": "Time window: day, week, month, allTime",
      "default": "day",
      "title": "window"
    }
  },
  "title": "leaderboard_leaderboard_getArguments"
}

Install

Tools (16)

root__gethealth_health_gettop_top_getfavicon_favicon_ico_getllms_txt_llms_txt_getopenapi_json_openapi_json_getprices_prices_getmeta_meta_get

Remote endpoint

SSE

Hosted server - connect over the network, no local install.

url

https://hyperliquid.hypa1m.xyz/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "pa1m-hyperliquid": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://hyperliquid.hypa1m.xyz/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: io.github.retampweb/pa1m-hyperliquid

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

root__get

health_health_get

top_top_get

favicon_favicon_ico_get

llms_txt_llms_txt_get

openapi_json_openapi_json_get

prices_prices_get

meta_meta_get

orderbook_orderbook__coin__get

candles_candles__coin__get

funding_funding_get

predicted_funding_predicted_funding_get

portfolio_portfolio__address__get

history_history__address__get

open_orders_open_orders__address__get

leaderboard_leaderboard_get

Install

Remote endpoint

Related servers

orderbook_orderbookcoinget

candles_candlescoinget

portfolio_portfolioaddressget

history_historyaddressget

open_orders_open_ordersaddressget