> For the complete documentation index, see [llms.txt](https://liquidiction.gitbook.io/liquidiction-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://liquidiction.gitbook.io/liquidiction-docs/readme.md).

# Welcome to Liquidiction

Liquidiction is a frontend for HIP-4 prediction markets on Hyperliquid. We do not operate the markets, custody funds, route through intermediaries, or decide settlement. Every trade, transfer, and resolution happens directly on HyperCore L1 with your connected wallet signing every action.

## What is Liquidiction?

Liquidiction provides a purpose-built interface for Hyperliquid's native HIP-4 prediction market protocol. Hyperliquid runs the protocol and operates the orderbook; Liquidiction is the UI layer that makes browsing, trading, and analyzing prediction markets easier than using the bare L1.

Features:

* **Trading**: Market, limit, ladder, and TWAP orders, all signed by your wallet and submitted directly to HL
* **Real-time charts**: Price, volume, and multi-outcome visualization
* **Portfolio**: Live positions, PnL calendars, trade history
* **Explorer**: Sortable market data with depth, volume, and open interest
* **Battles**: Time-boxed trading contests scored against on-chain fills
* **Hedge**: Auto-detected perp positions to offset binary crypto exposure
* **Analytics**: Aggregate volume charts, unique traders, and cross-platform market share (Polymarket vs Kalshi vs HIP-4)
* **Points system** (in beta on mainnet, full docs coming soon): tier-based weekly scoring of HIP-4 activity routed via Liquidiction
* **Triggers** (in beta on mainnet, full docs coming soon): event-based automation for orders and notifications

## Why Hyperliquid?

Prediction markets on Hyperliquid are fundamentally different from platforms like Polymarket:

|                    | Liquidiction (HIP-4)                         | Polymarket              |
| ------------------ | -------------------------------------------- | ----------------------- |
| **Execution**      | On-chain L1 orderbook                        | Off-chain matching      |
| **Custody**        | Non-custodial, always                        | Deposits to contract    |
| **Settlement**     | Native HyperCore                             | Smart contract / oracle |
| **Speed**          | Sub-second block times                       | Variable                |
| **Fee model**      | Free to open, charged on close or settlement | Platform fees           |
| **Infrastructure** | Same as HYPE spot/perps                      | Separate system         |
| **Margin**         | Unified Portfolio Margin available           | Isolated per market     |

HIP-4 outcomes trade on the same spot orderbook infrastructure that powers all of Hyperliquid's spot trading. This means the same speed, the same liquidity engine, and the same security model.

## Capital Efficiency

Research shows 100,693 wallets are active on both Polymarket and Hyperliquid, generating $6.1B in PM volume. These traders currently split their capital across platforms. Hyperliquid's Portfolio Margin lets eligible accounts share collateral across spot, perps, and prediction positions, reducing capital requirements 30-60%. See [Portfolio Margin](/liquidiction-docs/platform/portfolio-margin.md) for the threshold and tradeoffs.

## Current Status

Liquidiction is **live on Hyperliquid mainnet** at [liquidiction.xyz](https://liquidiction.xyz). All mainnet trading is quoted in USDC on HyperCore L1.

> **Quote asset**: USDC replaced USDH as the HIP-4 quote asset on mainnet on 28 May 2026, under Hyperliquid's aligned quote asset framework ([AQAv2 spec](https://hyperliquid.gitbook.io/hyperliquid-docs/hypercore/aligned-quote-assets)). Current mainnet and testnet outcomes quote in USDC. Integrations should still read each market's `quoteToken` rather than hardcoding an asset.

Testnet remains available at [testnet.liquidiction.xyz](https://testnet.liquidiction.xyz) for developers and integrators. Testnet positions, balances, and PnL are entirely separate from mainnet.

## Quick Links

* [Getting Started](/liquidiction-docs/getting-started/connect-wallet.md)
* [How HIP-4 Works](/liquidiction-docs/hip-4-prediction-markets/how-it-works.md)
* [Trading Guide](/liquidiction-docs/trading/buying-and-selling.md)
* [Order Types](/liquidiction-docs/trading/order-types.md)
* [Battles](/liquidiction-docs/platform/battles.md)
* [FAQ](/liquidiction-docs/faq/common-questions.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://liquidiction.gitbook.io/liquidiction-docs/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.