查询虚拟账户列表
GET
分页查询 MSO 的所有已开通虚拟账户。
bearerAuthheader
鉴权Bearer <令牌>通过 POST /oauth2/token 获取的 access_token。请求头格式为 Authorization: Bearer {accessToken}。
masterAccountNo?string主账户号(精确匹配)。长度 32
virtualAccountNo?string虚拟账户号(精确匹配)。长度 32
accountHolderName?string账户持有人名称(模糊搜索)。长度 128
currency?string币种。长度 32
status?string账户状态
可选值
"ACTIVE""INACTIVE""CLOSED"pageNum?integer当前页码,默认 1
范围
1 <= value默认值
1pageSize?integer每页记录数,默认 10,最大 1000
范围
1 <= value <= 1000默认值
10X-Channel-Provider?string渠道提供商标识,如 GLDB。不传时默认 GLDB
默认值
"GLDB"分页返回虚拟账户。
application/json- response
code?integer业务状态码
message?stringtraceId?string请求追踪 ID。联系技术支持时请提供
data?curl -X GET 'https://api.test.stabofx.com/openapi/v1/wallet/virtual-accounts'响应示例
{ "code": 200, "message": "OK", "traceId": "a1b2c3d4-e5f6-7890", "data": { "total": 50, "pages": 3, "size": 20, "current": 1, "records": [ { "virtualAccountNo": "1000000001", "accountHolderName": "Example Trading Pte Ltd", "masterAccountNo": "1000000000", "currency": "SGD", "status": "ACTIVE", "contactName": "Example Contact", "contactEmail": "contact@example.com", "contactPhone": "+6500000000", "bankReference": "REF-EXAMPLE-001", "openedAt": "2025-12-02T10:15:20", "createdAt": "2025-12-01T15:30:45", "updatedAt": "2025-12-02T10:15:20" } ] }}