Skip to main content
POST
/
v1
/
ext
/
wallet
/
create
Create End User Wallets (USD & NGN)
curl --request POST \
  --url https://staging-api.liquidity.walletos.xyz/v1/ext/wallet/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entityId": "{{entityId}}",
  "walletType": "SPEND"
}
'
{
  "message": "Wallets created",
  "wallets": [
    {
      "id": "97500af1-0964-419e-9ed6-3a3aeb1285bc",
      "slug": "NGN Wallet",
      "description": "NGN Wallet",
      "currency": "NGN",
      "balance": "0",
      "permissions": {
        "permissionType": "OWNER",
        "permissionFlowType": "ALL"
      },
      "settings": {
        "walletType": "USER",
        "approvalThreshold": 1,
        "displayCurrency": "NGN",
        "fundingCurrencies": [
          "USD",
          "NGN"
        ],
        "withdrawalCurrencies": [
          "USD",
          "NGN"
        ],
        "showBalance": true
      }
    },
    {
      "id": "af520cb7-5205-4cfb-ab50-ab4802a488fd",
      "slug": "USD Wallet",
      "description": "NGN Wallet",
      "currency": "USD",
      "balance": "0",
      "permissions": {
        "permissionType": "OWNER",
        "permissionFlowType": "ALL"
      },
      "settings": {
        "walletType": "USER",
        "approvalThreshold": 1,
        "displayCurrency": "USD",
        "fundingCurrencies": [
          "USD",
          "NGN"
        ],
        "withdrawalCurrencies": [
          "USD",
          "NGN"
        ],
        "showBalance": true
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
entityId
string
required

The entity ID for which to create wallets

walletType
enum<string>
required

The type of wallet to create

Available options:
COLLECTION,
SPEND

Response

200 - application/json

OK

The response is of type object.