Wallets

Understanding WalletsCopied!

As a stablecoin banking API, we provide the ability to instantly create stablecoin wallets and custody stablecoins in a simple way – without requiring external integrations.

Our wallet module lets customers store stablecoin balances and integrates seamlessly with our payment flows for fiat pay-ins and payouts, enabling fast, cost-effective, and reliable cross-border payment processing.

Key features of UnblockPay's wallets:

• Creating individual wallets on behalf of your users

• Creating wallets for your company or treasury

• Transferring funds in and out of UnblockPay wallets

• Checking balances for individual and aggregate wallets

Wallets API endpointsCopied!

Here are the endpoints you'll need to create, list and manage wallets:

• POST /customers/{customer_id}/wallets: Create a new wallet

• GET /customers/{customer_id}/wallets: List all wallets from a specific customer

• GET /customers/{customer_id}/wallets/{wallet_id}: Get specific details from a customer wallet

Supported Blockchains and StablecoinsCopied!

We support wallet creation on the following blockchain networks and stablecoins, and we're adding more based on developer demand.

How to create a Wallet?Copied!

POST /customers/{customer_id}/wallets

This endpoint creates a wallet address that is associated with a customer. You can create multiple wallet addresses for each customer across supported blockchains.

To create a wallet, you must create a Customer before.

If you want to create a wallet for yourselves, create a customer_id that represents you (or your company) and then use it to create wallets.

Now that you've created a customer, let's create a wallet. The URL must include the customer_id for the wallet address you want to create. In the request body, specify both the wallet name and the target blockchain network.

Here's a request example for creating a wallet in solana:

curl https://api.unblockpay.com/customers/{customer_id}/wallets \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: YOUR_SECRET_TOKEN' \
  --data '{
  "name": "Satoshi wallet",
  "blockchain": "solana"
}'

Here's a response example:

{
    "id": "0196cc5a-3e53-700d-9fef-6ba253d9fb32",
    "name": "Satoshi wallet",
    "blockchain": "solana",
    "address": "79jRumnFHUAf4wkutTq7231bFYJ494hUqhtJyLqS55fg",
    "customer_id": "0196cc56-04f2-721e-ab93-275ee2efb7ca",
    "partner_id": "238b9770-033b-11f0-9566-118181d0afda",
    "created_at": "2025-05-14T01:13:09.276Z",
    "updated_at": "2025-05-14T01:13:09.276Z"
}