Asset

POST

omni-omni

assets

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

interestCalculationMethod

string

interestPayBackDate

string

interestRate

number

investmentCondition

string

isin

string

loanPayBackDate

string

name

string

numberOfVotingRight

integer

ordinaryTerminationRights

string

ownerEmail

string

quantity

number

restrictionsOnBehalfOfThirdParties

string

signingEndDate

string

signingStartDate

string

subordinationAgreement

string

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[]

interestCalculationMethod

string

interestPayBackDate

string

interestRate

number

investmentCondition

string

isin

string

key

string

loanPayBackDate

string

mark

string

name

string

numberOfVotingRight

integer

ordinaryTerminationRights

string

ownerEmail

string

quantity

number

restrictionsOnBehalfOfThirdParties

string

signingEndDate

string

signingStartDate

string

status

enum<string>

Available options:

INACTIVE,

ACTIVE,

DRAFT

subordinationAgreement

string

webhookResult

string

Asset Overview

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>"
}

OmniAsset Product Overview

Integration

Authentication

Party Management

Asset Management

Ownership transfer

Authorizations

Body

Response