brokerageDocsPage.riskControl
API kiểm soát rủi ro
Các giao diện console broker dùng để xem lệnh thị trường và vị thế khách hàng, liên kết với cấu hình giao dịch.
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.
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
Broker-side risk workflows combine customer order and position queries with controls configured under Trading configuration.
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.
Market ticker/order data
Paged market data list; TickerListQueryDTO filters by marketType.
/mer-api/v1/order/market-data-listVí dụ yêu cầu
{
"page": 1,
"pageSize": 20,
"query": {
"marketType": 0
}
}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/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.
/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.
Close order
Closes the order identified by IDDTO.
/mer-api/v1/order/close-orderVí dụ yêu cầu
{
"id": "demo-record-id"
}Trường yêu cầu
idstringVí 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.
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.
Set user matching configuration
Updates the user matching configuration.
/mer-api/v1/trade/user-match-config-setVí dụ yêu cầu
{
"marketType": 0,
"userId": "demo-user-id",
"value": {
"status": 1,
"orderSide": 0,
"rate": 1,
"followOrderFirst": false
}
}Trường yêu cầu
marketTypenumberuserIdstringvalueobjectVí 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/trade/user-match-config-set
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.