---
title: "Create a new wallet asset for a customer"
method: POST
path: "/customers/{id}/wallets"
tags: ["Wallet"]
---

# Create a new wallet asset for a customer

`POST /customers/{id}/wallets`

Provisions a crypto wallet for a customer for the requested asset and
chain, returning the created wallet. Pass an Idempotency-Key header to
safely retry without provisioning duplicates.

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- WalletCreateRequest — Request body for creating a wallet: the asset to hold and the chain it lives on.
  - `asset` string, required — Asset the wallet will hold (e.g. `usdc`).
  - `chain` string, required — Chain the wallet lives on.

## Response `201`

The request has succeeded and a new resource has been created as a result.

- Wallet — A wallet holding a single asset on one chain for a customer. internal wallets are OMS-managed; external wallets are held outside OMS.
  - `id` string — Public TypeID, e.g. `txn_01h455vb4pex5vsknk084sn02q`; legacy UUID suffixes are accepted until non-v7 rows are retired.
  - `object` 'wallet' — Resource type discriminator. Always "wallet".
  - `customerId` string — Public TypeID, e.g. `txn_01h455vb4pex5vsknk084sn02q`; legacy UUID suffixes are accepted until non-v7 rows are retired.
  - `type` 'internal' | 'external' — Whether a wallet is internal (OMS-managed) or external (held outside OMS).
  - `asset` string — Asset held by this wallet.
  - `chain` string — Chain the wallet lives on.
  - `blockchainAsset` BlockchainAsset
    - `protocol` 'evm' | 'svm' | 'sui', required
    - `chainId` string, required
    - `tokenId` string, required
  - `address` string — On-chain address of the wallet.
  - `status` 'active' | 'suspended' | 'frozen' | 'closed'
  - `createdAt` string, date-time — When the wallet was created.
  - `updatedAt` string, date-time — When the wallet was last updated.

---

[API](https://skmtc.net/polygon-technology/apis/polygon-oms-public-api.md) · [All operations](https://skmtc.net/polygon-technology/apis/polygon-oms-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polygon-technology/polygon-oms-public-api/revisions/18fdaebf64e5/schema)