Skip to main content
POST
Create wallet

Authorizations

API-KEY
string
header
required

Your partner API key.

Headers

Api-Version
string
default:2026-09.1
required

The API version this request targets. Required on every /api/v0/* call. Format YYYY-MM.<release>; 2026-09.1 is the latest. The version that served the request is echoed back on the response. Missing, malformed or unsupported values are rejected with 400.

Pattern: ^\d{4}-\d{2}\.\d+$

Path Parameters

userId
string
required

Customer reference id, format cus_<20 chars> — never an internal UUID. Must belong to the authenticated partner.

Body

application/json
network
enum<string>
required

The network the wallet is created on, spelled exactly as listed — matched case-sensitively. Production and staging accept the six mainnets (Ethereum, Base, ArbitrumOne, Optimism, Polygon, Tron); sandbox and QA accept the three test networks (EthereumSepolia, BaseSepolia, TronNile).

Available options:
Ethereum,
Base,
ArbitrumOne,
Optimism,
Polygon,
Tron,
EthereumSepolia,
BaseSepolia,
TronNile
name
string

Human-readable label for the wallet. Optional, but must be a non-empty string if sent.

tags
string[]

Optional labels for the wallet. Must be an array of strings if present.

Response

Wallet created. Unwrapped — the body is the wallet itself. No tags come back, even when you sent them.

A wallet, unwrapped — the shape every wallet response returns (create, get, update, list).

walletId
string

Endl's wallet reference id (wlt_…). Never the custody provider's id.

userId
string

The customer (cus_…) the wallet belongs to.

network
string

The network the wallet was created on.

address
string

The on-chain address. Live from creation.

name
string

The wallet's label.

status
string

The custody provider's status, in its own vocabulary. Compare case-insensitively.

currency
string

A local default stamped at creation — USDT on a Tron wallet (Tron or TronNile), USDC on every other network. Not a restriction, and not a reading of the chain.

dateCreated
string

When the wallet was created.