GuidesAPI Reference
Log In
Guides

Creating Accounts

Your customer will need both a Client and an Account before they can begin trading. Creating these entities and
understanding their function are core to using our platform.

The Client / Account Relationship

A Client represents a real person - your customer - and serves as a repository for information about that person. In its most basic form, creating a Client only requires an email address and some personal information. However, you can attach much more information to the Client, like:

  • Customer Profile Data: Basic personal information used to identify and differentiate a customer (e.g., full name, date of birth, contact details, nationality, and tax identifiers).
  • Signed Acknowledgements and Agreements: Any Agreements and Acknowledgements required to open an Account.
  • Customer Verification Documents: Documents that prove the identity of the customer.
  • Prior Investing Experience: Information describing the experience level of the customer with investing given assets.
📘

Adding more information

You can technically provide more information than is necessary to open an Account. However, please consider a balance between business needs and data controls & privacy. If requirements change in the future, and more information becomes necessary, you will be notified in advance. You will be able to send more data at that time.

The Client information is used later during the Account opening process. Accounts hold a Client's assets, and it's through Accounts that trading can occur. After creating a Client, you must open at least one Account for that Client to begin trading, but Clients can have more than one Account.

Creating a Client

To create a Client, you make a POST a request to the Create Client endpoint. The Create Client endpoint optionally allows you to provide the data required to open an Account in the same payload. If you cannot or do not wish to provide all the required data when creating a client, you can PATCH the endpoint later with the more information.

Investor Suitability Questionnaire

Some of the data associated with a client encompasses what is called the "Suitability Questionnaire". As part of opening an Investment Account, Clients are required to provide answer to questions pertaining to their suitability to open said account. This includes prior investing experience, current asset holdings, and employment information.

While we are required to have this data for any Investment Account we open, the answers given don't generally prevent a Client from opening an Investment Account.

Properties on the Client that pertain to the Suitability Questionnaire are:

  • experienceInformation
  • employerInformation
  • financialInformation
  • associationInformation
⚠️

Account Restrictions

While suitability questions don't preclude an account from being opened, some answers can cause an account to open in a restricted status. See Accounts and Suitability for more information.

Opening an Investment Account

Accounts can be opened via the Create Account endpoint. If enough data is available on the Client to satisfy all necessary requirements (we cover this below in [Account Entitlements](), the Account will be opened, and you will receive data about the Account in the body of the response. Otherwise, you'll receive an error message detailing what requirements are missing.

Account Entitlements

When opening the Account, you must specify the Entitlement(s) for that Account. Entitlements designate the asset class(es) the Account can trade in. For an Account to open, at least one Entitlement must be specified, and once open Entitlements cannot be changed for the Account.

Entitlements drive what data is required for a Client to open an account. Different asset classes can require more - or less - data prior to open. The table below outlines the information section on the Client necessary for each asset class type:

EntitlementEVENT_CONTRACTS
contactInformation
personalInformation
workInformation
experienceInformation
employerInformation
financialInformation
agreementsInformation⚠️ Specific Agreements are required.
associationInformation

Agreements and Disclosures

Access to a given Entitlement is in part based on whether a Client has seen and signed certain Agreements and Disclosures. Agreements are documents that signify an agreement to abide by the contents of the document. Disclosures are documents that inform the Client of things they should be aware of while using this platform. Agreements generally require an e-signature, while Disclosures generally require an acknowledgement - a simple yes or no. However, some Disclosures may require signatures.

The Agreements and Disclosures required for a given Entitlement are outline below:

📘
Table Key
  • ✅: Must be acknowledged for this Entitlement.
  • 🖊️: Must be e-signed for this entitlement
  • Empty: Not required for this entitlement
Disclosure / AgreementEVENT_CONTRACTS
// TBD// TBD


Did this page help you?