FINGER TRADER

brokerageDocsPage.orders

API quản lý lệnh

API phía broker để truy vấn vị thế và lịch sử lệnh của khách hàng, danh sách lệnh thị trường và các thao tác được cấp quyền.

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

Xác thực và quyền truy cập

Các giao diện này yêu cầu phiên nhân viên broker/merchant đã xác thực và quyền backend tương ứng. Token của người dùng cuối ứng dụng giao dịch thông thường không dùng được. Hãy xác nhận quyền với quản trị viên broker.

Gửi yêu cầu POST JSON đến môi trường Merchant BFF đã chọn. Finger Admin gửi Access Token của nhân viên broker đã đăng nhập trong header Authorization theo dạng Bearer.

https://dev-api.fingertrading.com/finger-bff-merchant
Authorization: Bearer <BROKER_STAFF_ACCESS_TOKEN>

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

API trong mục này

Order pool, customer positions and history, grouped history, export, and order action endpoints used by Finger Admin.

Market order pool

Queries the market order pool using MarketQueryDTO.

POST/mer-api/v1/order/market-order-list

Ví dụ yêu cầu

{
  "marketType": 0
}

Trường yêu cầu

marketTypenumber

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/order/market-order-list

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Market ticker/order data

Paged market data list; TickerListQueryDTO filters by marketType.

POST/mer-api/v1/order/market-data-list

Ví dụ yêu cầu

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "marketType": 0
  }
}

Trường yêu cầu

pagenumber
pageSizenumber
queryobject

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/order/market-data-list

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Customer open positions

Paged customer holdings query.

POST/mer-api/v1/order/get-user-order-holding-list

Ví dụ yêu cầu

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

Trường yêu cầu

pagenumber
pageSizenumber
queryobject

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/order/get-user-order-holding-list

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Customer order history

Paged order history for a customer or broker query.

POST/mer-api/v1/order/get-user-order-history-list

Ví dụ yêu cầu

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

Trường yêu cầu

pagenumber
pageSizenumber
queryobject

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/order/get-user-order-history-list

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Grouped customer order history

Paged grouped history query.

POST/mer-api/v1/order/get-user-order-history-grouped-list

Ví dụ yêu cầu

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

Trường yêu cầu

pagenumber
pageSizenumber
queryobject

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/order/get-user-order-history-grouped-list

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Customer order history statistics

Aggregate history statistics using OrderListQueryWithUserDTO.

POST/mer-api/v1/order/get-user-order-history-stat

Ví dụ yêu cầu

{
  "brokerNumber": "",
  "userName": "",
  "userNumber": "",
  "timezone": "UTC",
  "marketType": 0,
  "orderType": 0,
  "coinType": 0,
  "orderSide": 0,
  "startTime": "",
  "endTime": ""
}

Trường yêu cầu

brokerNumberstring
userNamestring
userNumberstring
timezonestring
marketTypenumber
orderTypenumber
coinTypenumber
orderSidenumber
startTimestring
endTimestring

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "total": 0,
    "buyCount": 0,
    "sellCount": 0
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/order/get-user-order-history-stat

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Broker order history

Paged broker order history query.

POST/mer-api/v1/order/get-broker-order-history-list

Ví dụ yêu cầu

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

Trường yêu cầu

pagenumber
pageSizenumber
queryobject

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/order/get-broker-order-history-list

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Close order

Closes the order identified by IDDTO.

POST/mer-api/v1/order/close-order

Ví dụ yêu cầu

{
  "id": "demo-record-id"
}

Trường yêu cầu

idstring

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/order/close-order

Endpoint này thay đổi dữ liệu broker hoặc trạng thái lệnh. Try gửi yêu cầu thật, không phải mô phỏng. Chỉ dùng tài khoản và môi trường kiểm thử được phê duyệt.

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.