Skip to main content
POST
Create a wallet

Authorizations

Authorization
string
header
required

Token from POST /auth/token

Headers

Idempotency-Key
string
required

Required on POST and PUT requests. Use a unique value per logical mutation attempt, for example a UUID.

Body

application/json

Create a custodial crypto wallet. Not yet implemented — returns 501.

customerId
string
required

Owning customer (cst_ prefix).

Pattern: ^[a-z]+_([0-9a-hjkmnp-tv-z]{26}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$
type
enum<string>
required

Type discriminator.

Available options:
custodial
details
object
required

Custodial crypto wallet create request details.

label
string | null
metadata
object

Response

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

The custodial variant — one crypto asset on one network, held on the customer's behalf by the custody provider, currently "Coinme Inc.". details.address is the on-chain deposit address and is omitted until the provider reports one.

id
string
required

Wallet ID (TypeID; wlt_fiat_ for fiat wallets).

Pattern: ^[a-z]+_([0-9a-hjkmnp-tv-z]{26}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$
object
enum<string>
required

Resource type discriminator. Always "wallet".

Available options:
wallet
customerId
string
required

The OMS customer that owns this record (cst_ prefix).

Pattern: ^[a-z]+_([0-9a-hjkmnp-tv-z]{26}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$
status
enum<string>
required

Current wire status.

Available options:
preallocated,
active,
suspended
provider
string
required

The legal entity holding this wallet's assets, derived from wallet type and asset: custodial → "Coinme Inc."; fiat (usd) → "Erebor Bank, N.A.". New providers may be added, so treat the string as free-form rather than a fixed set.

multiAsset
boolean
required

true when the wallet supports every network in its family and all assets on them; false when restricted to a single asset (fiat, custodial).

displayName
string
required

Server-generated wallet name. Custodial wallets use their on-chain address; fiat wallets use USD balance (<wallet id>). Distinct from the optional partner-supplied label.

type
enum<string>
required

Type discriminator.

Available options:
custodial
details
object
required

Custodial crypto wallet details — one asset on one network, held by the custody provider on the customer's behalf.

customer
object

Display-safe summary of the owning customer (customer.id equals customerId). Returned on list and detail responses.

label
string | null
balances
object[]
metadata
object
createdAt
string<date-time>
updatedAt
string<date-time>