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ê.
Đ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
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.
Vị thế đang mở
POST /app-api/v1/order/get-holding-orders
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ố | Kiểu | DTO phía ứng dụng | Tham chiếu |
|---|---|---|---|
page | integer | Bắt buộc theo mô hình client | — |
pageSize | integer | Bắt buộc theo mô hình client | — |
query | object | Bắt buộc theo mô hình client | — |
query.nextCursor | string | null | Có thể null | — |
query.brokerId | integer | null | Có thể null | — |
query.walletType | integer | null | Có thể null | Giá trị enum giao dịch |
query.marketType | integer | null | Có thể null | Thị trường hỗ trợ và mã marketType |
query.orderType | integer | null | Có thể null | Giá trị enum giao dịch |
query.coinType | integer | null | Có thể null | Giá trị enum giao dịch |
query.orderSide | integer | null | Có thể null | Giá trị enum giao dịch |
query.startTime | integer | null | Có thể null | — |
query.endTime | integer | null | 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":{"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 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
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ố | Kiểu | DTO phía ứng dụng | Tham chiếu |
|---|---|---|---|
page | integer | Bắt buộc theo mô hình client | — |
pageSize | integer | Bắt buộc theo mô hình client | — |
query | object | Bắt buộc theo mô hình client | — |
query.nextCursor | string | null | Có thể null | — |
query.brokerId | integer | null | Có thể null | — |
query.walletType | integer | null | Có thể null | Giá trị enum giao dịch |
query.marketType | integer | null | Có thể null | Thị trường hỗ trợ và mã marketType |
query.orderType | integer | null | Có thể null | Giá trị enum giao dịch |
query.coinType | integer | null | Có thể null | Giá trị enum giao dịch |
query.orderSide | integer | null | Có thể null | Giá trị enum giao dịch |
query.startTime | integer | null | Có thể null | — |
query.endTime | integer | null | 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":{"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 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
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ố | Kiểu | DTO phía ứng dụng | Tham chiếu |
|---|---|---|---|
page | integer | Bắt buộc theo mô hình client | — |
pageSize | integer | Bắt buộc theo mô hình client | — |
query | object | Bắt buộc theo mô hình client | — |
query.nextCursor | string | null | Có thể null | — |
query.brokerId | integer | null | Có thể null | — |
query.walletType | integer | null | Có thể null | Giá trị enum giao dịch |
query.marketType | integer | null | Có thể null | Thị trường hỗ trợ và mã marketType |
query.orderType | integer | null | Có thể null | Giá trị enum giao dịch |
query.coinType | integer | null | Có thể null | Giá trị enum giao dịch |
query.orderSide | integer | null | Có thể null | Giá trị enum giao dịch |
query.startTime | integer | null | Có thể null | — |
query.endTime | integer | null | 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":{"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 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
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ố | Kiểu | DTO phía ứng dụng | Tham chiếu |
|---|---|---|---|
query.nextCursor | string | null | Có thể null | — |
query.brokerId | integer | null | Có thể null | — |
query.walletType | integer | null | Có thể null | Giá trị enum giao dịch |
query.marketType | integer | null | Có thể null | Thị trường hỗ trợ và mã marketType |
query.orderType | integer | null | Có thể null | Giá trị enum giao dịch |
query.coinType | integer | null | Có thể null | Giá trị enum giao dịch |
query.orderSide | integer | null | Có thể null | Giá trị enum giao dịch |
query.startTime | integer | null | Có thể null | — |
query.endTime | integer | null | Có 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 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.