Investments

Each investment represents a purchase transaction of crypto securities by an investor account. Investments can be created via a transaction between the investor and the issuer on the primary market or they can result from a secondary market transaction between investor accounts.

Retrieving investment information

You can retrieve all investments for all of your investor accounts via the investment endpoint. Once you have obtained an investment ID via the investments list endpoint, you can get details about the investment using that ID.

Example:

# Get a list of all endpoints
r = requests.get(
    f'{URL}/distributor/v2/investments/',
    headers={**headers}
)
assert r.status_code < 300, r.content
investment_id = r.json()['results']['0']['id']

# Retrieve investment details
r = requests.get(
    f'{URL}/distributor/v2/investments/{investment_id}/',
    headers={**headers}
)
assert r.status_code < 300, r.content
status = r.json()['status']
print(status)

Investment status field codes

The status field of an investment may have one of the following values:

Status

Description

ABORTION

The investments has been canceled by the investor.

KYC_PENDING

The investment is signed but the identification process for the investor is still pending.

KYC_INSUFFICIENT

The investment was cancelled because the KYC/AML check could not be completed successfully due to missing or inconsistent data.

REVIEW_PENDING

The external review process is still pending.

WAITING_FOR_ACCEPTANCE

The investment is ready to be accepted by the issuer.

REJECTION

The investment has been rejected by the issuer.

ACCEPTED

The investment has been accepted by the issuer.

PAID

The investment amount has been marked as paid.

PAYMENT_MISSING

The investment has been canceled because the payment has not yet arrived on time.

DELIVERED

The amount of crypto securities for that investment have been credited to the wallet.

CANCELLATION

The investment has been canceled by the investor during the cancellation period.

Registry statements

You can retrieve all registry statements for an investment via the registry-statements endpoint.

Example:

# Get registry statements
r = requests.get(
    f'{URL}/distributor/v2/investments/{investment_id}/registry-statements/',
    headers={**headers}
)
assert r.status_code < 300, r.content
print(r.json()['results'])

New registry statements are created for every change to the remaining amount of the investment (e.g. because of an outgoing transfer or a redemption). They are also created on a yearly basis.

Last updated

Was this helpful?