# Markets (/market-data/markets)



Use `mlab markets` before running a command on a new exchange or symbol.

## Standalone Exchanges [#standalone-exchanges]

| Exchange       | Market                                    |
| -------------- | ----------------------------------------- |
| `binance`      | Binance Spot                              |
| `binancef`     | Binance USD-M perpetuals                  |
| `bulkf`        | BULK perpetuals                           |
| `hyperliquid`  | Hyperliquid HIP-1 Spot and HIP-4 outcomes |
| `hyperliquidf` | Hyperliquid core and HIP-3 perpetuals     |

## Refresh a Snapshot [#refresh-a-snapshot]

```bash
mlab markets --exchange binancef --refresh
mlab markets --exchange bulkf --refresh
mlab markets --exchange bulkf --testnet
mlab markets --exchange hyperliquid --hip 1 --refresh
mlab markets --exchange hyperliquidf --refresh
```

MMT snapshot:

```bash
mlab markets --provider mmt --exchange binancef --refresh
```

Snapshots are stored under `~/.market-lab/markets` and read locally until refreshed.

## Find a Symbol [#find-a-symbol]

```bash
mlab markets --exchange hyperliquidf
mlab markets --exchange hyperliquidf --symbol BTC
mlab markets --exchange hyperliquid --hip 1 --symbol HYPE/USDC
mlab markets --exchange hyperliquidf --symbol xyz:TSLA
mlab markets --exchange hyperliquidf --symbol io:ANTH
```

`hyperliquidf` refresh discovers Hyperliquid's live `perpDexs` list and stores core plus every available HIP-3 market in one snapshot. A HIP-3 symbol includes its DEX scope, such as `xyz:TSLA` or `io:ANTH`.

HyperLink is execution-only and does not create its own market snapshot. Use `hyperliquid` to discover Spot pairs executed through `hyperlink`, and `hyperliquidf` to discover core or HIP-3 perpetuals executed through `hyperlinkf`.

Use `--json` for machine-readable output:

```bash
mlab markets --exchange bulkf --symbol BTC --json
```

## Symbol Rules [#symbol-rules]

Core perpetuals use the base asset. HIP-3 perpetuals use `{dex}:{coin}`:

```text
BTC
ETH
xyz:TSLA
io:ANTH
```

Spot uses the exact pair:

```text
BTC/USDT
HYPE/USDC
```

Do not add a synthetic `/USDT` to a perpetual symbol.

## Outcome Markets [#outcome-markets]

Outcome markets are fetched live and can rotate:

```bash
mlab markets --exchange hyperliquid --hip 4
mlab markets --exchange hyperliquid --hip 4 --search BTC
mlab markets --exchange hyperliquid --hip 4 --deployer out
mlab markets --exchange hyperliquid --hip 4 --symbol 1009:0
mlab markets --exchange hyperliquid --hip 4 --testnet
```

`--deployer` accepts an exact deployer venue or address. Outcome rows include the deployer and a readable question built from Hyperliquid's template metadata.

Hyperliquid market discovery always requires `--hip 1` for Spot or `--hip 4` for outcomes. The flag applies only to `mlab markets`; source and execution commands select the product from the symbol.

Outcomes do not support `--refresh` and are not stored in a static market snapshot.

You can also search the [web market catalog](https://marketlab.sh/markets).