Skip to content

Nyala Customer API (v1)

NYALA's tokenization API allows you to issue tokens on Polygon & Stellar. It allows you to create and manage tokens - including tokenized securities that have an ISIN - and to manage customer data. Interactions such as creating a new customer entity, request a wallet opening, creating a token and distributing a token to a customer are covered in this document. During the onboarding process, an institution entity will be created for you.

Download OpenAPI description
index.json
index.yaml
Overview
URL
https://www.nyala.de
Nyala Digital Asset AG
developer@nyala.de
Languages
Servers
Production Environment
https://api.nyala.de
UAT / Sandbox Environment
https://uat.api.nyala.de

Customer

The first step in the tokenization lifecycle is to create a Customer that will receive the token.

Operations

Retail Wallet

The second step in the tokenization lifecycle is to request a retail wallet for the Customer newly created. The tokens will be sent to that wallet, and the private key to the wallet will be custodied using our technology.

Operations

External Retail Wallet

Operations

List of external wallets.

Request

curl -i -X GET \
  https://api.nyala.de/api/external/v1/retail-wallets/external

Responses

OK

Bodyapplication/json
errorMessageCodesArray of strings or nullread-only
errorsArray of objects or null(Error)read-only
dataArray of objects or null(ExternalRetailWalletDto)read-only
Response
application/json
{
  "errorMessageCodes": [
    "string"
  ],
  "errors": [
    { … }
  ],
  "data": [
    { … }
  ]
}

Import external wallets into the system.

Request

Body

External wallets' public addresse with some metadata.

blockchainstring(int32)(Blockchains)
Enum"Stellar""Polygon""Peaq"
publicAddressstring or null
accountIdstring(uuid)
namestring or null
externalIdstring or null(uuid)
curl -i -X POST \
  https://api.nyala.de/api/external/v1/retail-wallets/external \
  -H 'Content-Type: application/json' \
  -d '{
    "blockchain": "Stellar",
    "publicAddress": "string",
    "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",
    "name": "string",
    "externalId": "3200d382-adfe-4314-ab30-798cdd0fcdb5"
  }'

Responses

OK

Bodyapplication/json
errorMessageCodesArray of strings or nullread-only
errorsArray of objects or null(Error)read-only
dataobject(CreateExternalRetailWalletResponseDto)
Response
application/json
{
  "errorMessageCodes": [
    "string"
  ],
  "errors": [
    { … }
  ],
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "externalId": "3200d382-adfe-4314-ab30-798cdd0fcdb5"
  }
}

Request to whitelist an external retail wallet for an asset class.

Request

Path
customer-idstring(uuid)required

Customer id.

external-retail-wallet-idstring(uuid)required

External retail wallet id.

Body

Data.

tokenizedAssetIdstring(uuid)required
approvedForDeliveryboolean
amountnumber(double)
txHashstring or null
curl -i -X POST \
  'https://api.nyala.de/api/external/v1/customers/{customer-id}/retail-wallets/{external-retail-wallet-id}/external-asset-class-opt-in' \
  -H 'Content-Type: application/json' \
  -d '{
    "tokenizedAssetId": "ad18357f-6719-482f-a109-bd87822008b9",
    "approvedForDelivery": true,
    "amount": 0.1,
    "txHash": "string"
  }'

Responses

OK

Bodyapplication/json
errorMessageCodesArray of strings or nullread-only
errorsArray of objects or null(Error)read-only
datastring(uuid)read-only
Response
application/json
{
  "errorMessageCodes": [
    "string"
  ],
  "errors": [
    { … }
  ],
  "data": "808ac6e4-93ed-4040-85a5-6c71a2444e90"
}

Status

Operations
Cookies
Copyright © NYALA Digital Asset AG.