Creating investor

How to add an investor record?

What is an investor?

Investors API

An investor represents someone who can purchase and hold tokens of your assets. Our platform is designed to work without storing investor personal data, so an investor record primarily serves as an ID link to your existing customer systems where you maintain detailed information.

Investors can:

• Purchase assets on the primary market during distribution

• Trade assets on secondary markets (if supported by your asset structure)

How is an investor defined?

The main properties of the investor include:

Property	Meaning	Example
Display name	Optional reference name (avoid personal data)	"Investor #123"
Country	ISO Code of the investor's country (registration or residency)	"GB"
External reference	Your system's identifier for easier reference	<any sort of ID used in customer's system>
Contract number	Optional field for storing contract numbers when permanent contractual relationships exist	"213FGADC"
Verified	Whether investor has completed verification requirements and is authorized to participate in investments	"True"

Personal data

Our platform doesn't require investor personal data to function, and we recommend avoiding it. The display_name field isn't designed for real names, though you can use abbreviations like "J.J. Doe" or "Customer DE 12334" if needed.

Personal data remains important for your issuer processes:

• Regulatory compliance (KYC, sanctions screening, qualifications)

• Investor registry generation (cap tables)

You maintain this data in your systems and can connect it to our platform through two approaches:

• Store our investor IDs in your system: recommended, as our API uses these IDs

• Use external_reference with your IDs to link records and enhance data in your interfaces

Investor verification

Before investors can participate in offerings, they typically need successful KYC processing, sanctions screening, and qualification checks according to your regulatory requirements. Since these processes are specific to your organization, our platform doesn't manage them directly.

The verification status helps you organize your workflow by separating investor record creation from verification completion. You can:

• Use a two-step process: create unverified records, then mark as verified after compliance checks

• Set verification to "true" immediately during creation if you complete verification before entering records

This flexibility accommodates different operational workflows and compliance requirements.

In case of the situation changes (e.g. not renewed in time KYC or suspicion of wrong information provided), you can always "unverify" investor to prevent from further investments.