> ## 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. # Đặt lệnh mới > Đặt lệnh mới ## OpenAPI ````yaml openapi.docs.vi.json POST /api/v1/orders/new/{refOrderID}/{accountID}/{symbol}/{orderSide}/{price}/{qty}/{orderType} 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/orders/new/{refOrderID}/{accountID}/{symbol}/{orderSide}/{price}/{qty}/{orderType}: post: tags: - Lệnh summary: Đặt lệnh mới description: >- Place a normal order. KrakenD forwards the authenticated user from JWT and sends all order fields as path parameters; there is no JSON request body. operationId: placeOrder parameters: - name: refOrderID in: path required: true schema: type: string description: >- Client-generated order reference used for tracking and duplicate detection. - name: accountID in: path required: true schema: type: string description: >- Mã tài khoản giao dịch. Người dùng đang đăng nhập phải có quyền truy cập tài khoản này. - 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. - name: orderSide in: path required: true schema: type: string description: 'Order side. Accepted values: B for buy, S for sell.' - name: price in: path required: true schema: type: number description: >- Order price. For market-style orders, backend interpretation depends on orderType. - name: qty in: path required: true schema: type: integer format: int64 description: Order quantity in shares/contracts/lots accepted by the broker. - name: orderType in: path required: true schema: type: string description: Order type. Common accepted values include LO, MTL, ATO, and ATC. responses: '200': description: Kết quả đặt lệnh thường. content: application/json: schema: $ref: '#/components/schemas/PlaceOrderResponse' examples: success: summary: Response thành công value: isSuccess: true detail: Order placed successfully data: ORDER-V1StGXR8_Z5jdHi6B-myT '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: - bearerAuth: [] components: schemas: PlaceOrderResponse: type: object additionalProperties: true description: Response đặt lệnh thường. required: - isSuccess - detail - data properties: isSuccess: type: boolean description: Backend đã chấp nhận và gửi lệnh tới broker hay chưa. detail: type: string description: >- Thông điệp kết quả. Thành công thường là "Order placed successfully"; lỗi chứa lý do reject/validation. data: type: string pattern: ^ORDER- example: ORDER-V1StGXR8_Z5jdHi6B-myT description: >- System order id do service.orderapi sinh cho lệnh mới. Dùng id này cho API cancel, execution reports và đối chiếu order stream. Đây không phải external broker order id và cũng không phải refOrderID client gửi vào request. 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. 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 securitySchemes: bearerAuth: type: http scheme: bearer description: Bearer token used for protected REST API requests. ````