Asset

This API endpoint allows you to create new asset.

POST /omni-omni/v1/assets

🌳 Creates new asset

cURL

curl --request POST \
  --url https://backend.sandbox.ecrop.de/ecrop-command/omni-omni/v1/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientToken": "<string>",
  "clientWebhook": "<string>",
  "description": "<string>",
  "emailBody": "<string>",
  "emailSubject": "<string>",
  "essentialContentOfRight": "<string>",
  "eventualRightOfThirdParties": "<string>",
  "extraOrdinaryTerminationRights": "<string>",
  "individualShare": true,
  "interestCalculationMethod": "<string>",
  "interestPayBackDate": "2023-11-07T05:31:56Z",
  "interestRate": 123,
  "investmentCondition": "<string>",
  "isin": "<string>",
  "loanPayBackDate": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "numberOfVotingRight": 123,
  "ordinaryTerminationRights": "<string>",
  "ownerEmail": "<string>",
  "quantity": 123,
  "restrictedShare": true,
  "restrictionsOnBehalfOfThirdParties": "<string>",
  "signingEndDate": "2023-11-07T05:31:56Z",
  "signingStartDate": "2023-11-07T05:31:56Z",
  "subordinationAgreement": "<string>",
  "valuePerShare": 123
}
'

201

{
  "clientToken": "<string>",
  "clientWebhook": "<string>",
  "description": "<string>",
  "emailBody": "<string>",
  "emailSubject": "<string>",
  "essentialContentOfRight": "<string>",
  "eventualRightOfThirdParties": "<string>",
  "extraOrdinaryTerminationRights": "<string>",
  "files": [
    {
      "description": "<string>",
      "title": "<string>",
      "id": 123,
      "url": "<string>"
    }
  ],
  "individualShare": true,
  "interestCalculationMethod": "<string>",
  "interestPayBackDate": "2023-11-07T05:31:56Z",
  "interestRate": 123,
  "investmentCondition": "<string>",
  "isin": "<string>",
  "key": "<string>",
  "loanPayBackDate": "2023-11-07T05:31:56Z",
  "mark": "<string>",
  "name": "<string>",
  "numberOfVotingRight": 123,
  "ordinaryTerminationRights": "<string>",
  "ownerEmail": "<string>",
  "quantity": 123,
  "restrictedShare": true,
  "restrictionsOnBehalfOfThirdParties": "<string>",
  "signingEndDate": "2023-11-07T05:31:56Z",
  "signingStartDate": "2023-11-07T05:31:56Z",
  "subordinationAgreement": "<string>",
  "valuePerShare": 123,
  "webhookResult": "<string>"
}

This chapter provides a step-by-step guide to creating and managing assets using ecrop’s API. Creating an asset is the crucial first step in issuing a security on the ecrop platform. The asset represents the real-world item or project underlying the security, holding key information about its nature, quantity, and ownership. This is a critical step as it lays the groundwork for tokenization and subsequent investor offerings. It defines the core properties of the security offering before it is presented to potential investors. The asset you create will be linked to the tokens issued and the campaign used to distribute them. This section focuses on using the API for asset creation, providing the details you need for successful integration with your systems.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

assetType · enum<string>

Available options: BEARER_BOND, COMMON_SHARE, PREFERRED_SHARE, CRYPTO_FUND_SHARE

clientToken · string

clientWebhook · string

description · string

emailBody · string

emailSubject · string

entryType · enum<string>

Available options: SINGLE, CUMULATIVE

essentialContentOfRight · string

eventualRightOfThirdParties · string

extraOrdinaryTerminationRights · string

individualShare · boolean

interestCalculationMethod · string

interestPayBackDate · string<date-time>

interestRate · number

investmentCondition · string

isin · string

loanPayBackDate · string<date-time>

name · string

numberOfVotingRight · integer<int32>

ordinaryTerminationRights · string

ownerEmail · string

quantity · number

restrictedShare · boolean

restrictionsOnBehalfOfThirdParties · string

signingEndDate · string<date-time>

signingStartDate · string<date-time>

subordinationAgreement · string

valuePerShare · number

Response

201 - application/json

Asset retrieved

assetType · enum<string>

Available options: BEARER_BOND, COMMON_SHARE, PREFERRED_SHARE, CRYPTO_FUND_SHARE

clientToken · string

clientWebhook · string

description · string

emailBody · string

emailSubject · string

entryType · enum<string>

Available options: SINGLE, CUMULATIVE

essentialContentOfRight · string

eventualRightOfThirdParties · string

extraOrdinaryTerminationRights · string

files · object[] · read-only

Show child attributes

individualShare · boolean

interestCalculationMethod · string

interestPayBackDate · string<date-time>

interestRate · number

investmentCondition · string

isin · string

key · string · read-only

loanPayBackDate · string<date-time>

mark · string · read-only

name · string

numberOfVotingRight · integer<int32>

ordinaryTerminationRights · string

ownerEmail · string

quantity · number

restrictedShare · boolean

restrictionsOnBehalfOfThirdParties · string

signingEndDate · string<date-time>

signingStartDate · string<date-time>

status · enum<string> · read-only

Available options: INACTIVE, ACTIVE, DRAFT

subordinationAgreement · string

valuePerShare · number

webhookResult · string · read-only