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 information about all investments into your products via the /investments endpoint as well as details about specific investments. You can also use the product_id
to filter for investments into specific products.
Example:
r = requests.get(
f'{URL}/issuer/v2/investments/?product_id={product_id}',
headers={**headers}
)
assert r.status_code < 300, r.content
investment_id = r.json()['results'][0]['id']
r = requests.get(
f'{URL}/issuer/v2/investments/{investment_id}/',
headers={**headers}
)
assert r.status_code < 300, r.content
print(f'Investment: {r.json()['id']}')
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.
Last updated
Was this helpful?