# hypernode ## Docs - [Account Actions](https://hypernode-docs.polynode.dev/actions/account.md): Referrals, agents, transfers, and governance event formats - [Action Types Overview](https://hypernode-docs.polynode.dev/actions/overview.md): All 53 recognized action types on HyperLiquid - [Prediction Markets (HIP-4)](https://hypernode-docs.polynode.dev/actions/prediction-markets.md): HIP-4 prediction market actions, settlement, and metadata enrichment - [Trading Actions](https://hypernode-docs.polynode.dev/actions/trading.md): Order, cancel, modify, fill, and rejection event formats - [Authentication](https://hypernode-docs.polynode.dev/api/authentication.md): API keys, tiers, and error handling - [Connection](https://hypernode-docs.polynode.dev/api/connection.md): WebSocket endpoint and network options - [HTTP Endpoints](https://hypernode-docs.polynode.dev/api/endpoints.md): Health, status, and metrics endpoints - [Event Format](https://hypernode-docs.polynode.dev/api/events.md): Structure of every event delivered by hypernode - [Filters](https://hypernode-docs.polynode.dev/api/filters.md): Filter the event stream by type, asset, address, or consensus layer - [Session Replay](https://hypernode-docs.polynode.dev/api/session-replay.md): Reconnect to the WebSocket stream and replay missed events with zero gaps - [Subscriptions](https://hypernode-docs.polynode.dev/api/subscriptions.md): Subscribe, unsubscribe, and manage your stream - [Python](https://hypernode-docs.polynode.dev/examples/python.md): Connect to the hypernode stream with Python - [TypeScript](https://hypernode-docs.polynode.dev/examples/typescript.md): Connect to the hypernode stream with TypeScript - [Asset Discovery](https://hypernode-docs.polynode.dev/guides/asset-discovery.md): How to find every asset tradeable on HyperLiquid — perps, spot, builder DEXes, and predictions - [Authentication](https://hypernode-docs.polynode.dev/guides/authentication.md): API keys, tiers, rate limits, and how to authenticate with hypernode - [Choosing Your Subscription](https://hypernode-docs.polynode.dev/guides/choosing-subscriptions.md): Pick the right filters for your use case - [Common Patterns](https://hypernode-docs.polynode.dev/guides/common-patterns.md): Ready-to-use code for whale alerts, fill tracking, market signals, and more - [Pre-consensus vs Confirmed](https://hypernode-docs.polynode.dev/guides/consensus-layers.md): Understanding the two data layers in the hypernode stream and when to use each - [Prediction Market Trading](https://hypernode-docs.polynode.dev/guides/prediction-trading.md): Full guide to trading HIP-4 prediction markets through hypernode - [Reconnection & Error Handling](https://hypernode-docs.polynode.dev/guides/reconnection.md): Handle disconnections, rate limits, and errors in production - [GET /v1/coins/:coin](https://hypernode-docs.polynode.dev/hip4/api/coins.md): Resolve a coin name (#N) or asset_id to its outcome + side metadata. - [GET /v1/fee-schedule](https://hypernode-docs.polynode.dev/hip4/api/fee-schedule.md): Live fee rates + the meaning of every fee_token value. - [GET /v1/health](https://hypernode-docs.polynode.dev/hip4/api/health.md): System status — indexer lag, active market count. - [GET /v1/meta](https://hypernode-docs.polynode.dev/hip4/api/meta.md): Protocol-level metadata — encoding rules, conventions, indexer scope. - [GET /v1/questions](https://hypernode-docs.polynode.dev/hip4/api/questions.md): List multi-outcome question groupings (pending upstream). - [GET /v1/spot-tokens](https://hypernode-docs.polynode.dev/hip4/api/spot-tokens.md): Hyperliquid spot token reference. - [GET /v1/stats](https://hypernode-docs.polynode.dev/hip4/api/stats.md): Lifetime aggregate counters across all HIP-4 markets. - [Errors](https://hypernode-docs.polynode.dev/hip4/authentication/errors.md): Standard error response shape + common error codes. - [Authentication](https://hypernode-docs.polynode.dev/hip4/authentication/quickstart.md): Get an API key + send your first authenticated request. - [Rate Limits](https://hypernode-docs.polynode.dev/hip4/authentication/rate-limits.md): Tiers, per-key limits, the global ceiling, and how the token bucket works. - [HIP-4 Predictions API](https://hypernode-docs.polynode.dev/hip4/introduction.md): Live indexed data for every HIP-4 prediction market on Hyperliquid. - [GET /v1/leaderboards/builders](https://hypernode-docs.polynode.dev/hip4/leaderboards/builders.md): Top builders (frontends/UIs that route HL orders) — by revenue, volume, fills, or unique users. - [GET /v1/leaderboards/deployers](https://hypernode-docs.polynode.dev/hip4/leaderboards/deployers.md): Per-outcome deployer revenue — revenue earned by whoever deployed each market. - [GET /v1/leaderboards/markets](https://hypernode-docs.polynode.dev/hip4/leaderboards/markets.md): Most active HIP-4 markets — by volume, traders, fills, or fees, in 24h or lifetime windows. - [GET /v1/leaderboards/wallets](https://hypernode-docs.polynode.dev/hip4/leaderboards/wallets.md): Top wallets across all HIP-4 markets — by volume, PnL, fills, or markets traded. - [GET /v1/leaderboards/whales](https://hypernode-docs.polynode.dev/hip4/leaderboards/whales.md): Biggest open positions cross-market — single positions or per-wallet aggregates. - [GET /v1/markets/:id/book](https://hypernode-docs.polynode.dev/hip4/markets/book.md): Live L2 orderbook aggregated by price level. - [GET /v1/markets/:id/book/at/:ts](https://hypernode-docs.polynode.dev/hip4/markets/book-at-ts.md): Reconstruct the orderbook at any past microsecond — exact L2 snapshot of resting orders. - [GET /v1/markets/:id/candles](https://hypernode-docs.polynode.dev/hip4/markets/candles.md): OHLCV bars with implied probability + VWAP per period. - [GET /v1/markets/:id/depth-history](https://hypernode-docs.polynode.dev/hip4/markets/depth-history.md): Top-of-book + depth time series — orderbook snapshots at evenly-spaced timestamps. - [GET /v1/markets/:id](https://hypernode-docs.polynode.dev/hip4/markets/detail.md): Full enriched detail on a single market. - [GET /v1/markets/:id/holders](https://hypernode-docs.polynode.dev/hip4/markets/holders.md): Top traders on a single market — by position size, realized PnL, or volume. - [GET /v1/markets](https://hypernode-docs.polynode.dev/hip4/markets/list.md): List of HIP-4 outcomes with current implied probability + lifetime stats. - [GET /v1/markets/:id/trades](https://hypernode-docs.polynode.dev/hip4/markets/trades.md): Recent fills on a market with full enrichment. - [GET /v1/questions/:qid/aggregate](https://hypernode-docs.polynode.dev/hip4/questions/aggregate.md): Cross-outcome math for a multi-outcome question — implied probabilities, favorite, total volume. - [GET /v1/wallets/:addr/activity](https://hypernode-docs.polynode.dev/hip4/wallets/activity.md): Unified time-ordered feed of every event for a wallet — trades, order events, ledger updates, settlements. - [GET /v1/wallets/:addr/orders](https://hypernode-docs.polynode.dev/hip4/wallets/orders.md): Live resting limit orders — every order this wallet currently has in any HIP-4 book. - [GET /v1/wallets/:addr/pnl](https://hypernode-docs.polynode.dev/hip4/wallets/pnl.md): PnL breakdown grouped by market — totals across realized, unrealized, settlement, and fees. - [GET /v1/wallets/:addr/positions](https://hypernode-docs.polynode.dev/hip4/wallets/positions.md): Per-market positions for a wallet — amount, cost basis, mark-to-mid PnL, settlement payout if resolved. - [GET /v1/wallets/:addr/settlements](https://hypernode-docs.polynode.dev/hip4/wallets/settlements.md): Clean payout log — every market this wallet held at resolution, with payout and realized PnL. - [GET /v1/wallets/:addr](https://hypernode-docs.polynode.dev/hip4/wallets/summary.md): Lifetime + current snapshot for a single wallet across all HIP-4 markets. - [GET /v1/wallets/:addr/trades](https://hypernode-docs.polynode.dev/hip4/wallets/trades.md): Every fill on every HIP-4 market for a single wallet, paginated by time. - [hypernode](https://hypernode-docs.polynode.dev/index.md): Real-time HyperLiquid data stream and exchange API, by polynode - [Stream Quickstart](https://hypernode-docs.polynode.dev/quickstart.md): Connect to the hypernode WebSocket stream in 30 seconds - [Account System](https://hypernode-docs.polynode.dev/research/accounts.md): Three-tier account architecture on HyperLiquid: standard accounts, DEX abstraction, and unified portfolio margin. - [Action Types](https://hypernode-docs.polynode.dev/research/action-types.md): Complete reference for all 49+ HyperLiquid L1 user action types, governance actions, and system actions. - [Bridge](https://hypernode-docs.polynode.dev/research/bridge.md): L1 to Arbitrum bridge mechanics. Deposit flow, withdrawal flow, validator set updates, and bridge state management. - [Cancel-Fill Correlation](https://hypernode-docs.polynode.dev/research/cancel-fill-correlation.md): Measuring pre-consensus cancel velocity against confirmed fills to detect market maker stress and order pick-offs - [Consensus](https://hypernode-docs.polynode.dev/research/consensus.md): HyperBFT consensus model based on HotStuff, block production, two-chain commit rule, validator roles, and jailing system. - [Historical Data](https://hypernode-docs.polynode.dev/research/data.md): S3 archive buckets, data formats, indexer tables, and historical data access. - [Token Deployment](https://hypernode-docs.polynode.dev/research/deployment.md): HIP-3 permissionless token deployment pipeline. SpotDeploy sub-actions, genesis distribution, hyperliquidity seeding, gas auctions, sub-deployers, growth modes, and TWAP engine. - [HyperEVM](https://hypernode-docs.polynode.dev/research/evm.md): HyperEVM integration, precompiles, CoreWriter bridge, and the L1-EVM execution environment. - [Fee Structure](https://hypernode-docs.polynode.dev/research/fees.md): Complete HyperLiquid fee reference. Base rates, 6 VIP tiers, market maker rebates, staking discounts, referral program, builder fees, deployer revenue, and fee trials. - [Funding Rates](https://hypernode-docs.polynode.dev/research/funding.md): Oracle system, mark price calculation, funding rate mechanics, impact USD, per-perp multipliers, and funding distribution. - [Gas Auctions](https://hypernode-docs.polynode.dev/research/gas-auctions.md): Dutch auction system for asset deployment gas pricing and the live priority fee infrastructure on HyperLiquid. - [Governance](https://hypernode-docs.polynode.dev/research/governance.md): Staking, delegation, validator jailing, governance proposals, epoch management, reward distribution, and stake discount tiers. - [HIP-4 Prediction Markets](https://hypernode-docs.polynode.dev/research/hip4.md): Native L1 prediction markets on HyperLiquid. Binary outcome instruments with pair minting, CLOB trading, oracle settlement, and fee-on-close economics. - [HIP-1 & HIP-2](https://hypernode-docs.polynode.dev/research/hips.md): Native token standard (HIP-1) and hyperliquidity AMM (HIP-2) specifications. - [Lending (BOLE)](https://hypernode-docs.polynode.dev/research/lending.md): HyperLiquid's native borrow/lend system with kink-rate interest model, three liquidation modes, and deep integration with portfolio margin. - [Liquidation](https://hypernode-docs.polynode.dev/research/liquidation.md): Perpetual liquidation mechanics, partial liquidation, backstop system, insurance fund, and liquidator incentives. - [Order Book](https://hypernode-docs.polynode.dev/research/orderbook.md): Order types, time-in-force modes, trigger orders, order relationships, and the complete cancel/rejection taxonomy on HyperLiquid. - [Protocol Research](https://hypernode-docs.polynode.dev/research/overview.md): Deep technical research into HyperLiquid's L1 protocol, consensus mechanics, and DeFi infrastructure. - [Exchange State](https://hypernode-docs.polynode.dev/research/state.md): Top-level state architecture, context fields, safety guards, and ledger delta types. - [Vaults](https://hypernode-docs.polynode.dev/research/vaults.md): Vault creation, deposits, withdrawals, leader commission, HLP protocol vaults, and vault governance. - [Additional Read Endpoints](https://hypernode-docs.polynode.dev/rest/additional.md): Vaults, staking, oracle history, TWAP summaries, spot deployment, and validator read endpoints - [Borrow & Lend](https://hypernode-docs.polynode.dev/rest/defi/borrow-lend.md): Real-time borrow and supply rates for all lending reserves - [Priority Auction](https://hypernode-docs.polynode.dev/rest/defi/priority-auction.md): Real-time gossip priority auction status — bid slots, gas pricing, and cycle timing - [All Perp Metas](https://hypernode-docs.polynode.dev/rest/discovery/all-perp-metas.md): Complete metadata for native and all builder-deployed perpetual DEXes - [All Assets](https://hypernode-docs.polynode.dev/rest/discovery/assets.md) - [Deployment Auctions](https://hypernode-docs.polynode.dev/rest/discovery/deployment-auctions.md): Live Dutch auctions for deploying new perp markets and spot pairs - [Asset Annotations](https://hypernode-docs.polynode.dev/rest/discovery/perp-annotations.md): Asset categorization — crypto, stocks, commodities - [Perp Deploy Auction](https://hypernode-docs.polynode.dev/rest/discovery/perp-auction.md) - [Perp Categories](https://hypernode-docs.polynode.dev/rest/discovery/perp-categories.md): Every perpetual categorized by asset class - [DEX Limits](https://hypernode-docs.polynode.dev/rest/discovery/perp-dex-limits.md): OI caps and transfer limits for builder-deployed DEXes - [DEX Status](https://hypernode-docs.polynode.dev/rest/discovery/perp-dex-status.md): Total net deposits for native and builder-deployed DEXes - [Spot Pair Auction](https://hypernode-docs.polynode.dev/rest/discovery/spot-auction.md) - [Spot Assets](https://hypernode-docs.polynode.dev/rest/discovery/spot-pairs.md) - [EVM RPC](https://hypernode-docs.polynode.dev/rest/evm-rpc.md): Dedicated Ethereum JSON-RPC for HyperEVM (chain 999) with no shared rate limits - [Validators](https://hypernode-docs.polynode.dev/rest/governance/validators.md) - [Vault Details](https://hypernode-docs.polynode.dev/rest/governance/vault.md) - [All Vaults](https://hypernode-docs.polynode.dev/rest/governance/vaults.md) - [L4 Book](https://hypernode-docs.polynode.dev/rest/l4/book.md): Full depth order book for a single asset - [L4 Order Book](https://hypernode-docs.polynode.dev/rest/l4/overview.md): Full depth order book with individual orders and wallet addresses - [L4 Summary](https://hypernode-docs.polynode.dev/rest/l4/summary.md): All markets with order counts and best bid/ask - [OHLCV Candles](https://hypernode-docs.polynode.dev/rest/market-data/candles.md) - [Exchange Status](https://hypernode-docs.polynode.dev/rest/market-data/exchange-status.md): HyperLiquid exchange operational status - [Funding Rates](https://hypernode-docs.polynode.dev/rest/market-data/funding.md) - [Historical Funding](https://hypernode-docs.polynode.dev/rest/market-data/funding-history.md) - [Margin Table](https://hypernode-docs.polynode.dev/rest/market-data/margin-table.md): Tiered leverage and margin requirements by asset class - [Max Market Orders](https://hypernode-docs.polynode.dev/rest/market-data/max-market-orders.md): Maximum market order size by leverage tier - [Market Metadata](https://hypernode-docs.polynode.dev/rest/market-data/meta.md): All perpetual and spot market metadata - [Open Interest Cap](https://hypernode-docs.polynode.dev/rest/market-data/oi-cap.md): Assets currently at their open interest cap - [L2 Orderbook](https://hypernode-docs.polynode.dev/rest/market-data/orderbook.md) - [Perp Snapshot](https://hypernode-docs.polynode.dev/rest/market-data/perp-snapshot.md): Full positioning of every active trader on HyperLiquid in one call - [Predicted Fundings](https://hypernode-docs.polynode.dev/rest/market-data/predicted-fundings.md) - [All Prices](https://hypernode-docs.polynode.dev/rest/market-data/prices.md) - [Recent Trades](https://hypernode-docs.polynode.dev/rest/market-data/trades.md) - [REST API](https://hypernode-docs.polynode.dev/rest/overview.md): 54 endpoints for market data, user state, L4 order books, DeFi, and trading - [Generic Passthrough](https://hypernode-docs.polynode.dev/rest/passthrough/info.md) - [Exchange Passthrough](https://hypernode-docs.polynode.dev/rest/passthrough/raw.md) - [Prediction Markets](https://hypernode-docs.polynode.dev/rest/predictions/overview.md): HIP-4 prediction market data and trading on HyperLiquid - [Single Market](https://hypernode-docs.polynode.dev/rest/predictions/prediction-market.md) - [All Prediction Markets](https://hypernode-docs.polynode.dev/rest/predictions/prediction-markets.md) - [Account](https://hypernode-docs.polynode.dev/rest/trading/account.md): Query your positions, orders, fills, balances, and fees - [Authentication](https://hypernode-docs.polynode.dev/rest/trading/authentication.md): Register your wallet, manage API keys, and verify your identity - [Orders](https://hypernode-docs.polynode.dev/rest/trading/orders.md): Place, cancel, and modify orders on HyperLiquid - [Batch User Queries](https://hypernode-docs.polynode.dev/rest/user-data/batch-queries.md): Query position state, spot balances, or open orders for up to 10,000 wallets in a single request - [Open Orders](https://hypernode-docs.polynode.dev/rest/user-data/open-orders.md) - [Portfolio History](https://hypernode-docs.polynode.dev/rest/user-data/portfolio.md) - [Portfolio State](https://hypernode-docs.polynode.dev/rest/user-data/portfolio-state.md): Bundle perp positions, spot balances, open orders, and account abstraction into one call - [Spot Account State](https://hypernode-docs.polynode.dev/rest/user-data/spot-state.md) - [Sub-Accounts](https://hypernode-docs.polynode.dev/rest/user-data/sub-accounts.md) - [Account State](https://hypernode-docs.polynode.dev/rest/user-data/user.md) - [Account Mode](https://hypernode-docs.polynode.dev/rest/user-data/user-abstraction.md): Account abstraction mode — standard, unified, or portfolio margin - [API Agents](https://hypernode-docs.polynode.dev/rest/user-data/user-agents.md): Sub-wallets with delegated signing permissions - [Builder Fee Approval](https://hypernode-docs.polynode.dev/rest/user-data/user-builder-fee.md): Check the maximum builder fee a user has approved for a specific builder - [Staking Delegations](https://hypernode-docs.polynode.dev/rest/user-data/user-delegations.md): User's HYPE staking delegations to validators - [Fee Structure](https://hypernode-docs.polynode.dev/rest/user-data/user-fees.md) - [Fill History](https://hypernode-docs.polynode.dev/rest/user-data/user-fills.md) - [Funding Payments](https://hypernode-docs.polynode.dev/rest/user-data/user-funding.md) - [Multi-Sig Signers](https://hypernode-docs.polynode.dev/rest/user-data/user-multi-sig.md): Authorized signers for multi-sig controlled accounts - [Referrals](https://hypernode-docs.polynode.dev/rest/user-data/user-referrals.md) - [Staking Positions](https://hypernode-docs.polynode.dev/rest/user-data/user-staking.md) - [Vault Deposits](https://hypernode-docs.polynode.dev/rest/user-data/user-vaults.md) ## OpenAPI Specs - [openapi](https://hypernode-docs.polynode.dev/openapi.json) ## Optional - [polynode](https://polynode.dev)