> ## Documentation Index
> Fetch the complete documentation index at: https://docs.algo.verolabs.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Making Control

> Quản lý vòng đời thuật toán Market Making: khởi tạo, giám sát, tinh chỉnh và kiểm soát rủi ro

<div style={{ width: '100%', height: 240, marginBottom: 32, borderRadius: 16, overflow: 'hidden', position: 'relative' }}>
  <video style={{ width: '100%', height: '100%', objectFit: 'cover', filter: 'sepia(0.3) saturate(1.5) hue-rotate(-14deg) brightness(0.72) contrast(1.12)' }} autoPlay loop muted playsInline>
    <source src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/bg_video.mp4?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=384435339d88c0c9a9b66d649b873601" type="video/mp4" data-path="images/bg_video.mp4" />
  </video>
</div>

<div style={{ width: '100%', height: 4, marginBottom: 24, borderRadius: 2, background: 'rgba(0,0,0,0.08)' }}>
  <div style={{ width: '45.45%', height: '100%', borderRadius: 2, background: 'linear-gradient(90deg, var(--accent-primary) 0%, var(--accent-light) 50%, var(--accent-dark) 100%)' }} />
</div>

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-market-making-control-overview.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=85f7ae1e596cf46ce9b1b0886b3ca364" alt="Market Making Control Overview" style={{ width: '100%', borderRadius: 16 }} width="1024" height="516" data-path="images/view-market-making-control-overview.png" />

Màn hình điều hành trung tâm cho Market Making: tạo thuật toán, nhập theo nhóm, giám sát hiệu suất theo thời gian thực và xử lý tình huống khẩn cấp.

<Info>
  Luồng khuyến nghị: **Khởi tạo** → **Giám sát** → **Tinh chỉnh** → **Kiểm soát rủi ro**.
</Info>

<CardGroup cols={3}>
  <Card title="Create Market Making" icon="circle-plus">
    Tạo thuật toán theo từng mã với cấu hình đầy đủ Basic, Mode Setting và Safety.
  </Card>

  <Card title="Import Basket" icon="file-arrow-up">
    Nhập hàng loạt thuật toán bằng Manual Input hoặc CSV theo template.
  </Card>

  <Card title="Emergency Stop" icon="triangle-exclamation">
    Dừng toàn bộ thuật toán MM đang chạy khi phát sinh rủi ro hệ thống hoặc thị trường.
  </Card>
</CardGroup>

## Khởi tạo và điều khiển

### 1) Tạo thuật toán Market Making

Bấm **Create Market Making** để mở quy trình cấu hình 3 bước.

#### Bước 1 — Basic

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-create-mm-basic.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=9908b3c9b958c998aee503b8d9830cbb" alt="Create Market Making - Basic" width="1024" height="755" data-path="images/view-create-mm-basic.png" />

Màn hình cấu hình thông tin cơ bản của thuật toán:

| Trường                   | Mục đích                        |
| ------------------------ | ------------------------------- |
| **Market Making Symbol** | Mã CW/chứng khoán cần tạo lập   |
| **Underlying Symbol**    | Mã cơ sở để tính giá mục tiêu   |
| **MM Account**           | Tài khoản đặt lệnh bid/ask      |
| **Hedge Account**        | Tài khoản hedge (nếu cần hedge) |

#### Bước 2 — Mode Setting

##### Pricing Model

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-create-mm-mode-black-scholes.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=d1a4743a8b4698c86c550e7a759055de" alt="Mode Setting - Black Scholes" width="1024" height="402" data-path="images/view-create-mm-mode-black-scholes.png" />

**Black-Scholes**: định giá CW theo các tham số:

* **Strike Price (K)**: giá thực hiện của quyền chọn
* **Maturity Date**: ngày đáo hạn
* **Volatility (%)**: độ biến động ngầm định (implied volatility)
* **Risk-Free Rate (%)**: lãi suất phi rủi ro
* **Option Type**: Call hoặc Put
* **Conversion Ratio**: tỷ lệ chuyển đổi (ví dụ: 0.1 = 10 warrants cho 1 cổ phiếu cơ sở)

Phù hợp cho quyền chọn và CW.

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-create-mm-mode-delta-one.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=5c8801fb2cf846a4f02fd50a75e0278c" alt="Mode Setting - Delta One" width="1024" height="309" data-path="images/view-create-mm-mode-delta-one.png" />

**Delta One**: giá mục tiêu tuyến tính theo underlying (`price = slope × S + intercept`). Phù hợp cho market making symbol có tính cointegration với underlying (ví dụ: ETF VN30 trên underlying VN30).

