--- name: hyperliquid-accounts.use.x402atlas.com description: This host provides read-only account-level data for Hyperliquid wallets, covering fee schedules, historical portfolio performance, and current open orders. All three skills accept a single wallet address and return a point-in-time snapshot of that account's state. No trading, streaming, or multi-account bulk queries are supported. host: hyperliquid-accounts.use.x402atlas.com --- # hyperliquid-accounts.use.x402atlas.com hyperliquid-accounts.use.x402atlas.com is a Hyperliquid-specific data host serving agents that need to inspect the state of individual Hyperliquid accounts. It covers three distinct account dimensions: fee tier placement, historical PnL and volume, and resting open orders. It is narrowly scoped to per-address, per-call lookups on the Hyperliquid L1 and does not interact with any other chain or protocol. ## When to use this host Use this host when an agent needs to read account-level state for a specific Hyperliquid wallet address: fee tiers, historical portfolio performance, or current open orders. It is the right choice for pre-trade cost analysis, account monitoring dashboards, and strategy evaluation against a known address. Do not use it for real-time price feeds, order book depth, or trade execution — use Hyperliquid's native trading API for those. Do not use it for historical filled or canceled order history, as only resting open orders are available. It does not support bulk or multi-address queries; each skill call covers exactly one address. It has no applicability to non-Hyperliquid chains or wallets. ## Capabilities ### Account Fee Intelligence Retrieves the full fee structure for a Hyperliquid address, including perp and spot maker/taker rates, volume-based tier placement, and active referral or staking discounts. Foundational for any cost-aware trade analysis. - **`fetch-hyperliquid-account-fees`** — Returns the current maker/taker fee rates, active referral and staking discounts, trailing 14-day daily volume, and the full fee tier schedule for a given Hyperliquid account address. ### Portfolio Performance History Returns historical account value snapshots, cumulative PnL time series, and trading volume across day, week, month, and all-time windows for a given wallet. Used for performance charting and retrospective analysis. - **`fetch-hyperliquid-portfolio`** — Returns a Hyperliquid account's historical account value, PnL time series, and volume across day, week, month, and all-time windows for any 0x wallet address. ### Open Order State Returns all currently resting open orders for a wallet, including coin, side, price, size, order type, and time-in-force. Used for live account state inspection and pre-action checks. - **`fetch-hyperliquid-open-orders`** — Returns all resting open orders for a given Hyperliquid wallet address, including coin, side, limit price, size, order type, time-in-force, and timestamps. ## Workflows ### Pre-Trade Account Audit *Use when an agent needs to fully characterize a Hyperliquid account before placing or canceling orders — combining effective fee rates, current open exposure, and historical volume context.* 1. **`fetch-hyperliquid-account-fees`** — Retrieve the account's current maker/taker rates and fee tier to understand the cost basis for any new trades. 2. **`fetch-hyperliquid-open-orders`** — Inspect all resting open orders to understand existing exposure and avoid conflicting or redundant order placement. 3. **`fetch-hyperliquid-portfolio`** — Review historical PnL and volume to contextualize the account's trading activity and risk profile before acting. ## Skill reference ### `fetch-hyperliquid-account-fees` **Hyperliquid Account Fee Schedule** — Returns the current maker/taker fee rates, active referral and staking discounts, trailing 14-day daily volume, and the full fee tier schedule for a given Hyperliquid account address. *Use when:* Use when an agent needs to determine the effective trading fees for a specific Hyperliquid account, including perp and spot maker/taker rates, volume-based tier placement, and any active discounts before placing or analyzing trades. *Not for:* Do not use for real-time price feeds, order book data, or trade execution; use Hyperliquid's trading API instead. Not suitable for querying fees across multiple accounts in bulk — each call covers one address. **Inputs:** - `address` (string, required) — 0x-prefixed 20-byte Hyperliquid account address to query. Must match pattern ^0x[0-9a-fA-F]{40}$. **Returns:** Returns address, queried_at timestamp, and a fees object containing userCrossRate, userAddRate, userSpotCrossRate, userSpotAddRate, activeReferralDiscount, activeStakingDiscount, 15-entry dailyUserVlm array, and the full feeSchedule with VIP and MM tiers. **Example:** `GET https://hyperliquid-accounts.use.x402atlas.com/fees?address=0x010461c14e146ac35fe42271bdc1134ee31c703a` --- ### `fetch-hyperliquid-portfolio` **Hyperliquid Portfolio Data** — Returns a Hyperliquid account's historical account value, PnL time series, and volume across day, week, month, and all-time windows for any 0x wallet address. *Use when:* Use when an agent needs to chart or analyze a Hyperliquid wallet's performance over time, including account value snapshots, cumulative PnL history, and trading volume across multiple time windows. *Not for:* Do not use for real-time streaming price feeds or live position data; this is a historical snapshot endpoint. Not suitable for non-Hyperliquid chains or wallets. **Inputs:** - `address` (string, required) — 0x-prefixed 20-byte Hyperliquid account address to query. Must match pattern ^0x[0-9a-fA-F]{40}$. **Returns:** Returns address, queried_at timestamp, and a portfolio array of [period, series] pairs (day/week/month/allTime), each with accountValueHistory, pnlHistory time series arrays, and a vlm volume string. **Example:** `GET https://hyperliquid-accounts.use.x402atlas.com/portfolio?address=0x010461c14e146ac35fe42271bdc1134ee31c703a` --- ### `fetch-hyperliquid-open-orders` **Hyperliquid Open Orders** — Returns all resting open orders for a given Hyperliquid wallet address, including coin, side, limit price, size, order type, time-in-force, and timestamps. *Use when:* Use when an agent needs to inspect the current open order book state for a specific Hyperliquid account, such as for portfolio monitoring, trading strategy evaluation, or account state checks before placing or canceling orders. *Not for:* Do not use for historical order or trade history; this returns only currently resting open orders. Not suitable for retrieving filled, canceled, or expired orders. **Inputs:** - `address` (string, required) — 0x-prefixed 20-byte Hyperliquid account address to query open orders for. No authentication required — address is public. **Returns:** Returns address, count (e.g. 100), queried_at timestamp, and an orders array of resting Hyperliquid limit orders each with coin, side, limitPx, sz, oid, orderType, tif, and trigger metadata. **Example:** `GET https://hyperliquid-accounts.use.x402atlas.com/open-orders?address=0x010461c14e146ac35fe42271bdc1134ee31c703a` ---