FINGER TRADER

Tài liệu API broker

Tài liệu API broker

Các trang này nhóm giao diện /mer-api/v1 được Finger Admin dùng trong quy trình khách hàng, lệnh và kiểm soát rủi ro. Merchant BFF cung cấp các API; khả năng truy cập phụ thuộc tài khoản broker và quyền được cấp.

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

Tài liệu API broker

Các trang này nhóm giao diện /mer-api/v1 được Finger Admin dùng trong quy trình khách hàng, lệnh và kiểm soát rủi ro. Merchant BFF cung cấp các API; khả năng truy cập phụ thuộc tài khoản broker và quyền được 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.

Base URL và xác thực Merchant BFF

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>

Duyệt theo nhóm API

Customer list

Paged customer search; query keys are based on UserQueryDTO.

POST/mer-api/v1/customer/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/customer/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 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.

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.

User matching configuration

Reads the matching configuration for a market/user context.

POST/mer-api/v1/trade/user-match-config

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": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/trade/user-match-config

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.