If the tokenized asset is a bond, regulatory requirements mandate that complete terms of issuance remain publicly accessible at all times, including within the blockchain metadata. This step is therefore mandatory for bonds.
ℹ️ Shares do not require terms of issuance documentation. You may skip this step when tokenizing shares.
Please provide the terms of issuance document in PDF format for upload to our S3 storage. Once uploaded, the document URL will be included in the on-chain metadata.
To submit the PDF document, use the update token endpoint. Since this endpoint requires token data alongside the file, you must include both in your request.
If you need to retrieve the token details first, use the "Get Tokenized Asset Details" endpoint:
GET /api/tokenization/tokenized-asset/{tokenizedAssetId}
Request Example
# UAT BASE_URL: https://uat.vault.nyala.de
# Production BASE_URL: https://vault.nyala.de
# The {tokenizedAssetId} is ef86ea3e-f46f-4274-aad8-e83b1a241360
curl -X PATCH {{BASE_URL}}/api/tokenization/tokenized-asset/{tokenizedAssetId} \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F "toiRawFile=@/path/to/your/blank.pdf" \
-F 'tokenizedAssetData={
"id": "ef86ea3e-f46f-4274-aad8-e83b1a241360",
"assetId": "0xb665e3470C20e83a8d39781FFcf892E9066040e0",
"name": "TK-United States of America",
"unitName": "TK6976",
"totalSupply": 1000,
"blockchain": 14,
"isin": "DE976",
"isRegulatedSecurity": true,
"price": "100",
"nominalAmountPerToken": "100",
"duration": "2035-01-01",
"paused": false
}'| Parameter | Description |
|---|---|
| institutionID | Your institutionID after having been onboarded on NYALA. InstitutionId is set up in your Postman collection. |
| TokenID | The ID of the tokenized asset returned to you at token creation. |
This will give you the token details which you can simply include as is in the next request which is "Update Tokenized Asset - (Toi File)"
PATCH /api/Tokenization/{institutionId}/tokenized-assets/{tokenizedAssetId}
Request Example
# UAT BASE_URL: https://uat.vault.nyala.de
# Production BASE_URL: https://vault.nyala.de
# The {institutionId} is 8c8f78bc-78e0-47a7-b4e0-a793343175f0
# The {tokenizedAssetId} is ef86ea3e-f46f-4274-aad8-e83b1a241360
curl -X GET {{BASE_URL}}/api/Tokenization/{institutionId}/tokenized-assets/{tokenizedAssetId} \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json"