FINGER TRADER

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.

Khung tài liệu · Tổng quan

Đ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

Base URL App BFF môi trường productionhttps://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

POST

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ố yêu cầu
Tham sốKiểuDTO phía ứng dụngTham chiếu
tickerstringCó thể nullTicker / Symbol broker hỗ trợ
orderTypeintegerCó thể nullGiá trị enum giao dịch
orderSideintegerCó thể nullGiá trị enum giao dịch
qtydecimal stringCó thể null—
coinTypeintegerCó thể nullGiá trị enum giao dịch
walletTypeintegerCó thể nullGiá trị enum giao dịch
pricedecimal stringCó thể null—
marginRateintegerCó thể null—
stopLossdecimal stringCó thể null—
takeProfitdecimal stringCó thể null—
marketTypeintegerCó thể nullThị trường hỗ trợ và mã marketType
brokerIdintegerCó 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
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

POST

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ố yêu cầu
Tham sốKiểuDTO phía ứng dụngTham chiếu
userIdstringCó thể null—
orderIdstringCó thể null—
qtydecimal stringCó thể null—
marketTypeintegerCó thể nullThị trường hỗ trợ và mã marketType
brokerIdintegerCó thể null—
brokerPositionIdstringCó thể null—
symbolstringCó thể nullTicker / 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
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

POST

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ố yêu cầu
Tham sốKiểuDTO phía ứng dụngTham chiếu
userIdstringCó thể null—
orderIdstringCó thể null—
marketTypeintegerCó thể nullThị trường hỗ trợ và mã marketType
brokerIdintegerCó thể null—
brokerOrderIdstringCó thể null—
clientOrderIdstringCó 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
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

POST

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ố yêu cầu
Tham sốKiểuDTO phía ứng dụngTham chiếu
userIdstringCó thể null—
orderIdstringCó thể null—
qtydecimal stringCó thể null—
pricedecimal stringCó thể null—
stopLosedecimal stringCó thể null—
stopProfitdecimal stringCó thể null—
clearStopLossbooleanCó thể null—
clearTakeProfitbooleanCó 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
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.