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.
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.
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.
Authorization: Bearer <BROKER_STAFF_ACCESS_TOKEN>
Duyệt theo nhóm API
Customer list
Paged customer search; query keys are based on UserQueryDTO.
/mer-api/v1/customer/listVí dụ yêu cầu
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}Trường yêu cầu
pagenumberpageSizenumberqueryobjectVí 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.
/mer-api/v1/order/market-order-listVí dụ yêu cầu
{
"marketType": 0
}Trường yêu cầu
marketTypenumberVí 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.
/mer-api/v1/order/get-user-order-holding-listVí dụ yêu cầu
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}Trường yêu cầu
pagenumberpageSizenumberqueryobjectVí 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.
/mer-api/v1/trade/user-match-configVí dụ yêu cầu
{
"marketType": 0
}Trường yêu cầu
marketTypenumberVí 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.