Market Lab v0.0.7

Hyperliquid Spot, XYZ perpetuals, dynamic HIP-4 outcome markets, and corrected market symbols.

Market Lab v0.0.7 adds standalone Hyperliquid Spot, XYZ HIP-3 perpetuals, and dynamic HIP-4 outcome markets. It also removes synthetic quote assets from every futures symbol.

Hyperliquid Spot

Hyperliquid Spot is now available as:

--exchange hyperliquid
--venue hyperliquid

Hyperliquid core perpetuals remain hyperliquidf.

Authentication is shared:

mlab auth set hyperliquid

The existing mainnet and testnet API agents authorize both spot and perpetual execution. Mainnet is the default. Add --testnet for testnet spot execution.

Market catalog

mlab markets --exchange hyperliquid --refresh
mlab markets --exchange hyperliquid
mlab markets --exchange hyperliquid --symbol HYPE/USDC

The snapshot is stored at:

~/.market-lab/markets/hyperliquid-markets.json

Refresh reads mainnet spot metadata and matching testnet metadata. Network-specific token indexes, pair IDs, venue symbols, increments, and execution rules are stored separately inside the snapshot.

Real spot pairs

Spot keeps the actual quote asset:

HYPE/USDC
HYPE/USDH
HYPE/USDT0
HYPE/USDE

These pairs are not changed to /USDT. A bare spot asset such as HYPE is invalid because it does not identify the quote market.

Hyperliquid's trusted UBTC unit-token alias is exposed as BTC and mapped back to the correct venue token internally. Other assets beginning with U are not normalized automatically.

Market data

Standalone Hyperliquid Spot supports market snapshots, orderbooks, candles, trades, volumes, volume delta, and 24-hour statistics.

mlab source orderbook \
  --exchange hyperliquid \
  --symbol HYPE/USDC \
  --depth 20

Open interest and funding remain perpetual-only.

Execution

Use buy and sell for spot:

mlab trade buy HYPE/USDC \
  --venue hyperliquid \
  --margin 100 \
  --dry-run

mlab trade sell HYPE/USDC \
  --venue hyperliquid \
  --size 10 \
  --type limit \
  --price 45 \
  --tif alo \
  --dry-run

Spot supports market and limit orders, GTC, IOC, ALO, mainnet and testnet, open-order queries, fills, cancellations, and token balance queries.

mlab positions --venue hyperliquid displays total, held, and available token balances.

Spot does not support leverage, reduce-only orders, attached SL/TP, mlab close, built-in execution strategies, or built-in market-making bots. A custom live script can execute spot orders with --venue hyperliquid.

Spot plans omit leverage. For a spot buy, margin is the quote-asset sizing budget.

Market Lab validates quote balance for buys, base balance for sells, held versus available balance, lot size, minimum notional, and network-specific metadata. Market buys also reserve Hyperliquid's market-order slippage allowance during balance validation.

Standalone XYZ perpetuals

The Hyperliquid XYZ HIP-3 perpetual DEX is now available as a standalone exchange and execution venue:

--exchange hyperliquidf-xyz
--venue hyperliquidf-xyz

This integration supports XYZ only, not arbitrary HIP-3 DEXs. Symbols use Market Lab's normalized base asset:

TSLA

Do not enter xyz:TSLA or TSLA/USDT. Market Lab maps TSLA to the correct Hyperliquid wire symbol and asset ID internally.

Refresh, list, or inspect the standalone catalog:

mlab markets --exchange hyperliquidf-xyz --refresh
mlab markets --exchange hyperliquidf-xyz
mlab markets --exchange hyperliquidf-xyz --symbol TSLA

Mainnet and testnet use different XYZ DEX indices and asset IDs. Refresh checks both networks and stores each market's available variants. Users do not configure these values manually.

Standalone XYZ supports orderbooks, trades, candles, volume-derived data, open interest, and funding. Scripts use selectors such as:

tsla@candles@hyperliquidf-xyz:timeframe=60
tsla@orderbook@hyperliquidf-xyz:depth=20
tsla@trades@hyperliquidf-xyz
tsla@oi@hyperliquidf-xyz

Authentication is shared with Hyperliquid:

mlab auth set hyperliquid

No separate XYZ credential is required. Direct trades, TWAP, VWAP, OIWAP, market-making bots, and live scripts can execute through XYZ:

mlab trade long TSLA \
  --venue hyperliquidf-xyz \
  --margin 100 \
  --leverage 5 \
  --type market

Add --testnet to execution, strategy, or bot commands for Hyperliquid testnet. XYZ leverage, margin mode, and isolated-only restrictions come from Hyperliquid market metadata.

Hyperliquid outcome markets

Hyperliquid HIP-4 outcome markets are now available through one exchange and execution venue:

--exchange hyperliquid-outcomes
--venue hyperliquid-outcomes

