HIP-4 Prediction Market Skills

Agent skills for trading HIP-4 prediction markets on Hyperliquid. Works with any AI coding agent.

Market Discovery & Prices

These skills fetch public data from the Hyperliquid API. No keys required.

• hip4-markets -- Discover active prediction markets with live prices, expiry times, and structure.

  npx skills@latest add purrdict/hip4-skills/hip4-markets
  

• hip4-prices -- Live mid prices for all prediction market coins and underlying perp assets.

  npx skills@latest add purrdict/hip4-skills/hip4-prices
  

• hip4-orderbook -- Bid/ask depth for any coin, with spread and mirrored complement side.

  npx skills@latest add purrdict/hip4-skills/hip4-orderbook
  

Portfolio & Trading

These skills interact with your account. Set environment variables first.

• hip4-portfolio -- Check USDH balance, outcome token positions, open orders, and settlement history.

  npx skills@latest add purrdict/hip4-skills/hip4-portfolio
  

• hip4-trade -- Place and cancel orders with local EIP-712 signing. Confirms before every trade.

  npx skills@latest add purrdict/hip4-skills/hip4-trade
  

Install All

npx skills@latest add purrdict/hip4-skills/hip4-markets
npx skills@latest add purrdict/hip4-skills/hip4-prices
npx skills@latest add purrdict/hip4-skills/hip4-orderbook
npx skills@latest add purrdict/hip4-skills/hip4-portfolio
npx skills@latest add purrdict/hip4-skills/hip4-trade

Configuration

# Read-only skills (markets, prices, orderbook, portfolio)
HIP4_NETWORK=testnet          # "testnet" (default) or "mainnet"
HIP4_ADDRESS=0xYourAddress    # Your wallet address

# Trading
HIP4_PRIVATE_KEY=0xYourKey    # Private key for local signing

Testnet by default. Set HIP4_NETWORK=mainnet explicitly to use real funds.

Safety

• Read-only by default -- 4 of 5 skills only read public API data
• Confirmation required -- the trade skill shows order details and asks before submitting
• Local signing -- private keys never leave your machine
• Fully auditable -- all logic visible in SKILL.md and REFERENCE.md files
• No hardcoded keys -- private keys come from environment variables only
• Testnet default -- must explicitly opt into mainnet

Dependencies

Read-only skills need nothing beyond fetch. The trade skill requires:

bun add @nktkas/hyperliquid viem   # or: npm install @nktkas/hyperliquid viem

HIP-4 Concepts

Prediction markets on Hyperliquid let you trade future outcomes. Each market has Yes/No sides priced 0-1 (price = implied probability). Buying Yes at 0.65 automatically creates a mirrored No at 0.35 -- the engine mints paired shares.

Coin formats: #23400 (prices/orderbook), +23400 (balances), 100023400 (order placement)

Market types: Recurring (auto-rotating price predictions), Binary (one-off Yes/No), Multi-outcome (only one wins)

Links

• Purrdict App -- prediction market trading interface
• Hyperliquid Testnet -- get testnet funds
• @hypurrdict -- follow for updates