tradingOrdersDocsPage.orderManagement
API đặt và quản lý lệnh
Tạo, đóng, hủy và cập nhật lệnh qua các điểm cuối giao dịch Finger Trader đã xác thực.
Điểm cuối ghi lệnh
Các điểm cuối này có thể gửi hoặc thay đổi lệnh thật. Hãy xác nhận tài khoản, thị trường, mã giao dịch, khối lượng và quy tắc của broker trước khi thử.
Yêu cầu POST kèm Bearer Access Token và nội dung JSON. Ứng dụng Flutter gọi Finger Trader App BFF đã xác thực. Bắt đầu: xác thực
https://prod-api.fingertrader.com/finger-bff-appHeader xác thựcAuthorization: Bearer <ACCESS_TOKEN>Cần kích hoạt tài khoản Finger Trader và mở tài khoản tại broker trong hệ sinh thái Finger. Dùng Bearer Access Token như hướng dẫn trong Getting Started.
Phản hồi thành công dùng cấu trúc chuẩn Finger Trader gồm code, data và msg. Ví dụ từng điểm cuối minh họa cấu trúc data mà Flutter client phân tích.
Tạo lệnh
POST /app-api/v1/order/create-order
Gửi yêu cầu tạo lệnh mới.
Ví dụ yêu cầu
Các giá trị chỉ để minh họa. Hãy thay ticker, thị trường, mã tài khoản/đơn hàng và mã broker bằng dữ liệu tài khoản của bạn; xác nhận trường bắt buộc với broker trước khi gửi.
{
"ticker": "EURUSD",
"orderType": 1,
"orderSide": 1,
"qty": "1000",
"coinType": 0,
"walletType": 2,
"price": "1.08500",
"marginRate": 10,
"stopLoss": "1.07500",
"takeProfit": "1.09500",
"marketType": 0
}| Tham số | Kiểu | DTO phía ứng dụng | Tham chiếu |
|---|---|---|---|
ticker | string | Có thể null | Ticker / Symbol broker hỗ trợ |
orderType | integer | Có thể null | Giá trị enum giao dịch |
orderSide | integer | Có thể null | Giá trị enum giao dịch |
qty | decimal string | Có thể null | — |
coinType | integer | Có thể null | Giá trị enum giao dịch |
walletType | integer | Có thể null | Giá trị enum giao dịch |
price | decimal string | Có thể null | — |
marginRate | integer | Có thể null | — |
stopLoss | decimal string | Có thể null | — |
takeProfit | decimal string | Có thể null | — |
marketType | integer | Có thể null | Thị trường hỗ trợ và mã marketType |
brokerId | integer | Có thể null | — |
Điều này cho biết Flutter DTO cho phép null hoặc bỏ qua một số ID tùy chọn; không khẳng định quy tắc kiểm tra phía máy chủ. Hãy xác nhận trường bắt buộc với broker/dịch vụ.
Ví dụ phản hồi
{"code":0,"data":true,"msg":""}Client mong đợi data là kết quả boolean.
Try gửi yêu cầu thật đến môi trường đã chọn và có thể tạo, đóng, hủy hoặc sửa lệnh. Hãy dùng tài khoản thử nghiệm và môi trường thử nghiệm được broker chấp thuận.
Thử yêu cầu REST · /app-api/v1/order/create-order
Nhập Access Token và chỉnh sửa các tham số yêu cầu. Khi gửi, trình duyệt gọi trực tiếp môi trường BFF chính thức của Finger Trader đã chọn.
Try gửi yêu cầu thật đến môi trường đã chọn và có thể tạo, đóng, hủy hoặc sửa lệnh. Hãy dùng tài khoản thử nghiệm và môi trường thử nghiệm được broker chấp thuận.
Sẵn sàng. Chưa gửi gì cho đến khi bạn chọn Gửi yêu cầu.
Phản hồi sẽ hiển thị tại đây.
Access Token chỉ ở trong bộ nhớ của trang này, không lưu trong bộ nhớ trình duyệt hoặc gửi đến máy chủ website Finger Trader. Token chỉ được gửi đến môi trường API chính thức đã chọn sau khi nhấn Gửi yêu cầu.
Đóng lệnh
POST /app-api/v1/order/close-order
Gửi yêu cầu đóng vị thế.
Ví dụ yêu cầu
Các giá trị chỉ để minh họa. Hãy thay ticker, thị trường, mã tài khoản/đơn hàng và mã broker bằng dữ liệu tài khoản của bạn; xác nhận trường bắt buộc với broker trước khi gửi.
{
"userId": "user_demo_12345",
"orderId": "order_demo_20250101_001",
"qty": "500",
"marketType": 0,
"brokerId": 10001,
"brokerPositionId": "position_demo_001",
"symbol": "EURUSD"
}| Tham số | Kiểu | DTO phía ứng dụng | Tham chiếu |
|---|---|---|---|
userId | string | Có thể null | — |
orderId | string | Có thể null | — |
qty | decimal string | Có thể null | — |
marketType | integer | Có thể null | Thị trường hỗ trợ và mã marketType |
brokerId | integer | Có thể null | — |
brokerPositionId | string | Có thể null | — |
symbol | string | Có thể null | Ticker / Symbol broker hỗ trợ |
Điều này cho biết Flutter DTO cho phép null hoặc bỏ qua một số ID tùy chọn; không khẳng định quy tắc kiểm tra phía máy chủ. Hãy xác nhận trường bắt buộc với broker/dịch vụ.
Ví dụ phản hồi
{"code":0,"data":true,"msg":""}Client mong đợi data là kết quả boolean.
Try gửi yêu cầu thật đến môi trường đã chọn và có thể tạo, đóng, hủy hoặc sửa lệnh. Hãy dùng tài khoản thử nghiệm và môi trường thử nghiệm được broker chấp thuận.
Thử yêu cầu REST · /app-api/v1/order/close-order
Nhập Access Token và chỉnh sửa các tham số yêu cầu. Khi gửi, trình duyệt gọi trực tiếp môi trường BFF chính thức của Finger Trader đã chọn.
Try gửi yêu cầu thật đến môi trường đã chọn và có thể tạo, đóng, hủy hoặc sửa lệnh. Hãy dùng tài khoản thử nghiệm và môi trường thử nghiệm được broker chấp thuận.
Sẵn sàng. Chưa gửi gì cho đến khi bạn chọn Gửi yêu cầu.
Phản hồi sẽ hiển thị tại đây.
Access Token chỉ ở trong bộ nhớ của trang này, không lưu trong bộ nhớ trình duyệt hoặc gửi đến máy chủ website Finger Trader. Token chỉ được gửi đến môi trường API chính thức đã chọn sau khi nhấn Gửi yêu cầu.
Hủy lệnh giới hạn
POST /app-api/v1/order/cancel-order
Gửi yêu cầu hủy lệnh giới hạn.
Ví dụ yêu cầu
Các giá trị chỉ để minh họa. Hãy thay ticker, thị trường, mã tài khoản/đơn hàng và mã broker bằng dữ liệu tài khoản của bạn; xác nhận trường bắt buộc với broker trước khi gửi.
{
"userId": "user_demo_12345",
"orderId": "order_demo_20250101_002",
"marketType": 0,
"brokerId": 10001,
"brokerOrderId": "broker_order_demo_002",
"clientOrderId": "client_order_demo_002"
}| Tham số | Kiểu | DTO phía ứng dụng | Tham chiếu |
|---|---|---|---|
userId | string | Có thể null | — |
orderId | string | Có thể null | — |
marketType | integer | Có thể null | Thị trường hỗ trợ và mã marketType |
brokerId | integer | Có thể null | — |
brokerOrderId | string | Có thể null | — |
clientOrderId | string | Có thể null | — |
Điều này cho biết Flutter DTO cho phép null hoặc bỏ qua một số ID tùy chọn; không khẳng định quy tắc kiểm tra phía máy chủ. Hãy xác nhận trường bắt buộc với broker/dịch vụ.
Ví dụ phản hồi
{"code":0,"data":true,"msg":""}Client mong đợi data là kết quả boolean.
Try gửi yêu cầu thật đến môi trường đã chọn và có thể tạo, đóng, hủy hoặc sửa lệnh. Hãy dùng tài khoản thử nghiệm và môi trường thử nghiệm được broker chấp thuận.
Thử yêu cầu REST · /app-api/v1/order/cancel-order
Nhập Access Token và chỉnh sửa các tham số yêu cầu. Khi gửi, trình duyệt gọi trực tiếp môi trường BFF chính thức của Finger Trader đã chọn.
Try gửi yêu cầu thật đến môi trường đã chọn và có thể tạo, đóng, hủy hoặc sửa lệnh. Hãy dùng tài khoản thử nghiệm và môi trường thử nghiệm được broker chấp thuận.
Sẵn sàng. Chưa gửi gì cho đến khi bạn chọn Gửi yêu cầu.
Phản hồi sẽ hiển thị tại đây.
Access Token chỉ ở trong bộ nhớ của trang này, không lưu trong bộ nhớ trình duyệt hoặc gửi đến máy chủ website Finger Trader. Token chỉ được gửi đến môi trường API chính thức đã chọn sau khi nhấn Gửi yêu cầu.
Sửa cắt lỗ / chốt lời
POST /app-api/v1/order/modify-stop-profit-loss
Gửi yêu cầu cập nhật dừng lỗ hoặc chốt lời.
Ví dụ yêu cầu
Các giá trị chỉ để minh họa. Hãy thay ticker, thị trường, mã tài khoản/đơn hàng và mã broker bằng dữ liệu tài khoản của bạn; xác nhận trường bắt buộc với broker trước khi gửi.
{
"userId": "user_demo_12345",
"orderId": "order_demo_20250101_003",
"qty": "1000",
"price": "1.08600",
"stopLose": "1.07600",
"stopProfit": "1.09600",
"clearStopLoss": false,
"clearTakeProfit": false
}| Tham số | Kiểu | DTO phía ứng dụng | Tham chiếu |
|---|---|---|---|
userId | string | Có thể null | — |
orderId | string | Có thể null | — |
qty | decimal string | Có thể null | — |
price | decimal string | Có thể null | — |
stopLose | decimal string | Có thể null | — |
stopProfit | decimal string | Có thể null | — |
clearStopLoss | boolean | Có thể null | — |
clearTakeProfit | boolean | Có thể null | — |
Điều này cho biết Flutter DTO cho phép null hoặc bỏ qua một số ID tùy chọn; không khẳng định quy tắc kiểm tra phía máy chủ. Hãy xác nhận trường bắt buộc với broker/dịch vụ.
Ví dụ phản hồi
{"code":0,"data":true,"msg":""}Client mong đợi data là kết quả boolean.
Try gửi yêu cầu thật đến môi trường đã chọn và có thể tạo, đóng, hủy hoặc sửa lệnh. Hãy dùng tài khoản thử nghiệm và môi trường thử nghiệm được broker chấp thuận.
Thử yêu cầu REST · /app-api/v1/order/modify-stop-profit-loss
Nhập Access Token và chỉnh sửa các tham số yêu cầu. Khi gửi, trình duyệt gọi trực tiếp môi trường BFF chính thức của Finger Trader đã chọn.
Try gửi yêu cầu thật đến môi trường đã chọn và có thể tạo, đóng, hủy hoặc sửa lệnh. Hãy dùng tài khoản thử nghiệm và môi trường thử nghiệm được broker chấp thuận.
Sẵn sàng. Chưa gửi gì cho đến khi bạn chọn Gửi yêu cầu.
Phản hồi sẽ hiển thị tại đây.
Access Token chỉ ở trong bộ nhớ của trang này, không lưu trong bộ nhớ trình duyệt hoặc gửi đến máy chủ website Finger Trader. Token chỉ được gửi đến môi trường API chính thức đã chọn sau khi nhấn Gửi yêu cầu.