Mainnet is the default. Add --testnet where supported for testnet. Outcome metadata is read from Hyperliquid's live outcomeMeta endpoint, so these markets are not stored in a static JSON snapshot and do not support --refresh.

Questions, outcomes, and sides

A question can contain several outcomes. Each outcome has two tradable sides:

0  positive / Yes
1  negative / No

Trading symbols combine the outcome ID and side:

1009:0
1009:1

Question IDs are used only by question-level actions. Mainnet and testnet use different question and outcome IDs.

Live discovery

mlab markets --exchange hyperliquid-outcomes
mlab markets --exchange hyperliquid-outcomes --search BTC
mlab markets --exchange hyperliquid-outcomes --symbol 1009:0
mlab markets --exchange hyperliquid-outcomes --testnet

Search covers IDs, symbols, question and outcome information, descriptions, and side names. Market Lab also turns Hyperliquid's structured template metadata into readable questions such as BTC above 64,315 at Aug 6, 06:00 UTC?.

Trading

mlab trade long \
  --venue hyperliquid-outcomes \
  --symbol 1009:0 \
  --margin 100 \
  --type market \
  --dry-run

mlab trade short \
  --venue hyperliquid-outcomes \
  --symbol 1009:0 \
  --size 10 \
  --type limit \
  --price 0.65 \
  --dry-run

long buys the selected outcome-side token. short sells tokens already held; naked shorting is not supported. Outcome execution is spot-like and rejects leverage, reduce-only orders, attached SL/TP, close-position semantics, built-in execution strategies, and market-making bots.

In an interactive terminal, the symbol can be omitted to open a searchable outcome selector. Non-interactive commands and --yes automation require an explicit symbol.

Outcome actions

mlab outcome split 1009 --amount 10 --dry-run
mlab outcome merge 1009 --amount 10 --dry-run
mlab outcome merge-question 166 --amount 10 --dry-run
mlab outcome negate 166 1014 --amount 10 --dry-run

Omit --amount from merge or merge-question to merge the maximum balanced amount. Every outcome action supports --testnet, --dry-run, --yes, and structured output.

Data, scripts, and account state

HIP-4 supports order books, trades, and candles. It does not provide perpetual-only open interest or funding.

1009:0@orderbook@hyperliquid-outcomes
1009:0@trades@hyperliquid-outcomes
1009:0@candles@hyperliquid-outcomes:timeframe=60

Account snapshots expose outcome holdings separately from perpetual positions and ordinary spot balances. Before execution, Market Lab fetches metadata again and rejects a plan when its metadata fingerprint no longer matches. See Hyperliquid outcome markets for discovery, trading, bots, and account actions.

Breaking futures symbols

Every futures and perpetual market now uses only its base asset:

BTC
ETH
HYPE

Legacy pair-shaped futures inputs are invalid:

BTC/USDT
BTC/USD
BTC/USDC
BTC-USD

This applies to markets, sources, studies, direct execution, cancel and close commands, bots, TWAP, VWAP, OIWAP, script selectors, TOML, job plans, structured output, BULK, Hyperliquid core and XYZ perpetuals, Binance Futures, and MMT futures exchanges.

mlab markets --exchange hyperliquidf --symbol BTC

mlab source orderbook \
  --exchange bulkf \
  --symbol BTC \
  --depth 20

mlab trade long BTC \
  --venue hyperliquidf \
  --margin 100 \
  --leverage 5

mlab bot run grid BTC \
  --venue bulkf \
  --margin 100 \
  --leverage 10 \
  --levels 5 \
  --step-bps 6

Venue wire symbols remain internal:

BULK             BTC-USD
Binance Futures  BTCUSDT
Hyperliquid Perp BTC

Users enter BTC for every one of them.

Spot is intentionally different. It keeps its real pair, such as BTC/USDT, HYPE/USDC, or HYPE/USDH.

Scripting symbols

Futures selectors stay compact:

btc@candles@binancef
btc@trades@bulkf
btc@oi@hyperliquidf

btc now resolves to BTC, not BTC/USDT.

Spot selectors include the pair:

hype/usdc@candles@hyperliquid
hype/usdc@orderbook@hyperliquid
hype/usdc@trades@hyperliquid

Upgrade from v0.0.6

The runtime protocol changed. Upgrade the CLI and daemon together:

Check whether a newer release is available with mlab upgrade --check.
Stop the existing daemon with mlab daemon stop.
Upgrade to the latest release with mlab upgrade.
Refresh every affected market snapshot.
Replace futures BASE/QUOTE inputs with BASE.
Keep spot inputs as exact BASE/QUOTE pairs.
Restart the daemon with mlab daemon start.
Recreate persisted jobs containing legacy futures pair symbols.

mlab upgrade --check
mlab daemon stop
mlab upgrade

Do not leave an older daemon running behind the v0.0.7 CLI.

On this page