* **Pricing Slope**: hệ số nhân cho giá underlying (multiplier for underlying price)
* **Pricing Intercept**: giá trị cố định cộng thêm vào giá (fixed offset added to price)

##### Core Parameters

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-create-mm-mode-core-params.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=da2dfe34e5a7708371b6d551a0aca81b" alt="Mode Setting - Core Parameters" width="1024" height="324" data-path="images/view-create-mm-mode-core-params.png" />

Cấu hình các thông số vận hành chính:

**Price Mode**: chế độ tham chiếu giá để đặt lệnh

* **Last Price**: sử dụng giá khớp cuối cùng làm tham chiếu
* **Best Bid/Ask**: sử dụng giá tốt nhất hiện tại làm tham chiếu

**Price bid-ask spacing (price step)**: khoảng cách giá giữa bid và ask so với giá lý thuyết (spread), tính bằng bậc giá

**Randomize Qty Interval (ms)**: chu kỳ thay đổi khối lượng ngẫu nhiên (milliseconds)

**Volume Configuration**:

* **Bid Max Qty**: tổng khối lượng tối đa trên bid
* **Bid Random Qty (%)**: tỷ lệ % randomize khối lượng bid trên từng layer
* **Ask Max Qty**: tổng khối lượng tối đa trên ask
* **Ask Random Qty (%)**: tỷ lệ % randomize khối lượng ask trên từng layer

##### Layering

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-create-mm-mode-layering-symmetric.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=49b7b1caffc33977f466ea73fb6898e7" alt="Mode Setting - Layering Symmetric" width="1024" height="370" data-path="images/view-create-mm-mode-layering-symmetric.png" />

**Symmetric**: bid/ask cân đối, phân bổ khối lượng đều hai bên.

* **Layering Mode**: chế độ phân lớp (Symmetric)
* **Layer Count**: số lượng layer (độ sâu sổ lệnh)
* **Price layer spacing (price step)**: khoảng cách giá giữa các layer
* **Symmetric Layering Configuration**: phân bổ khối lượng cho từng layer (L1, L2, L3, L4, L5)

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-create-mm-mode-layering-asymmetric.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=a38d2daacb12c3803b0bda71d8474db4" alt="Mode Setting - Layering Asymmetric" width="1024" height="426" data-path="images/view-create-mm-mode-layering-asymmetric.png" />

**Asymmetric**: bid/ask cấu hình độc lập, điều chỉnh theo xu hướng thị trường.

* **Layering Mode**: chế độ phân lớp (Asymmetric)
* **Layer Count**: số lượng layer
* **Asymmetric Layering Configuration**: bảng cấu hình chi tiết cho từng layer
  * **Level**: mức layer (L1, L2, L3, ...)
  * **Bid Price Step**: khoảng cách giá bid so với giá lý thuyết từ pricing model
  * **Ask Price Step**: khoảng cách giá ask so với giá lý thuyết từ pricing model
  * **Bid Qty %**: phần trăm khối lượng bid cho layer này
  * **Ask Qty %**: phần trăm khối lượng ask cho layer này

##### Hedging

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-hedge-coverage-overview.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=c3835d525941e0ad6921a0e50b52e94c" alt="Warrant Hedge Coverage Overview" width="3006" height="1076" data-path="images/view-hedge-coverage-overview.png" />

Màn hình giám sát hedge coverage cho warrant, hiển thị trạng thái hedge theo thời gian thực:

**Filter Tabs**:

* **All**: hiển thị tất cả warrant
* **Missing Hedge**: warrant chưa có hedge hoặc thiếu hedge
* **Over Hedge**: warrant có hedge vượt mức cần thiết
* **Invalid Hedger**: warrant có cấu hình hedge không hợp lệ

**Coverage Table Columns**:

* **Warrant**: mã chứng quyền (ví dụ: CMWG2504, CMWG2510)
* **Hedger Status**: trạng thái hedger (WARN = cảnh báo cần xem xét)
* **Delta**: hệ số delta của warrant (độ nhạy giá so với underlying)
* **Req Hedge**: khối lượng hedge yêu cầu (required hedge quantity)
* **Hedge Pos**: vị thế hedge hiện tại (current hedge position)
* **Residual**: chênh lệch giữa hedge yêu cầu và thực tế (màu đỏ = thiếu hedge, màu xanh = dư hedge)
* **Gap Qty**: khối lượng chênh lệch cần điều chỉnh
* **Gap Notional**: giá trị danh nghĩa của gap (VND)
* **Covered**: tỷ lệ % hedge coverage (0% = chưa hedge, -3% = over hedge)

**Summary Metrics**:

* **Total Missing Hedge Notional**: tổng giá trị danh nghĩa thiếu hedge (màu đỏ)
* **Total Over Hedge Notional**: tổng giá trị danh nghĩa hedge dư (màu vàng)

