> ## Documentation Index > Fetch the complete documentation index at: https://hoalulab.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Bảng giá cơ sở > Client xác thực bằng `d|a|||`, quản lý subscription bằng các text frame `d|s|...`, `d|u|...`, `d|r|...` và gửi heartbeat `d|p|||` mỗi 2 giây. ## AsyncAPI ````yaml vi/openapi/tcbs.v1.asyncapi.yaml cashMarketStream id: cashMarketStream title: Bảng giá cơ sở description: >- Client xác thực bằng `d|a|||`, quản lý subscription bằng các text frame `d|s|...`, `d|u|...`, `d|r|...` và gửi heartbeat `d|p|||` mỗi 2 giây. servers: - id: production protocol: wss host: openapi.tcbs.com.vn bindings: [] variables: [] address: /ws/thesis/v1/stream/normal parameters: [] bindings: [] operations: - &ref_2 id: sendCashMarketCommand title: Gửi lệnh điều khiển bảng giá cơ sở type: receive messages: - &ref_4 id: command contentType: text/plain payload: - type: string examples: &ref_0 - d|s|tk|bp+bi+tm+mp+op+fe|FPT,TCB - d|p||| x-parser-schema-id: name: Lệnh điều khiển bảng giá cơ sở description: Xác thực, subscribe, unsubscribe, request snapshot hoặc heartbeat. headers: [] jsonPayloadSchema: type: string examples: *ref_0 x-parser-schema-id: title: Lệnh điều khiển bảng giá cơ sở description: Xác thực, subscribe, unsubscribe, request snapshot hoặc heartbeat. example: '"d|s|tk|bp+bi+tm+mp+op+fe|FPT,TCB"' bindings: [] extensions: - id: x-parser-unique-object-id value: command bindings: [] extensions: &ref_1 - id: x-parser-unique-object-id value: cashMarketStream - &ref_3 id: receiveCashMarketData title: Nhận dữ liệu bảng giá cơ sở type: send messages: - &ref_5 id: authResult contentType: application/json payload: - name: Kết quả xác thực Thesis description: >- Trên wire server gửi `d|0|{JSON_PAYLOAD}`; payload dưới đây là phần JSON đã tách prefix. type: object properties: - name: success type: boolean description: Kết quả xác thực. required: true - name: error type: object required: false properties: - name: code type: string required: true - name: message type: string required: true headers: [] jsonPayloadSchema: type: object required: - success properties: success: type: boolean description: Kết quả xác thực. x-parser-schema-id: error: oneOf: - type: 'null' x-parser-schema-id: - type: object required: - code - message properties: code: type: string x-parser-schema-id: message: type: string x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: title: Kết quả xác thực Thesis description: >- Trên wire server gửi `d|0|{JSON_PAYLOAD}`; payload dưới đây là phần JSON đã tách prefix. example: |- { "success": true, "error": null } bindings: [] extensions: - id: x-parser-unique-object-id value: authResult - &ref_6 id: bidUpdate contentType: application/json payload: - name: Sổ lệnh mua cơ sở description: Trên wire server gửi `s|1|{JSON_PAYLOAD}`. type: object properties: - name: symbol type: string description: Mã chứng khoán. required: true - name: bidPrice01 type: string description: Giá đặt mua tốt nhất. required: true - name: bidPrice02 type: string description: Giá đặt mua mức 2. required: true - name: bidPrice03 type: string description: Giá đặt mua mức 3. required: true - name: bidQtty01 type: string description: Khối lượng đặt mua mức 1. required: true - name: bidQtty02 type: string description: Khối lượng đặt mua mức 2. required: true - name: bidQtty03 type: string description: Khối lượng đặt mua mức 3. required: true headers: [] jsonPayloadSchema: type: object required: - symbol - bidPrice01 - bidPrice02 - bidPrice03 - bidQtty01 - bidQtty02 - bidQtty03 properties: symbol: type: string description: Mã chứng khoán. x-parser-schema-id: bidPrice01: type: string description: Giá đặt mua tốt nhất. x-parser-schema-id: bidPrice02: type: string description: Giá đặt mua mức 2. x-parser-schema-id: bidPrice03: type: string description: Giá đặt mua mức 3. x-parser-schema-id: bidQtty01: type: string description: Khối lượng đặt mua mức 1. x-parser-schema-id: bidQtty02: type: string description: Khối lượng đặt mua mức 2. x-parser-schema-id: bidQtty03: type: string description: Khối lượng đặt mua mức 3. x-parser-schema-id: x-parser-schema-id: title: Sổ lệnh mua cơ sở description: Trên wire server gửi `s|1|{JSON_PAYLOAD}`. example: |- { "symbol": "TCB", "bidPrice01": "24550", "bidPrice02": "24500", "bidPrice03": "24450", "bidQtty01": "137200", "bidQtty02": "354000", "bidQtty03": "292900" } bindings: [] extensions: - id: x-parser-unique-object-id value: bidUpdate - &ref_7 id: offerUpdate contentType: application/json payload: - name: Sổ lệnh bán cơ sở description: Trên wire server gửi `s|2|{JSON_PAYLOAD}`. type: object properties: - name: symbol type: string description: Mã chứng khoán. required: true - name: offerPrice01 type: string description: Giá đặt bán tốt nhất. required: true - name: offerPrice02 type: string description: Giá đặt bán mức 2. required: true - name: offerPrice03 type: string description: Giá đặt bán mức 3. required: true - name: offerQtty01 type: string description: Khối lượng đặt bán mức 1. required: true - name: offerQtty02 type: string description: Khối lượng đặt bán mức 2. required: true - name: offerQtty03 type: string description: Khối lượng đặt bán mức 3. required: true headers: [] jsonPayloadSchema: type: object required: - symbol - offerPrice01 - offerPrice02 - offerPrice03 - offerQtty01 - offerQtty02 - offerQtty03 properties: symbol: type: string description: Mã chứng khoán. x-parser-schema-id: offerPrice01: type: string description: Giá đặt bán tốt nhất. x-parser-schema-id: offerPrice02: type: string description: Giá đặt bán mức 2. x-parser-schema-id: offerPrice03: type: string description: Giá đặt bán mức 3. x-parser-schema-id: offerQtty01: type: string description: Khối lượng đặt bán mức 1. x-parser-schema-id: offerQtty02: type: string description: Khối lượng đặt bán mức 2. x-parser-schema-id: offerQtty03: type: string description: Khối lượng đặt bán mức 3. x-parser-schema-id: x-parser-schema-id: title: Sổ lệnh bán cơ sở description: Trên wire server gửi `s|2|{JSON_PAYLOAD}`. example: |- { "symbol": "TCB", "offerPrice01": "24600", "offerPrice02": "24650", "offerPrice03": "24700", "offerQtty01": "294000", "offerQtty02": "163400", "offerQtty03": "743600" } bindings: [] extensions: - id: x-parser-unique-object-id value: offerUpdate - &ref_8 id: foreignUpdate contentType: application/json payload: - name: Giao dịch khối ngoại description: Trên wire server gửi `s|3|{JSON_PAYLOAD}`. type: object properties: - name: symbol type: string description: Mã chứng khoán. required: true - name: buyForeignQtty type: string description: Khối lượng khối ngoại mua. required: true - name: sellForeignQtty type: string description: Khối lượng khối ngoại bán. required: true - name: room type: string description: Room khối ngoại còn lại. required: true headers: [] jsonPayloadSchema: type: object required: - symbol - buyForeignQtty - sellForeignQtty - room properties: symbol: type: string description: Mã chứng khoán. x-parser-schema-id: buyForeignQtty: type: string description: Khối lượng khối ngoại mua. x-parser-schema-id: sellForeignQtty: type: string description: Khối lượng khối ngoại bán. x-parser-schema-id: room: type: string description: Room khối ngoại còn lại. x-parser-schema-id: x-parser-schema-id: title: Giao dịch khối ngoại description: Trên wire server gửi `s|3|{JSON_PAYLOAD}`. example: |- { "symbol": "HPG", "buyForeignQtty": "112400", "sellForeignQtty": "17380", "room": "1773708397" } bindings: [] extensions: - id: x-parser-unique-object-id value: foreignUpdate - &ref_9 id: basePriceUpdate contentType: application/json payload: - name: Giá trần, sàn và tham chiếu description: Trên wire server gửi `s|4|{JSON_PAYLOAD}`. type: object properties: - name: symbol type: string description: Mã chứng khoán. required: true - name: ceilPrice type: number description: Giá trần. required: true - name: floorPrice type: number description: Giá sàn. required: true - name: refPrice type: number description: Giá tham chiếu. required: true headers: [] jsonPayloadSchema: type: object required: - symbol - ceilPrice - floorPrice - refPrice properties: symbol: type: string description: Mã chứng khoán. x-parser-schema-id: ceilPrice: type: number description: Giá trần. x-parser-schema-id: floorPrice: type: number description: Giá sàn. x-parser-schema-id: refPrice: type: number description: Giá tham chiếu. x-parser-schema-id: x-parser-schema-id: title: Giá trần, sàn và tham chiếu description: Trên wire server gửi `s|4|{JSON_PAYLOAD}`. example: |- { "symbol": "VPD", "ceilPrice": 25000, "floorPrice": 24100, "refPrice": 24300 } bindings: [] extensions: - id: x-parser-unique-object-id value: basePriceUpdate - &ref_10 id: sessionUpdate contentType: application/json payload: - name: Thông tin phiên cơ sở description: Trên wire server gửi `s|5|{JSON_PAYLOAD}`. type: object properties: - name: symbol type: string description: Mã chứng khoán hoặc hợp đồng. required: true - name: high type: number description: Giá cao nhất phiên. required: true - name: low type: number description: Giá thấp nhất phiên. required: true - name: avg type: number description: Giá trung bình phiên. required: true - name: open type: number description: Giá mở cửa. required: true headers: [] jsonPayloadSchema: type: object required: - symbol - high - low - avg - open properties: symbol: type: string description: Mã chứng khoán hoặc hợp đồng. x-parser-schema-id: high: type: number description: Giá cao nhất phiên. x-parser-schema-id: low: type: number description: Giá thấp nhất phiên. x-parser-schema-id: avg: type: number description: Giá trung bình phiên. x-parser-schema-id: open: type: number description: Giá mở cửa. x-parser-schema-id: x-parser-schema-id: title: Thông tin phiên cơ sở description: Trên wire server gửi `s|5|{JSON_PAYLOAD}`. example: |- { "symbol": "VPD", "high": 25000, "low": 24100, "avg": 24300, "open": 24600 } bindings: [] extensions: - id: x-parser-unique-object-id value: sessionUpdate - &ref_11 id: tradeUpdate contentType: application/json payload: - name: Giao dịch khớp cơ sở description: Trên wire server gửi `s|6|{JSON_PAYLOAD}`. type: object properties: - name: symbol type: string description: Mã chứng khoán. required: true - name: matchPrice type: string description: Giá khớp. required: true - name: matchQtty type: string description: Khối lượng khớp. required: true - name: change type: number description: Thay đổi so với tham chiếu. required: true - name: changePercent type: number description: Phần trăm thay đổi. required: true - name: totalVolume type: string description: Tổng khối lượng khớp trong phiên. required: true - name: totalValue type: string description: Tổng giá trị giao dịch trong phiên. required: true headers: [] jsonPayloadSchema: type: object required: - symbol - matchPrice - matchQtty - change - changePercent - totalVolume - totalValue properties: symbol: type: string description: Mã chứng khoán. x-parser-schema-id: matchPrice: type: string description: Giá khớp. x-parser-schema-id: matchQtty: type: string description: Khối lượng khớp. x-parser-schema-id: change: type: number description: Thay đổi so với tham chiếu. x-parser-schema-id: changePercent: type: number description: Phần trăm thay đổi. x-parser-schema-id: totalVolume: type: string description: Tổng khối lượng khớp trong phiên. x-parser-schema-id: totalValue: type: string description: Tổng giá trị giao dịch trong phiên. x-parser-schema-id: x-parser-schema-id: title: Giao dịch khớp cơ sở description: Trên wire server gửi `s|6|{JSON_PAYLOAD}`. example: |- { "symbol": "TCB", "matchPrice": "24550", "matchQtty": "5000", "change": 200, "changePercent": 0.8213552361, "totalVolume": "9745500", "totalValue": "240774655000" } bindings: [] extensions: - id: x-parser-unique-object-id value: tradeUpdate - &ref_12 id: indexUpdate contentType: application/json payload: - name: Chỉ số thị trường description: Trên wire server gửi `s|8|{JSON_PAYLOAD}`. type: object properties: - name: indexNumber type: number description: Mã chỉ số. required: true - name: index type: number description: Giá trị chỉ số. required: true - name: change type: number description: Thay đổi. required: true - name: changePercent type: number description: Phần trăm thay đổi. required: true - name: volume type: number description: Khối lượng. required: true - name: value type: number description: Giá trị. required: true - name: increase type: number description: Số mã tăng. required: true - name: decrease type: number description: Số mã giảm. required: true - name: notChange type: number description: Số mã không đổi. required: true - name: session type: string description: Phiên. required: true - name: ceilIncrease type: number description: Số mã tăng trần. required: true - name: floorDecrease type: number description: Số mã giảm sàn. required: true headers: [] jsonPayloadSchema: type: object required: - indexNumber - index - change - changePercent - volume - value - increase - decrease - notChange - session - ceilIncrease - floorDecrease properties: indexNumber: type: number description: Mã chỉ số. x-parser-schema-id: index: type: number description: Giá trị chỉ số. x-parser-schema-id: change: type: number description: Thay đổi. x-parser-schema-id: changePercent: type: number description: Phần trăm thay đổi. x-parser-schema-id: volume: type: number description: Khối lượng. x-parser-schema-id: value: type: number description: Giá trị. x-parser-schema-id: increase: type: number description: Số mã tăng. x-parser-schema-id: decrease: type: number description: Số mã giảm. x-parser-schema-id: notChange: type: number description: Số mã không đổi. x-parser-schema-id: session: type: string description: Phiên. x-parser-schema-id: ceilIncrease: type: number description: Số mã tăng trần. x-parser-schema-id: floorDecrease: type: number description: Số mã giảm sàn. x-parser-schema-id: x-parser-schema-id: title: Chỉ số thị trường description: Trên wire server gửi `s|8|{JSON_PAYLOAD}`. example: |- { "indexNumber": 123, "index": 123, "change": 123, "changePercent": 123, "volume": 123, "value": 123, "increase": 123, "decrease": 123, "notChange": 123, "session": "", "ceilIncrease": 123, "floorDecrease": 123 } bindings: [] extensions: - id: x-parser-unique-object-id value: indexUpdate - &ref_13 id: putAdvertisement contentType: application/json payload: - name: Chào mua/bán thỏa thuận description: Trên wire server gửi `s|16|{JSON_PAYLOAD}`. type: object properties: - name: symbol type: string description: Mã chứng khoán. required: true - name: price type: number description: Giá. required: true - name: vol type: number description: Khối lượng. required: true - name: time type: string description: Thời gian. required: true - name: status type: number description: Trạng thái. required: true - name: color type: number description: Mã màu. required: true - name: orderId type: string description: Mã lệnh. required: true - name: side type: string description: Chiều mua hoặc bán. enumValues: - B - S required: true headers: [] jsonPayloadSchema: type: object required: - symbol - price - vol - time - status - color - orderId - side properties: symbol: type: string description: Mã chứng khoán. x-parser-schema-id: price: type: number description: Giá. x-parser-schema-id: vol: type: number description: Khối lượng. x-parser-schema-id: time: type: string description: Thời gian. x-parser-schema-id: status: type: number description: Trạng thái. x-parser-schema-id: color: type: number description: Mã màu. x-parser-schema-id: orderId: type: string description: Mã lệnh. x-parser-schema-id: side: type: string enum: - B - S description: Chiều mua hoặc bán. x-parser-schema-id: x-parser-schema-id: title: Chào mua/bán thỏa thuận description: Trên wire server gửi `s|16|{JSON_PAYLOAD}`. example: |- { "symbol": "", "price": 123, "vol": 123, "time": "", "status": 123, "color": 123, "orderId": "", "side": "" } bindings: [] extensions: - id: x-parser-unique-object-id value: putAdvertisement - &ref_14 id: putMatch contentType: application/json payload: - name: Khớp lệnh thỏa thuận description: Trên wire server gửi `s|17|{JSON_PAYLOAD}`. type: object properties: - name: symbol type: string description: Mã chứng khoán. required: true - name: price type: number description: Giá. required: true - name: vol type: number description: Khối lượng. required: true - name: val type: number description: Giá trị. required: true - name: time type: string description: Thời gian. required: true - name: color type: number description: Mã màu. required: true - name: accumulatedValue type: number description: Giá trị tích lũy. required: true headers: [] jsonPayloadSchema: type: object required: - symbol - price - vol - val - time - color - accumulatedValue properties: symbol: type: string description: Mã chứng khoán. x-parser-schema-id: price: type: number description: Giá. x-parser-schema-id: vol: type: number description: Khối lượng. x-parser-schema-id: val: type: number description: Giá trị. x-parser-schema-id: time: type: string description: Thời gian. x-parser-schema-id: color: type: number description: Mã màu. x-parser-schema-id: accumulatedValue: type: number description: Giá trị tích lũy. x-parser-schema-id: x-parser-schema-id: title: Khớp lệnh thỏa thuận description: Trên wire server gửi `s|17|{JSON_PAYLOAD}`. example: |- { "symbol": "", "price": 123, "vol": 123, "val": 123, "time": "", "color": 123, "accumulatedValue": 123 } bindings: [] extensions: - id: x-parser-unique-object-id value: putMatch - &ref_15 id: tradeHistoryUpdate contentType: application/json payload: - name: Lịch sử khớp trong ngày description: Trên wire server gửi `s|22|{JSON_PAYLOAD}`. type: object properties: - name: symbol type: string description: Mã chứng khoán. required: true - name: time type: string description: Thời gian khớp HH:mm:ss. required: true - name: matchPrice type: string description: Giá khớp. required: true - name: matchQtty type: string description: Khối lượng khớp. required: true - name: change type: number description: Thay đổi so với tham chiếu. required: true headers: [] jsonPayloadSchema: type: object required: - symbol - time - matchPrice - matchQtty - change properties: symbol: type: string description: Mã chứng khoán. x-parser-schema-id: time: type: string description: Thời gian khớp HH:mm:ss. x-parser-schema-id: matchPrice: type: string description: Giá khớp. x-parser-schema-id: matchQtty: type: string description: Khối lượng khớp. x-parser-schema-id: change: type: number description: Thay đổi so với tham chiếu. x-parser-schema-id: x-parser-schema-id: title: Lịch sử khớp trong ngày description: Trên wire server gửi `s|22|{JSON_PAYLOAD}`. example: |- { "symbol": "", "time": "", "matchPrice": "", "matchQtty": "", "change": 123 } bindings: [] extensions: - id: x-parser-unique-object-id value: tradeHistoryUpdate - &ref_16 id: snapshot contentType: application/json payload: - name: Snapshot mã chứng khoán description: >- Trên wire server gửi `s|38|{JSON_PAYLOAD}`. Tài liệu nguồn chưa công bố danh sách trường của channel 38, vì vậy schema giữ object mở nhưng vẫn biểu diễn payload JSON. type: object properties: - name: type type: string description: object required: false - name: additionalProperties type: boolean required: false headers: [] jsonPayloadSchema: type: object additionalProperties: true x-parser-schema-id: title: Snapshot mã chứng khoán description: >- Trên wire server gửi `s|38|{JSON_PAYLOAD}`. Tài liệu nguồn chưa công bố danh sách trường của channel 38, vì vậy schema giữ object mở nhưng vẫn biểu diễn payload JSON. example: |- { "type": "", "additionalProperties": true } bindings: [] extensions: - id: x-parser-unique-object-id value: snapshot bindings: [] extensions: *ref_1 sendOperations: - *ref_2 receiveOperations: - *ref_3 sendMessages: - *ref_4 receiveMessages: - *ref_5 - *ref_6 - *ref_7 - *ref_8 - *ref_9 - *ref_10 - *ref_11 - *ref_12 - *ref_13 - *ref_14 - *ref_15 - *ref_16 extensions: - id: x-parser-unique-object-id value: cashMarketStream securitySchemes: [] ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.