Wallets

A wallet is a blockchain address Securitize associates with one investor. You register it on the investor’s behalf; registering does not let it receive tokens yet. For that, whitelist it on a token. Wallets do not depend on the verification: you can register them for any investor, individual or entity, in any status, including an investor you have limited access to.

POST /investors/{investorId}/wallets   register a wallet
GET  /investors/{investorId}/wallets   the wallets you registered, newest first

Register a wallet

curl -X POST "$BASE/investors/$INVESTOR_ID/wallets" -H "Authorization: Bearer $ACCESS_TOKEN" -H "content-type: application/json" -d '{
  "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
  "blockchainType": "evm"
}'

You vouch for ownership. There is no signature or challenge: registering a wallet is you asserting that the investor controls it. Two families, not chains. blockchainType is evm (Ethereum and every EVM chain; you never name the chain) or solana, and defaults to evm.

`blockchainType`	Address	Returned as
`evm`	`0x` and 40 hex characters, any case	lower case
`solana`	base58, 32 to 44 characters, case-sensitive	exactly as sent

An address that does not match its family answers 400 naming the field. An address belongs to one investor across all of Securitize, on every chain.

An address this investor already holds answers 201 and joins your list, whoever registered it first. Repeating a registration is safe.
An address another investor holds answers 409 wallet_conflict. For a Solana address, check the letter case: two addresses that differ only in case count as the same.

Each investor can hold a limited number of wallets per family; Securitize can raise the limit. A new address over the limit, or one that fails Securitize’s risk check, answers 422 business_rule_violation.

List the wallets you registered

curl "$BASE/investors/$INVESTOR_ID/wallets" -H "Authorization: Bearer $ACCESS_TOKEN"

{
  "meta": { "length": 2 },
  "data": [
    { "address": "7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtV", "blockchainType": "solana" },
    { "address": "0x5aaeb6053f3e94c9b9a09f33669435e7ef1beaed", "blockchainType": "evm" }
  ]
}

The list holds only the wallets you registered, or attached by whitelisting them, for this investor. Wallets the investor added on Securitize, or another partner registered, appear only once you register them yourself. A wallet has no id: the address identifies it. There is no call to remove a wallet. Contact Securitize if one must be removed.

Get started

Guides

Concepts

Help

API reference

Register a wallet

List the wallets you registered