Create a new wallet

POST /api/wallets/wallets

Try it

Create a new wallet

cURL

curl --request POST \
  --url http://localhost/api/wallets/wallets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "metadata": {},
  "name": "<string>"
}
'

201

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "metadata": {},
    "name": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "ledger": "<string>",
    "balances": {
      "main": {
        "assets": {}
      }
    }
  }
}

Authorizations

Authorization · string · header · required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

Idempotency-Key · string

Use an idempotency key

Body

application/json

metadata · object · required

Custom metadata to attach to this wallet.

Show child attributes

metadata. {key} · string

name · string · required

Response

201

application/json

Wallet created

data · object · required

Show child attributes

data. id · string<uuid> · required

The unique ID of the wallet.

data. metadata · object · required

Metadata associated with the wallet.

Show child attributes

data.metadata. {key} · string

data. name · string · required

data. createdAt · string<date-time> · required

data. ledger · string · required

data. balances · object

Show child attributes

data.balances. main · object · required

Show child attributes

data.balances.main. assets · object · required

Show child attributes

data.balances.main.assets. {key} · integer<bigint>