> ## Documentation Index > Fetch the complete documentation index at: https://docs.oms.verolabs.co/llms.txt > Use this file to discover all available pages before exploring further. # Lấy dữ liệu product master theo mã > Lấy dữ liệu product master theo mã ## OpenAPI ````yaml openapi.docs.vi.json GET /api/v1/MarketData/GetProductMaster/{symbol} openapi: 3.0.3 info: title: Vero OMS REST API version: 1.0.24 description: >- Tài liệu REST API cho Vero OMS. Path được đối chiếu với KrakenD config hiện tại trong k8s-dev-gitops/vero-algo/tools/krakend và schema response được bổ sung từ source backend/frontend. servers: - url: https://api-gw.verolabs.co description: API gateway security: [] tags: - name: Xác thực description: Luồng xác thực và đăng xuất x-original-name: Auth - name: Đăng ký description: API hỗ trợ luồng đăng ký tài khoản - name: Tài khoản description: Tài khoản người dùng, số dư, vị thế, nạp và rút tiền x-original-name: Accounts - name: Tài khoản ngân hàng description: Quản lý tài khoản ngân hàng đã lưu x-original-name: Bank Accounts - name: Lệnh description: Đặt lệnh, hủy lệnh, sửa lệnh và lịch sử lệnh x-original-name: Orders - name: Lịch sử description: Lệnh, khớp lệnh và giao dịch tiền của tài khoản. x-original-name: History - name: Dữ liệu thị trường description: Watchlist, tìm kiếm mã, dữ liệu sản phẩm và lịch sử OHLCV x-original-name: Market Data - name: Thông báo description: Thông báo trong ứng dụng x-original-name: Notifications - name: Giới thiệu description: Mã giới thiệu, rebate và tổng hợp hoa hồng x-original-name: Referral - name: Chẩn đoán description: Endpoint kiểm tra sức khỏe và chẩn đoán hệ thống x-original-name: Diagnostics paths: /api/v1/MarketData/GetProductMaster/{symbol}: get: tags: - Dữ liệu thị trường summary: Lấy dữ liệu product master theo mã description: Get product master. operationId: getProductMaster parameters: - name: symbol in: path required: true schema: type: string description: Mã chứng khoán/sản phẩm, ví dụ FPT hoặc VN30F1M. responses: '200': description: Response dữ liệu mã với payload data có schema cụ thể. content: application/json: schema: type: object additionalProperties: true required: - isSuccess - data properties: isSuccess: type: boolean description: Cờ thành công do backend trả về. returnCode: oneOf: - type: number - type: string description: Mã trả về của backend; response thành công thường trả 0. serviceInstance: type: array items: type: object properties: serviceType: type: string description: Loại backend service xử lý request. instanceID: type: string description: Định danh instance backend service. lastUnixTime: type: number description: >- Timestamp mới nhất của service dạng Unix milliseconds. additionalProperties: true description: Danh sách instance market-data xử lý request. requestID: type: string description: Request id do market-data service sinh ra. algoID: type: string description: Algo id được echo lại khi request có truyền. positionID: type: string description: Position id được echo lại khi request có truyền. requestType: type: string description: Nhãn loại request do backend trả về. detail: type: string description: Thông điệp chi tiết từ backend. dataType: type: string description: Nhãn loại payload từ backend. executionTime: type: number description: Thời gian xử lý của backend tính bằng milliseconds khi có. lastTime: type: number description: Timestamp dữ liệu mới nhất do service trả về. data: type: object properties: symbol: type: string description: Mã giao dịch. companyName: type: string description: Tên công ty hoặc tên công cụ giao dịch. sectorLvl1: type: string description: Phân ngành cấp 1. sectorLvl2: type: string description: Phân ngành cấp 2. sectorLvl3: type: string description: Phân ngành cấp 3. industryName: type: string description: Tên ngành do market-data trả về. logoId: type: string description: Định danh logo dùng bởi client. news: type: array items: type: object additionalProperties: true description: >- Tin tức liên quan đến mã khi market-data service trả về news. description: Các tin tức liên quan đến mã. sentiment: type: object properties: bullish: type: number description: Điểm/số lượng sentiment bullish. bullishPercent: type: number description: Tỷ lệ phần trăm sentiment bullish. bullishTime: type: number description: >- Timestamp hoặc thời điểm tổng hợp sentiment bullish. bearish: type: number description: Điểm/số lượng sentiment bearish. bearishPercent: type: number description: Tỷ lệ phần trăm sentiment bearish. bearishTime: type: number description: >- Timestamp hoặc thời điểm tổng hợp sentiment bearish. additionalProperties: true nullable: true info: type: object properties: id: type: string description: Định danh công cụ trong market-data. seq: type: number description: Số sequence của quote. time: type: number description: Timestamp quote dạng Unix milliseconds. symbol: type: string description: Mã giao dịch. boardID: type: string description: Mã bảng giao dịch. nomiPrc: type: number description: Giá tham chiếu hoặc giá nominal. ceilPrc: type: number description: Giá trần trong phiên. floorPrc: type: number description: Giá sàn trong phiên. lsPrc: type: number description: Giá khớp cuối. lsVol: type: number description: Khối lượng khớp cuối. openPrc: type: number description: Giá mở cửa. closePrc: type: number description: Giá đóng cửa khi có. highPrc: type: number description: Giá cao nhất trong phiên. lowPrc: type: number description: Giá thấp nhất trong phiên. vWAP: type: number description: Giá trung bình gia quyền theo khối lượng. totVol: type: number description: Tổng khối lượng giao dịch. totVal: type: number description: Tổng giá trị giao dịch. tradingSession: type: string description: Mã phiên giao dịch. openInterest: type: number description: Open interest cho phái sinh khi có. additionalProperties: true nullable: true stat: type: object properties: id: type: string description: Định danh static của công cụ. symbol: type: string description: Mã giao dịch. type: type: string description: Loại chứng khoán/công cụ. lot: type: number description: Lô giao dịch chuẩn. minQty: type: number description: Khối lượng đặt lệnh tối thiểu. maxQty: type: number description: Khối lượng đặt lệnh tối đa. prcStep: type: number description: Bước giá tối thiểu. name: type: string description: Tên ngắn của công cụ. productGroupID: type: string description: Mã nhóm sản phẩm từ sở giao dịch. tickerCode: type: string description: Ticker code do sở giao dịch sử dụng. symbolName: type: string description: Tên đầy đủ của mã khi có. underlyingSymbolCode: type: string description: >- Mã tài sản cơ sở cho phái sinh hoặc sản phẩm cấu trúc. expirationDate: type: string description: Ngày đáo hạn cho phái sinh khi có. contractSize: type: number description: Quy mô hợp đồng cho phái sinh khi có. additionalProperties: true nullable: true depth: type: object properties: seq: type: number description: Số sequence của sổ lệnh. time: type: number description: Timestamp sổ lệnh dạng Unix milliseconds. symbol: type: string description: Mã giao dịch. boardID: type: string description: Mã bảng giao dịch. bidPriceDepth: type: array items: type: object properties: prc: type: number description: Mức giá. vol: type: number description: Tổng khối lượng tại mức giá. additionalProperties: true description: Các mức giá mua tốt nhất. askPriceDepth: type: array items: type: object properties: prc: type: number description: Mức giá. vol: type: number description: Tổng khối lượng tại mức giá. additionalProperties: true description: Các mức giá bán tốt nhất. additionalProperties: true nullable: true trend: type: object properties: buyUp: type: object properties: symbol: type: string description: Mã giao dịch. way: type: number description: Mã chiều giao dịch. vwapPrice: type: number description: VWAP của chiều giao dịch này. totalValue: type: number description: Tổng giá trị giao dịch của chiều này. totalVol: type: number description: Tổng khối lượng giao dịch của chiều này. tradeCount: type: number description: Số lượng giao dịch của chiều này. additionalProperties: true sellDown: type: object properties: symbol: type: string description: Mã giao dịch. way: type: number description: Mã chiều giao dịch. vwapPrice: type: number description: VWAP của chiều giao dịch này. totalValue: type: number description: Tổng giá trị giao dịch của chiều này. totalVol: type: number description: Tổng khối lượng giao dịch của chiều này. tradeCount: type: number description: Số lượng giao dịch của chiều này. additionalProperties: true buyUpPct: type: number description: Tỷ lệ volume/value thuộc nhóm buy-up. sellDownPct: type: number description: Tỷ lệ volume/value thuộc nhóm sell-down. gapValue: type: number description: >- Chênh lệch giá trị giao dịch giữa buy-up và sell-down. additionalProperties: true nullable: true additionalProperties: true description: Snapshot mã gồm thông tin master, quote, depth và trend. '400': $ref: '#/components/responses/ErrorResponse' description: Response lỗi. content: application/json: schema: $ref: '#/components/schemas/AnyErrorBody' application/problem+json: schema: oneOf: - $ref: '#/components/schemas/ValidationProblemDetails' - $ref: '#/components/schemas/ProblemDetails' text/plain: schema: type: string description: Thông điệp lỗi dạng text do backend hoặc gateway trả về. '401': $ref: '#/components/responses/ErrorResponse' description: Response lỗi. content: application/json: schema: $ref: '#/components/schemas/AnyErrorBody' application/problem+json: schema: oneOf: - $ref: '#/components/schemas/ValidationProblemDetails' - $ref: '#/components/schemas/ProblemDetails' text/plain: schema: type: string description: Thông điệp lỗi dạng text do backend hoặc gateway trả về. '404': $ref: '#/components/responses/ErrorResponse' description: Response lỗi. content: application/json: schema: $ref: '#/components/schemas/AnyErrorBody' application/problem+json: schema: oneOf: - $ref: '#/components/schemas/ValidationProblemDetails' - $ref: '#/components/schemas/ProblemDetails' text/plain: schema: type: string description: Thông điệp lỗi dạng text do backend hoặc gateway trả về. '500': $ref: '#/components/responses/ErrorResponse' description: Response lỗi. content: application/json: schema: $ref: '#/components/schemas/AnyErrorBody' application/problem+json: schema: oneOf: - $ref: '#/components/schemas/ValidationProblemDetails' - $ref: '#/components/schemas/ProblemDetails' text/plain: schema: type: string description: Thông điệp lỗi dạng text do backend hoặc gateway trả về. security: [] components: responses: ErrorResponse: description: Error response containing an error code, message, detail, or plain text. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' text/plain: schema: type: string schemas: AnyErrorBody: oneOf: - $ref: '#/components/schemas/ErrorResponse' - $ref: '#/components/schemas/ValidationProblemDetails' - $ref: '#/components/schemas/ProblemDetails' - $ref: '#/components/schemas/AuthFlow' description: >- Body lỗi có cấu trúc do gateway, ASP.NET service hoặc validation handler backend trả về. ValidationProblemDetails: allOf: - $ref: '#/components/schemas/ProblemDetails' - type: object additionalProperties: true properties: errors: type: object additionalProperties: oneOf: - type: array items: type: string - type: string description: Lỗi validation theo từng field request. description: Response lỗi validation khi param hoặc body field không hợp lệ. ProblemDetails: type: object additionalProperties: true description: Response lỗi kiểu RFC 7807 do ASP.NET/gateway trả về. properties: type: type: string description: URI loại lỗi. title: type: string description: Tiêu đề lỗi ngắn. status: type: integer description: Mã HTTP status. detail: type: string description: Thông điệp lỗi chi tiết. traceId: type: string description: Trace id để tra cứu lỗi backend. ErrorResponse: type: object additionalProperties: true description: >- Body loi do gateway hoac backend tra ve. Backend co the tra JSON object hoac loi dang plain text. properties: error: oneOf: - type: string - type: object additionalProperties: true properties: id: type: string description: Ma loi gateway khi co. code: type: integer description: Ma loi tuong duong HTTP. status: type: string description: Text trang thai HTTP, vi du Unauthorized. reason: type: string description: Ly do chi tiet do he thong hoac gateway tra ve. message: type: string description: Thong diep loi de doc. description: Chuoi ma/thong diep loi hoac object loi nested cua gateway. message: type: string description: Human-readable error message. detail: type: string description: Detailed backend error message when available. details: oneOf: - type: string - type: object additionalProperties: true - type: array items: type: object additionalProperties: true description: Chi tiết validation hoặc backend bổ sung. nullable: true status: type: integer description: HTTP status code when included by the backend. AuthFlow: type: object additionalProperties: true properties: id: type: string description: >- Ma flow. Dung gia tri nay lam query parameter flow khi submit hoac update flow. type: type: string description: Loai flow do he thong tra ve, vi du browser hoac api. expires_at: type: string format: date-time description: Thoi diem flow het han. Can submit flow truoc thoi diem nay. issued_at: type: string format: date-time description: Thoi diem he thong tao flow. ui: type: object additionalProperties: true description: >- Payload UI cua gom action URL, method, nodes, messages va CSRF node khi can. state: type: string description: >- Trang thai hien tai cua flow, vi du choose_method, sent_email, passed_challenge hoac success. request_url: type: string description: URL request goc dung de tao flow. organization_id: type: string nullable: true description: Ma organization cho flow theo organization, khi co. created_at: type: string description: Thoi diem tao flow. format: date-time updated_at: type: string description: Thoi diem cap nhat flow. format: date-time refresh: type: boolean description: Cho biet flow co phai refresh flow hay khong. requested_aal: type: string description: Muc dam bao xac thuc duoc yeu cau cho flow. identity: allOf: - 18a8e28a-07b2-496a-8619-bacbc39b1aff description: Identity gan voi settings flow khi tra ve. description: >- self-service flow object duoc tra ve boi cac endpoint tao/cap nhat login, registration, recovery va settings flow. ````