Màn hình này giúp trader nhanh chóng xác định warrant nào cần điều chỉnh hedge để duy trì delta neutral.

#### Bước 3 — Safety

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-create-mm-safety-limits-anti-arb.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=7573f0c09cf51ec74d11304a52f2347c" alt="Safety Limits and Anti-Arb" width="1024" height="421" data-path="images/view-create-mm-safety-limits-anti-arb.png" />

**Safety Limits**:

* **Max Loss (0 = disabled)**: ngưỡng lỗ tối đa (VND), dừng thuật toán khi tổng lỗ vượt giá trị này (0 = không giới hạn)
* **Take Profit (0 = disabled)**: ngưỡng lời mục tiêu (VND), dừng thuật toán khi đạt lợi nhuận này (0 = không giới hạn)

**Anti-Arb Safety**: cơ chế phòng chống arbitrage

* **Fill Window (ms)**: cửa sổ thời gian quan sát fill (milliseconds)
* **Fill Threshold (VND)**: ngưỡng giá trị danh nghĩa fill bất thường trong cửa sổ thời gian để kích hoạt bảo vệ
* **Qty Reduction %**: phần trăm giảm khối lượng khi phát hiện fill bất thường
* **Cooldown (ms)**: thời gian chờ trước khi khôi phục khối lượng bình thường (milliseconds)

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-create-mm-safety-throttle.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=1a3b978cf4bada636f0625ccaf5a4dd0" alt="Safety Throttle" width="1024" height="224" data-path="images/view-create-mm-safety-throttle.png" />

**Price Update Throttling**:

* **Min Update Interval (ms)**: khoảng thời gian tối thiểu giữa các lần cập nhật giá (milliseconds). Giá trị 0 = không throttling. Giúp giảm nhiễu và ổn định runtime.

### 2) Import hàng loạt

#### Manual Input

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-import-basket-manual.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=33e27294286893a41a8fa97671d74894" alt="Import Basket Manual" width="1024" height="754" data-path="images/view-import-basket-manual.png" />

Nhập từng dòng thuật toán thủ công: Add Row → nhập thông tin → Start All.

#### CSV Import

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-import-basket-csv.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=e4982df5565670aa845f8e67e104a61e" alt="Import Basket CSV" width="1024" height="749" data-path="images/view-import-basket-csv.png" />

Tải template → upload file → xác nhận cột bắt buộc: `accountID`, `product`, `mmMode`.

### 3) Emergency Stop

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-emergency-stop-dialog.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=54fa0510cf8c3a3ea5150cc1fd743b3a" alt="Emergency Stop Dialog" width="1024" height="567" data-path="images/view-emergency-stop-dialog.png" />

<Warning>
  **Emergency Stop** dừng ngay toàn bộ thuật toán MM đang chạy. Chỉ sử dụng khi có bất thường thị trường, lỗi hệ thống, hoặc rủi ro vượt ngưỡng kiểm soát.
</Warning>

## Giám sát thuật toán theo tab

Sau khi chọn algo ở panel trái, khu vực chi tiết bên phải cung cấp 6 tab giám sát.

| Tab               | Mục tiêu theo dõi                          | Trigger hành động                            |
| ----------------- | ------------------------------------------ | -------------------------------------------- |
| **Overview**      | Quote status, vị thế, đóng góp thanh khoản | P\&L biến động mạnh, net position lệch nhanh |
| **Configuration** | Cấu hình runtime hiện tại (read-only)      | Cần đối chiếu cấu hình kỳ vọng/thực tế       |
| **Performance**   | Hiệu suất tổng hợp, open/filled orders     | Fill rate thấp, slippage tăng                |
| **Orders**        | Toàn bộ lệnh đã gửi vào thị trường         | Reject/Cancel bất thường                     |
| **Trades**        | Giao dịch đã khớp                          | Đối soát P\&L và hành vi khớp lệnh           |
| **Logs**          | Runtime logs và cảnh báo hệ thống          | Debug sự cố và truy vết thay đổi             |

### Overview

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-control-overview.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=ab533f6de22c7bdb435a12bdaaea6eab" alt="Control Overview Tab" width="1024" height="551" data-path="images/view-control-overview.png" />

**MM Status**: trạng thái quote hiện tại

* **Best Bid**: giá bid tốt nhất của thuật toán
* **Theo Price**: giá lý thuyết (theoretical price)
* **Best Ask**: giá ask tốt nhất của thuật toán
* **Bid Qty**: tổng khối lượng bid
* **Ask Qty**: tổng khối lượng ask

**Position Details**: thông tin vị thế

