---
title: "Assign Deposit Customer Wallet"
method: POST
path: "/v1/deposit-customers/{depositCustomerToken}/wallets"
tags: ["Deposits"]
---

# Assign Deposit Customer Wallet

`POST /v1/deposit-customers/{depositCustomerToken}/wallets`

## Request

- Base URL: `https://api.hel.io`
- URL: `https://api.hel.io/v1/deposit-customers/{depositCustomerToken}/wallets`
- Auth: none required

Assigns or returns a deposit wallet for the specified **blockchain engine** on a deposit customer. If a wallet for that engine already exists, the existing wallet is returned instead of creating a duplicate.

Use this when a customer selects a network in your UI and you need to provision (or retrieve) the corresponding deposit address.

**Authentication:** none (public). The deposit customer token in the path is the credential — keep it secret as you would an API key.

## Path parameters

- `depositCustomerToken` string, required

## Request body

- AssignDepositCustomerWallet
  - `blockchainEngineType` 'EVM' | 'SOL' | 'BTC' | 'TRON' | 'HYPERCORE' | 'DOGE' | 'TON', required: The blockchain engine to assign a deposit wallet for.

## Response `200`

The assigned deposit wallet for the requested blockchain engine.

- DepositWalletEnriched
  - `id` string, required: Unique identifier of the deposit wallet.
  - `publicKey` string, required: The wallet address for this blockchain.
  - `blockchainEngine` BlockchainEngine, required
    - `id` string, required
    - `type` 'EVM' | 'SOL' | 'BTC', required
  - `createdAt` string, date-time: ISO 8601 timestamp when the wallet was created.
  - `updatedAt` string, date-time: ISO 8601 timestamp when the wallet was last updated.

## Other responses

- `400`: The requested blockchain engine is not supported for this company, or wallet assignment failed.
- `403`: The deposit customer is sanctioned, or the deposit creator is disabled.
- `404`: The deposit customer token is unknown, or the customer type does not support wallet assignment.

## Changes

- **2026-11-03** `5988f1c713e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hel/apis/helio-open-api/changes/v1/deposit-customers/:depositCustomerToken/wallets/post.md)

---

[API](https://skmtc.dev/hel/apis/helio-open-api.md) - [All operations](https://skmtc.dev/hel/apis/helio-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hel/apis/helio-open-api/revisions/5988f1c713e0?raw)