Investor Activity API

The Investor Activity API gives you the activity of your investor account in tokenized funds, so you can keep your own books in step with Securitize’s. Every movement of cash and tokens on your account is recorded by Securitize, pushed to your webhook endpoint as it happens, and readable afterwards: your cash movements, the tokens issued to you, the transfers you make, the payouts you receive and what you hold, each with the ids that tie one step to the next.

What it covers

Activity	What you see	Guide
Subscriptions	Your cash arriving, applied to an issuance, and the tokens minted to you	Reconcile a subscription
Redemptions	Your transfer back, the redemption accepted and confirmed, and the cash paid out	Reconcile a redemption
Reinvested distributions	The cash value of a distribution and the tokens it bought	Reconcile a subscription
Holdings	What you hold of each token, across every wallet of your account	Amounts

New kinds of activity are added as new event types and fields, announced in the changelog.

What you work with

Object	What it is	Id
Token	One fund’s token on one chain. Activity is listed per token	`tokenId`
Cash movement	One movement of cash on your account: a deposit, its liquidation into tokens, a withdrawal or a refund. Read through `/deposits`	`id` of the deposit
Token issuance	One minting of tokens to you, for a subscription or a reinvested distribution	`tokenIssuanceId`
Transaction	One token movement on chain: an issuance to you, or a transfer you make	`id` of the transaction, `txHash`
Redemption	One redemption, from accepted to paid	`id` of the redemption
Event	One webhook. The deduplication key	`eventId`

The ids that join the steps are in Identifiers.

Push and pull

Channel	What it gives you	When to use it
Webhooks	One signed `POST` per step of your activity, as it happens	Your primary feed
Deposits and transactions	Your cash movements and token transactions per token, with the keys that join them	To reconcile, and to rebuild state
Holdings	What you hold of each token	To check positions against your books
Webhook events	Every webhook sent to you, newest first, with its body as delivered	After an outage, to audit, to find a webhook you expected

The whole picture

Get a bearer token with your client credentials. Sandbox and authentication.
Receive webhooks at the endpoint your Securitize contact registered for you: verify the signature, acknowledge with a 2xx, deduplicate on eventId. Receive webhooks.
Reconcile each activity: a subscription by tokenIssuanceId, a redemption by the redemption’s id and the transfer’s txHash.
Check positions with GET /assets, and fill any gap from the deposits, transactions and webhook events.

Sandbox and authentication

The base URL and the token endpoint.

Receive webhooks

Verify, acknowledge, deduplicate, apply.

Reconcile a subscription

Cash in, tokens out, joined by tokenIssuanceId.

Reconcile a redemption

Tokens in, cash out, from transfer to payout.

Before you start

An agreement with Securitize. Your Securitize contact issues your client id and secret, registers your webhook endpoint and hands you its signing secret. The credentials belong to your investor account, and every answer is scoped to it.
A public HTTPS endpoint that answers 2xx quickly and can verify a signature.
An idempotent handler. Delivery is at least once and can be out of order. Your consumer must be correct when the same event arrives twice, or a later step arrives first.

What makes this API different

Amounts are integers. Every amount is a string of digits in base units, next to the decimals that interpret it: "500000000" with decimals 2 is 5,000,000.00. No rounding, no floating point. See Amounts.
Cash and tokens are separate amounts. A cash movement is in the currency’s minor units, a token movement in the token’s base units. The two meet through the fund’s price, not through the API.
Steps can arrive out of order. The issuance transaction can arrive before the minting event. Key on ids, never on arrival order.
Unknown values are normal. New event types, processType and paymentMethod values are added as the API grows. Treat a value you do not know as informational and keep going.

Not available

No instructions: you subscribe and redeem through your usual channel with Securitize, and this API reports what happens. No failure events: a step that does not complete sends nothing, so check the endpoints when an expected webhook does not arrive. No self-service endpoint management: your Securitize contact registers the endpoint and rotates its secret. Every operation, field, event and error is in the API reference in the sidebar, where you can also try each call against sandbox with a token from Get an access token.

Get started

Guides

Concepts

Help

API reference