# Pa1m Hyperliquid — AI Agent Guide

Pa1m Hyperliquid exposes Hyperliquid perpetuals data as a pay-per-call API.
Pay in USDC on Base (eip155:8453) via x402 or MPP/Tempo. No API key, no account.

## Pricing
- Market data (prices, meta, orderbook, candles): $0.001/call
- Strategic data (funding, predicted-funding, portfolio, history): $0.003/call
- Trading data (open-orders, leaderboard): $0.003/call

## Endpoints

### GET /top (FREE)
Returns live mid prices for BTC, ETH, SOL, BNB, XRP. No payment needed.
Cached 5 seconds server-side — safe to poll frequently.
Rate limit: 20 req/min per IP.
Example: curl https://hyperliquid.hypa1m.xyz/top

### GET /prices
Returns mid prices for all ~170 Hyperliquid perpetuals.
Use when: you need current price of any perp asset.
Example: curl https://hyperliquid.hypa1m.xyz/prices

### GET /meta
Returns asset metadata: symbols, max leverage, margin tables.
Use when: you need to know available assets or leverage limits.
Example: curl https://hyperliquid.hypa1m.xyz/meta

### GET /orderbook/{coin}
Returns L2 order book snapshot (up to 20 levels per side).
Use when: you need bid/ask depth for a specific asset.
Example: curl https://hyperliquid.hypa1m.xyz/orderbook/BTC

### GET /candles/{coin}?interval=1h&lookback=100
Returns OHLCV candle data for a coin.
Params: interval (1m,5m,15m,1h,4h,1d), lookback (number of candles, max 5000)
Example: curl "https://hyperliquid.hypa1m.xyz/candles/ETH?interval=1h&lookback=24"

### GET /funding
Returns funding rates + open interest for all perps.
Use when: evaluating carry cost before opening a position.
Example: curl https://hyperliquid.hypa1m.xyz/funding

### GET /predicted-funding
Returns predicted next funding rates across venues.
Use when: finding funding arbitrage opportunities. Unique — not available elsewhere in x402 ecosystem.
Example: curl https://hyperliquid.hypa1m.xyz/predicted-funding

### GET /portfolio/{address}
Returns open positions and margin summary for a wallet.
Use when: checking a wallet's current Hyperliquid exposure.
Example: curl https://hyperliquid.hypa1m.xyz/portfolio/0xYourAddress

### GET /history/{address}
Returns trade fill history for a wallet (up to 2000 most recent).
Use when: analyzing a wallet's recent trading activity.
Example: curl https://hyperliquid.hypa1m.xyz/history/0xYourAddress

### GET /open-orders/{address}
Returns all open (pending/resting) orders for a wallet.
Use when: checking what orders are currently active before placing new ones.
Example: curl https://hyperliquid.hypa1m.xyz/open-orders/0xYourAddress

### GET /leaderboard?window=day
Returns top traders by PnL. window: day, week, month, allTime.
Use when: finding top-performing wallets to copy or analyze strategies.
Example: curl "https://hyperliquid.hypa1m.xyz/leaderboard?window=week"

## Discovery & verification
- OpenAPI schema: https://hyperliquid.hypa1m.xyz/openapi.json
- MCP endpoint: https://hyperliquid.hypa1m.xyz/mcp
- System prompt: https://hyperliquid.hypa1m.xyz/prompt.txt
- ERC-8004 identity: https://8004scan.io/agents/base/59960
- agentscan.info: https://agentscan.info/agents/fb8b6679-8ccb-4bbc-9496-533e8e2c5ca6
- 8004agents.ai: https://8004agents.ai/base/agent/59960

## Related Pa1m agents
- SEO audit: https://seo.hypa1m.xyz/llms.txt
- Reddit data: https://reddit.hypa1m.xyz/llms.txt