2.1. Lấy thông tin tiểu khoản

GET/eros/v2/get-profile/by-username/{custodyCode}
Lấy thông tin hồ sơ của một tài khoản lưu ký theo danh sách trường yêu cầu.

Header

TênKiểuBắt buộcMô tả
AuthorizationstringBearer <access token>.
Content-Typestringapplication/json.

Path variable

TênKiểuBắt buộcMô tả
custodyCodestringSố tài khoản lưu ký, ví dụ: 105C334455.

Request parameter

TênKiểuBắt buộcMô tả
fieldsstringDanh sách thông tin cần lấy, ví dụ: basicInfo,bankSubAccounts.
GET /eros/v2/get-profile/by-username/105C334455
curl "https://openapi.tcbs.com.vn/eros/v2/get-profile/by-username/105C334455?fields=basicInfo,bankSubAccounts" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"

Response

TênKiểuBắt buộcMô tả
basicInfoobjectThông tin cơ bản tài khoản.
bankSubAccountsarrayDanh sách tiểu khoản.
bankSubAccounts[].accountNostringSố tiểu khoản.
bankSubAccounts[].accountNamestringTên chủ tài khoản.
bankSubAccounts[].bankCodestringMã ngân hàng (có thể null).
bankSubAccounts[].accountTypestringLoại tiểu khoản: NORMAL, MARGIN, DERIVATIVE.
bankSubAccounts[].accountTypeNamestringTên loại tiểu khoản.
bankSubAccounts[].statusstringTrạng thái tiểu khoản.
bankSubAccounts[].isDefaultstringLà tiểu khoản mặc định (Y/N).
{
  "basicInfo": {
    "custodyCode": "105C334455",
    "fullName": "NGUYEN VAN A",
    "status": "ACTIVE"
  },
  "bankSubAccounts": [
    {
      "accountNo": "0001K36265",
      "accountName": "Khuynh Thanh Chi Luyen",
      "bankCode": null,
      "accountType": "NORMAL",
      "accountTypeName": "Thường",
      "status": "1",
      "isDefault": "N"
    },
    {
      "accountNo": "0001G75216",
      "accountName": "Khuynh Thanh Chi Luyen",
      "bankCode": null,
      "accountType": "MARGIN",
      "accountTypeName": "Ký quỹ",
      "status": "1",
      "isDefault": "N"
    },
    {
      "accountNo": "105C738764A",
      "accountName": "Khuynh Thanh Chi Luyen",
      "bankCode": "105C738764A",
      "accountType": "DERIVATIVE",
      "accountTypeName": "Phái sinh",
      "status": "1",
      "isDefault": "N"
    }
  ]
}