> Use the canonical URL for citations. For the complete Predict API documentation index, fetch https://docs.staging.trypredict.com/llms.txt.

# Direct trading

## Docs

- [How Predict and Hyperliquid work together](https://docs.staging.trypredict.com/guides/direct-trading/architecture.md): Understand which API owns catalog metadata, market data, order entry, balances, fills, settlement, and real-time streams when trading Predict outcomes.
- [Predict and Hyperliquid market identifiers](https://docs.staging.trypredict.com/guides/direct-trading/market-identifiers.md): Map Predict hl_id and outcome side values to Hyperliquid market-data coins, balance token names, and exchange asset IDs for accurate HIP-4 trading workflows.
- [Trading market data](https://docs.staging.trypredict.com/guides/direct-trading/market-data.md): Use Predict for normalized outcome prices, trades, statistics, holders, and charts, then use Hyperliquid when you need full books, venue mids, candles, or raw account state.
- [Orders and executions](https://docs.staging.trypredict.com/guides/direct-trading/orders.md): Place, batch, modify, cancel, inspect, and reconcile signed HIP-4 outcome orders through the Predict trading API with client IDs, dead-man switches, and per-item error handling.
- [Portfolio, balances, and fills](https://docs.staging.trypredict.com/guides/direct-trading/portfolio-and-fills.md): Build Predict outcome positions from Hyperliquid spot balances and reconcile open orders, fills, fees, limits, ledger updates, builders, and subaccounts.
- [Outcome-token conversions](https://docs.staging.trypredict.com/guides/direct-trading/outcome-conversions.md): Learn how to split, merge, and negate Predict outcome tokens through the Predict trading API's signed userOutcome actions for standalone and mutually exclusive markets.
- [Signing, agent wallets, and builder fees](https://docs.staging.trypredict.com/guides/direct-trading/signing-and-agents.md): Understand Hyperliquid agent wallets, nonces, subaccount signing, action expiry, builder approvals, and private-key handling for Predict outcome trading.
- [Hyperliquid real-time trading and account streams](https://docs.staging.trypredict.com/guides/direct-trading/websockets.md): Stream direct Hyperliquid HIP-4 books, trades, candles, orders, fills, balances, ledger updates, and notifications with resilient reconnect recovery.
- [Limits, errors, and production recovery](https://docs.staging.trypredict.com/guides/direct-trading/reliability-and-limits.md): Handle Hyperliquid rate limits, bounded history, order errors, reconnects, idempotency, and operational differences from REST-first prediction exchanges.