hyperliquid skill for Starchild agents: trade perps and spot on Hyperliquid

• Account, PnL, orders, market data and staking, for any address

  SKILL.md says 32 read functions; its table lists 33, such as hl_account, hl_portfolio, hl_fills_by_time, hl_candles and hl_funding. Each user-scoped function takes an optional 0x address.

  Try: “What is the all-time PnL of wallet 0x1f16...?”

  Network · Read functions (exports.py)

• hl_portfolio plus ledger, fills and funding for cost basis

  hl_portfolio returns day, week, month and allTime windows. For cost basis, SKILL.md combines hl_ledger, hl_fills_by_time (2000 fills per call) and hl_funding_payments.

  Network · PnL analysis

• place_order, cancel_all, update_leverage and more, signed with EIP-712

  Writes go through the async HyperliquidClient, which signs EIP-712 actions. Order types are limit, market (IoC at mid plus or minus 3%), post-only and fill-or-kill, with reduce-only for closing.

  Try: “Buy $20 of Bitcoin with 5x leverage.”

  Write · Orders (client.py)

• hl_tpsl_order trigger orders

  Trigger orders that run as market orders by default, or as limits when is_market is false.

  Write · Stop loss and take profit

• xyz: tickers such as xyz:NVDA and xyz:GOLD

  Builder-deployed perps use isolated margin. Prices come from hl_candles because these markets are not in allMids.

  Try: “Long NVIDIA with $50, 10x.”

  Write · Stock and commodity perps

• deposit_usdc, transfer_usd, withdraw_from_bridge

  Deposits send USDC from the agent's Arbitrum wallet to the Hyperliquid bridge, with a 5 USDC minimum. Withdrawals cost 1 USDC and take about 5 minutes, and can go to a destination address you give.

  Write · Funds

• hl_approve_builder and hl_builder_status

  A 2 bps builder fee goes to a Starchild address. The first order auto-approves it with a signature from the main wallet.

  Write · Builder fee

• Tells the agent to check funds, set leverage and verify fills itself

  SKILL.md lists six things the agent should do automatically without asking, including checking funds before every trade, setting leverage and calling hl_fills after every order.

  Read · Agent behaviour rules

Watch out for

• It trades real money with leverage

  SKILL.md describes leverage up to each asset's maximum, and its common-mistakes table lists liquidation risk when a leveraged position has no stop loss. Our advice: start with small sizes on a wallet holding only what you can lose. github.com

• It tells the agent not to ask before routine steps

  SKILL.md says the agent should always check funds, detect asset type, set leverage, verify fills, report and suggest risk management automatically, never asking the user. It names no step where you approve an order. Wallet confirmation cards appear only when a wallet policy is enabled (per the wallet skill's SKILL.md). Our advice: do not run this skill unattended. github.com

• It can withdraw funds to another address

  withdraw_from_bridge takes an optional destination address and defaults to the agent's own wallet. The prerequisite policy in SKILL.md allows all methods except key export. github.com

• A 2 bps fee goes to a Starchild address

  Every order carries a builder fee of 20 tenths of a basis point to 0x2c5320F40305fFC933385c6DCec5493fbA7b98b8. The first order auto-approves it with a signature from your main wallet. SKILL.md says you can revoke it on app.hyperliquid.xyz, and orders still go through if approval fails. github.com

• It points to a skill the repo does not contain

  SKILL.md tells the agent to load a wallet-policy skill before trading. The repo has no folder with that name; the wallet skill holds the policy functions. Check that a policy is active before the first order. github.com

• Any wallet's data can be read

  Read functions accept any 0x address, so the agent can look up other people's public Hyperliquid positions and PnL. github.com