FINGER TRADER

tradingOrdersDocsPage.orders

API tra cứu lệnh

Dùng API giao dịch đã xác thực để tra cứu vị thế đang mở, lịch sử giao dịch, lệnh đã hoàn tất và thống kê.

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

Điểm cuối tra cứu lệnh

Yêu cầu danh sách dùng page, pageSize và đối tượng query lồng nhau. Phản hồi gồm items và thông tin phân trang. Bộ lọc và dữ liệu sẵn có phụ thuộc cấu hình broker và dịch vụ.

Mô hình PageQuery của client yêu cầu page và pageSize; bộ lọc query có thể null. Kích thước trang tối đa và cách hoạt động của cursor do dịch vụ cấu hình.

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.

Vị thế đang mở

POST /app-api/v1/order/get-holding-orders

POST

Trả về trang vị thế đang mở của tài khoả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.

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "walletType": 2,
    "marketType": 0,
    "orderType": 1,
    "coinType": 0,
    "orderSide": 1,
    "startTime": 1735689600000,
    "endTime": 1735776000000
  }
}
Tham số yêu cầu
Tham sốKiểuDTO phía ứng dụngTham chiếu
pageintegerBắt buộc theo mô hình client—
pageSizeintegerBắt buộc theo mô hình client—
queryobjectBắt buộc theo mô hình client—
query.nextCursorstring | nullCó thể null—
query.brokerIdinteger | nullCó thể null—
query.walletTypeinteger | nullCó thể nullGiá trị enum giao dịch
query.marketTypeinteger | nullCó thể nullThị trường hỗ trợ và mã marketType
query.orderTypeinteger | nullCó thể nullGiá trị enum giao dịch
query.coinTypeinteger | nullCó thể nullGiá trị enum giao dịch
query.orderSideinteger | nullCó thể nullGiá trị enum giao dịch
query.startTimeinteger | nullCó thể null—
query.endTimeinteger | nullCó 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":{"total":1,"items":[{
  "ticker": "<broker-supported ticker>",
  "orderId": "<order id>",
  "marketType": 0,
  "orderType": 0,
  "orderSide": 1,
  "qty": "<decimal>",
  "price": "<decimal>",
  "status": "<broker response status>",
  "filledQuantity": "<decimal>",
  "averagePrice": "<decimal>",
  "createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}

data là kết quả phân trang gồm total, items, page, pageSize và nextCursor. Mỗi mục lệnh có thể chứa giá trị null và trường của broker.

Thử yêu cầu REST · /app-api/v1/order/get-holding-orders

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.

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.

Lịch sử giao dịch

POST /app-api/v1/order/trade-history

POST

Trả về trang lịch sử giao dịch của tài khoả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.

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "walletType": 2,
    "marketType": 0,
    "orderType": 1,
    "coinType": 0,
    "orderSide": 1,
    "startTime": 1735689600000,
    "endTime": 1735776000000
  }
}
Tham số yêu cầu
Tham sốKiểuDTO phía ứng dụngTham chiếu
pageintegerBắt buộc theo mô hình client—
pageSizeintegerBắt buộc theo mô hình client—
queryobjectBắt buộc theo mô hình client—
query.nextCursorstring | nullCó thể null—
query.brokerIdinteger | nullCó thể null—
query.walletTypeinteger | nullCó thể nullGiá trị enum giao dịch
query.marketTypeinteger | nullCó thể nullThị trường hỗ trợ và mã marketType
query.orderTypeinteger | nullCó thể nullGiá trị enum giao dịch
query.coinTypeinteger | nullCó thể nullGiá trị enum giao dịch
query.orderSideinteger | nullCó thể nullGiá trị enum giao dịch
query.startTimeinteger | nullCó thể null—
query.endTimeinteger | nullCó 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":{"total":1,"items":[{
  "ticker": "<broker-supported ticker>",
  "orderId": "<order id>",
  "marketType": 0,
  "orderType": 0,
  "orderSide": 1,
  "qty": "<decimal>",
  "price": "<decimal>",
  "status": "<broker response status>",
  "filledQuantity": "<decimal>",
  "averagePrice": "<decimal>",
  "createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}

data là kết quả phân trang gồm total, items, page, pageSize và nextCursor. Mỗi mục lệnh có thể chứa giá trị null và trường của broker.

Thử yêu cầu REST · /app-api/v1/order/trade-history

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.

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.

Lệnh đã hoàn tất

POST /app-api/v1/order/completed-orders

POST

Trả về trang lệnh đã hoàn tất của tài khoả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.

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "walletType": 2,
    "marketType": 0,
    "orderType": 1,
    "coinType": 0,
    "orderSide": 1,
    "startTime": 1735689600000,
    "endTime": 1735776000000
  }
}
Tham số yêu cầu
Tham sốKiểuDTO phía ứng dụngTham chiếu
pageintegerBắt buộc theo mô hình client—
pageSizeintegerBắt buộc theo mô hình client—
queryobjectBắt buộc theo mô hình client—
query.nextCursorstring | nullCó thể null—
query.brokerIdinteger | nullCó thể null—
query.walletTypeinteger | nullCó thể nullGiá trị enum giao dịch
query.marketTypeinteger | nullCó thể nullThị trường hỗ trợ và mã marketType
query.orderTypeinteger | nullCó thể nullGiá trị enum giao dịch
query.coinTypeinteger | nullCó thể nullGiá trị enum giao dịch
query.orderSideinteger | nullCó thể nullGiá trị enum giao dịch
query.startTimeinteger | nullCó thể null—
query.endTimeinteger | nullCó 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":{"total":1,"items":[{
  "ticker": "<broker-supported ticker>",
  "orderId": "<order id>",
  "marketType": 0,
  "orderType": 0,
  "orderSide": 1,
  "qty": "<decimal>",
  "price": "<decimal>",
  "status": "<broker response status>",
  "filledQuantity": "<decimal>",
  "averagePrice": "<decimal>",
  "createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}

data là kết quả phân trang gồm total, items, page, pageSize và nextCursor. Mỗi mục lệnh có thể chứa giá trị null và trường của broker.

Thử yêu cầu REST · /app-api/v1/order/completed-orders

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.

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.

Thống kê lịch sử giao dịch

POST /app-api/v1/order/trade-history-stat

POST

Trả về đối tượng thống kê lịch sử giao dịch.

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.

{
  "walletType": 2,
  "marketType": 0,
  "orderType": 1,
  "coinType": 0,
  "orderSide": 1,
  "startTime": 1735689600000,
  "endTime": 1735776000000
}
Tham số yêu cầu
Tham sốKiểuDTO phía ứng dụngTham chiếu
query.nextCursorstring | nullCó thể null—
query.brokerIdinteger | nullCó thể null—
query.walletTypeinteger | nullCó thể nullGiá trị enum giao dịch
query.marketTypeinteger | nullCó thể nullThị trường hỗ trợ và mã marketType
query.orderTypeinteger | nullCó thể nullGiá trị enum giao dịch
query.coinTypeinteger | nullCó thể nullGiá trị enum giao dịch
query.orderSideinteger | nullCó thể nullGiá trị enum giao dịch
query.startTimeinteger | nullCó thể null—
query.endTimeinteger | nullCó thể null—

Flutter client tuần tự hóa startTime và endTime thành Unix timestamp UTC theo mili giây.

Đ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":{"totalProfile":"<decimal>"},"msg":""}

Khi dịch vụ trả về, đối tượng data có totalProfile.

Thử yêu cầu REST · /app-api/v1/order/trade-history-stat

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.

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.