* **Avg Buy Price**: giá mua trung bình
* **Unrealized P\&L**: lãi/lỗ chưa thực hiện
* **Realized P\&L**: lãi/lỗ đã thực hiện
* **Symbol**: mã chứng khoán đang market making
* **Hedge Value**: giá trị hedge hiện tại

**Liquidity Stats**: thống kê đóng góp thanh khoản

* **Liquidity Join %**: tỷ lệ % tham gia thanh khoản so với thị trường
* **Market Filled Vol**: khối lượng thị trường đã khớp
* **Algo Filled Vol**: khối lượng thuật toán đã khớp
* **Algo Filled Value**: giá trị thuật toán đã khớp
* **Filled Order Count**: số lượng lệnh đã khớp

### Configuration

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-control-configuration.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=a55b4452fcd756d65fb26e601436af40" alt="Control Configuration Tab" width="1024" height="552" data-path="images/view-control-configuration.png" />

Hiển thị cấu hình runtime: core settings, order settings, layering, pricing model, hedge settings, self fill, probe orders.

### Performance

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-control-performance.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=53f8eba7b00aa7b2a4cf5cf58ab8d58b" alt="Control Performance Tab" width="1024" height="554" data-path="images/view-control-performance.png" />

**Summary Report**: báo cáo tổng hợp hiệu suất

* **Filled Buy Qty**: tổng khối lượng buy đã khớp
* **Filled Sell Qty**: tổng khối lượng sell đã khớp
* **Net Qty**: vị thế ròng (buy - sell)
* **P\&L**: lãi/lỗ tổng
* **% Liquidity Join %**: tỷ lệ đóng góp thanh khoản
* **Market Vol**: khối lượng thị trường
* **Total Bid Qty**: tổng khối lượng bid đang mở
* **Total Bid Value**: tổng giá trị bid đang mở
* **Total Ask Qty**: tổng khối lượng ask đang mở
* **Total Ask Value**: tổng giá trị ask đang mở

**Open Orders**: lệnh đang mở

* Bid side: Price, Qty, Total
* Ask side: Price, Qty, Total

**Filled Orders**: lệnh đã khớp theo thời gian

* Time, Side, Price, Qty, Value

### Orders

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-control-orders.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=c8f0b83745b900942e22a473059474f0" alt="Control Orders Tab" width="1024" height="555" data-path="images/view-control-orders.png" />

Bảng lệnh chi tiết với các cột:

* **Order ID**: mã định danh lệnh
* **Status**: trạng thái lệnh (New, Filled, Partially Filled, Cancelled, Rejected)
* **Order Type**: loại lệnh (Limit, Market, etc.)
* **Side**: chiều lệnh (Buy/Sell)
* **Symbol**: mã chứng khoán
* **C.Qty**: khối lượng đặt (Created Quantity)
* **C.Price**: giá đặt (Created Price)
* **F.Qty**: khối lượng đã khớp (Filled Quantity)
* **Last Time**: thời gian cập nhật cuối

### Trades

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-control-trades.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=3abf700b4916720c2443d46332292265" alt="Control Trades Tab" width="1024" height="554" data-path="images/view-control-trades.png" />

Bảng giao dịch đã khớp với các cột:

* **Trade ID**: mã định danh giao dịch
* **Order ID**: mã lệnh tương ứng
* **Symbol**: mã chứng khoán
* **Qty**: khối lượng khớp
* **Price**: giá khớp
* **Time**: thời gian khớp

Dùng để đối chiếu P\&L và phân tích pattern execution.

### Logs

<img src="https://mintcdn.com/vero-397dca69/LyIXukYnmKWc5Fxw/images/view-control-logs.png?fit=max&auto=format&n=LyIXukYnmKWc5Fxw&q=85&s=e71b7c69cdaf617c216b37b5f4d01b8e" alt="Control Logs Tab" width="1024" height="552" data-path="images/view-control-logs.png" />

Nhật ký theo **INFO / WARN / ERROR** phục vụ vận hành và điều tra sự cố.

## Checklist vận hành chuẩn

<Steps>
  <Step title="Khởi tạo">
    Tạo hoặc import thuật toán, xác nhận cấu hình trước khi Start.
  </Step>

  <Step title="Giám sát sớm">
    Theo dõi Overview + Performance trong 15-30 phút đầu.
  </Step>

  <Step title="Tinh chỉnh">
    Điều chỉnh spread, size, refresh, hedge khi hiệu suất lệch mục tiêu.
  </Step>

  <Step title="An toàn">
    Kích hoạt Emergency Stop ngay khi rủi ro hệ thống/tài chính vượt ngưỡng.
  </Step>
</Steps>
