Skip to main content
POST
/
omni-omni
/
v1
/
assets
🌳 Creates new asset
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 '{
  "assetType": "BEARER_BOND",
  "clientToken": "<string>",
  "clientWebhook": "<string>",
  "description": "<string>",
  "emailBody": "<string>",
  "emailSubject": "<string>",
  "entryType": "SINGLE",
  "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
}'
{
  "assetType": "BEARER_BOND",
  "clientToken": "<string>",
  "clientWebhook": "<string>",
  "description": "<string>",
  "emailBody": "<string>",
  "emailSubject": "<string>",
  "entryType": "SINGLE",
  "essentialContentOfRight": "<string>",
  "eventualRightOfThirdParties": "<string>",
  "extraOrdinaryTerminationRights": "<string>",
  "files": [
    {
      "description": "<string>",
      "fileType": "PICTURE",
      "id": 123,
      "title": "<string>",
      "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",
  "status": "INACTIVE",
  "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
​
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[]
​
individualShare
boolean
​
interestCalculationMethod
string
​
interestPayBackDate
string<date-time>
​
interestRate
number
​
investmentCondition
string
​
isin
string
​
key
string
​
loanPayBackDate
string<date-time>
​
mark
string
​
name
string
​
numberOfVotingRight
integer
​
ordinaryTerminationRights
string
​
ownerEmail
string
​
quantity
number
​
restrictedShare
boolean
​
restrictionsOnBehalfOfThirdParties
string
​
signingEndDate
string<date-time>
​
signingStartDate
string<date-time>
​
status
enum<string>
Available options:
INACTIVE,
ACTIVE,
DRAFT
​
subordinationAgreement
string
​
valuePerShare
number
​
webhookResult
string