Used to instruct the creation of permanent and temporary accounts on behalf of investors associated with the Participant.
There are three possibilities regarding account ownership:
Example of a successful flow:
R1: May be YES only for Brokerage (Target Participant) accounts.
R2: Must be populated if, and only if, this is a trading-on-behalf account (if IsTradingOnBehalf is true).
R3: Must be populated if, and only if, the account is not held by the participant itself (if IsHeldByParticipant is false).
R4: Must be populated if, and only if, the investor is already registered with the participant (if AlreadyExistsIndicator is true). In this case, the account will be associated with the existing investor.
R5: Must be populated if, and only if, the investor is not registered with the participant (if AlreadyExistsIndicator is false). In this case, a new investor will be created.
R6: Only one of these fields will be populated. For example, if the investor type (InvestorType) is "Resident individual", only the resident individual data (ResidentNaturalPerson) will be provided.
R7: Only one of these fields will be populated. For example, if the investor type (InvestorType) is "Resident individual", only the resident individual data (ResidentNaturalPerson) will be provided.
R8: Only one of these fields will be populated. For example, if the investor type (InvestorType) is "Resident individual", only the resident individual data (ResidentNaturalPerson) will be provided.
R9: Only one of these fields will be populated. For example, if the investor type (InvestorType) is "Resident individual", only the resident individual data (ResidentNaturalPerson) will be provided.
R10: Only one of these fields will be populated. For example, if the investor type (InvestorType) is "Resident individual", only the resident individual data (ResidentNaturalPerson) will be provided.
R11: Country code in the ISO 3166-1 alpha-2 standard. E.g.: "BR", "US", "UK".
R12: There are two possibilities regarding the "code 88", "CVM code", and "CNPJ" fields:
Possibility 1: The investor has only a code 88 (Code88).
Possibility 2: The investor has only a CVM code and CNPJ (CodeCvm and Cnpj).
ROB1: Will be populated when the account uses an open trading-on-behalf arrangement (IsOpenTradingOnBehalf = true).
| Index | Field | Type | Required | Description | Rules |
|---|---|---|---|---|---|
| 1 | ParticipantRequestInfo | object | YES | Request information | |
| 1.1 | RequestId | string | YES | Unique request identifier assigned by the participant | |
| 1.2 | RequesterParticipantCode | string | YES | Requesting participant code | |
| 1.3 | OriginalMessageTypeCode | string | NO | Original message type in the base-m-cad-???-##-### pattern |
|
| 2 | OwnerCode | string | YES | Code of the participant that owns the account | |
| 3 | Code | string | YES | Account code | |
| 4 | Type | integer | YES | Account type Possible values: PositionAccountType |
|
| 5 | IsHeldByParticipant | bool | YES | Indicates whether the account is held by the participant itself | R1 |
| 6 | IsCollateralizedByParticipant | bool | YES | Indicates whether the account is collateralized by the participant | |
| 7 | IsTradingOnBehalf | bool | YES | Indicates whether this is a trading-on-behalf account | R2 |
| 8 | TradingOnBehalfInformation | object | NO | Information specific to trading-on-behalf accounts | |
| 8.1 | CounterpartyParticipantCode | string | YES | Counterparty participant code in the trading-on-behalf arrangement | |
| 8.2 | CounterpartyAccountCode | string | YES | Counterparty account code in the trading-on-behalf arrangement | |
| 8.3 | IsOpenTradingOnBehalf | bool | YES | Indicates whether the account uses an open trading-on-behalf arrangement | |
| 8.4 | OpenTradingOnBehalfParticipantCode | string | NO | Open trading-on-behalf participant code | ROB1 |
| 9 | IsEligibleForEarlySettlement | bool | YES | Indicates whether the account is eligible for optional early settlement (LAF) | |
| 10 | AllowedMarkets | array | YES | List of enabled markets | |
| 10.1 | Market | integer | YES | Market Possible values: MarketCode |
|
| 11 | InvestorInformation | object | NO | Investor information | R3 |
| 11.1 | AlreadyExistsIndicator | bool | YES | Indicates whether the investor is already registered under the participant | |
| 11.2 | ExistingDocument | string | NO | Investor document identifier when the investor already exists | R4 |
| 11.3 | Investor | object | NO | New investor information | R5 |
| 11.3.1 | InvestorType | integer | YES | Investor type Possible values: InvestorType |
|
| 11.3.2 | RegistrationRestriction | integer | NO | Registration restriction Possible values: RegistrationRestriction |
|
| 11.3.3 | ResidentNaturalPerson | object | NO | Resident individual information | R6 |
| 11.3.3.1 | FullName | string | YES | Full name | |
| 11.3.3.2 | BirthDate | string | YES | Date of birth | |
| 11.3.3.3 | Cpf | string | YES | CPF | |
| 11.3.3.4 | Address | object | YES | Address | |
| 11.3.3.4.1 | PostalCode | string | YES | Postal code | |
| 11.3.3.4.2 | Street | string | YES | Street (street, avenue) | |
| 11.3.3.4.3 | Number | string | NO | Number | |
| 11.3.3.4.4 | Extra | string | NO | Additional address information (apartment, block, unit, etc.) | |
| 11.3.3.4.5 | City | string | YES | City | |
| 11.3.3.4.6 | State | string | YES | State abbreviation (SP, RJ, DF, etc.) | |
| 11.3.3.5 | Phone | string | YES | Phone number | |
| 11.3.3.6 | EmailAddress | string | YES | Email address | |
| 11.3.3.7 | AnnualIncome | decimal | YES | Annual income | |
| 11.3.3.8 | AnnualIncomeReferenceDate | string | YES | Annual income reference date | |
| 11.3.3.9 | NetWorth | decimal | YES | Net worth | |
| 11.3.3.10 | NetWorthReferenceDate | string | YES | Net worth reference date | |
| 11.3.3.11 | IsPoliticallyExposed | bool | YES | Indicates whether the investor is a politically exposed person | |
| 11.3.3.12 | Occupation | integer | YES | Occupation | |
| 11.3.3.13 | PreferredName | string | NO | Preferred name | |
| 11.3.3.14 | RegistrationRestriction | integer | NO | Registration restriction Possible values: RegistrationRestriction |
|
| 11.3.4 | NonResidentNaturalPerson | object | NO | Non-resident individual information | R7 |
| 11.3.4.1 | FullName | string | YES | Full name | |
| 11.3.4.2 | Cpf | string | YES | CPF | |
| 11.3.4.3 | CountryOfResidence | string | YES | Country of residence | R11 |
| 11.3.4.4 | CountryOfRegistrationFiscalNumber | string | NO | Tax identification number in the country of registration | |
| 11.3.4.5 | RegistrationRestriction | integer | NO | Registration restriction Possible values: RegistrationRestriction |
|
| 11.3.5 | NationalInvestmentFund | object | NO | Domestic investment fund information | R8 |
| 11.3.5.1 | FullName | string | YES | Legal name | |
| 11.3.5.2 | Cnpj | string | YES | CNPJ | |
| 11.3.5.3 | IsExclusiveFund | bool | YES | Indicates whether the fund is exclusive | |
| 11.3.5.4 | RegistrationRestriction | integer | NO | Registration restriction Possible values: RegistrationRestriction |
|
| 11.3.6 | NationalLegalPerson | object | NO | Domestic legal entity information | R9 |
| 11.3.6.1 | FullName | string | YES | Legal name | |
| 11.3.6.2 | Cnpj | string | YES | CNPJ | |
| 11.3.6.3 | Address | object | YES | Address | |
| 11.3.6.3.1 | PostalCode | string | YES | Postal code | |
| 11.3.6.3.2 | Street | string | YES | Street (street, avenue) | |
| 11.3.6.3.3 | Number | string | NO | Number | |
| 11.3.6.3.4 | Extra | string | NO | Additional address information (apartment, block, unit, etc.) | |
| 11.3.6.3.5 | City | string | YES | City | |
| 11.3.6.3.6 | State | string | YES | State abbreviation (SP, RJ, DF, etc.) | |
| 11.3.6.4 | Phone | string | YES | Phone number | |
| 11.3.6.5 | EmailAddress | string | YES | Email address | |
| 11.3.6.6 | PrimaryEconomicActivity | integer | YES | Primary economic activity | |
| 11.3.6.7 | IsNonProfit | bool | YES | Indicates whether the entity is nonprofit | |
| 11.3.6.8 | RegistrationRestriction | integer | NO | Registration restriction Possible values: RegistrationRestriction |
|
| 11.3.7 | ForeignLegalPerson | object | NO | Foreign legal entity information | R10 |
| 11.3.7.1 | FullName | string | YES | Legal name | |
| 11.3.7.2 | IsNonProfit | bool | YES | Indicates whether the entity is nonprofit | |
| 11.3.7.3 | IsTrustOrEquivalent | bool | YES | Indicates whether the entity is a trust or equivalent structure | |
| 11.3.7.4 | CountryOfRegistration | string | YES | Country of registration | R11 |
| 11.3.7.5 | CodeCvm | string | NO | CVM code | R12 |
| 11.3.7.6 | Cnpj | string | NO | CNPJ | R12 |
| 11.3.7.7 | Code88 | string | NO | Code 88 | R12 |
| 11.3.7.8 | CountryOfRegistrationFiscalNumber | string | NO | Tax identification number in the country of registration | |
| 11.3.7.9 | RepresentativeName | string | NO | Name of the legal representative in Brazil | |
| 11.3.7.10 | RepresentativeCnpj | string | NO | CNPJ of the legal representative in Brazil | |
| 11.3.7.11 | RegistrationRestriction | integer | NO | Registration restriction Possible values: RegistrationRestriction |
{
"ParticipantRequestInfo": {
"RequestId": "E22FCABBA8FB41A096F9AF4088FD9B4C",
"RequesterParticipantCode": "33"
},
"OwnerCode": "713",
"Code": "1001",
"Type": 1,
"IsHeldByParticipant": false,
"IsCollateralizedByParticipant": false,
"IsTradingOnBehalf": false,
"IsEligibleForEarlySettlement": true,
"AllowedMarkets": [
{
"Market": 101
},
{
"Market": 111
}
],
"InvestorInformation": {
"AlreadyExistsIndicator": false,
"Investor": {
"InvestorType": 1,
"ResidentNaturalPerson": {
"FullName": "Jos\u00E9 da Silva Santos",
"BirthDate": "1985-06-17",
"Cpf": "12345678909",
"Address": {
"PostalCode": "12345678",
"Street": "Rua Exemplo",
"Number": "456",
"Extra": "Apto 101",
"City": "Belo Horizonte",
"State": "MG"
},
"Phone": "31998765432",
"EmailAddress": "jose.silva@example.com",
"AnnualIncome": 180000.00,
"AnnualIncomeReferenceDate": "2026-04-15",
"NetWorth": 950000.00,
"NetWorthReferenceDate": "2026-04-15",
"IsPoliticallyExposed": false,
"Occupation": 213
}
}
}
}