Skip to main content
POST
Node.js
Required scope: wallets:write Send network, nickname, optional memo and an Idempotency-Key. The request keeps the supported asset set chosen when it is accepted. HTTP 201 means the address is ready; HTTP 202 means setup is pending. After a timeout, retry with the original key and body. Once requestId is known, use GET /v1/wallets/network/. For pending requests, setupState=processing means continue polling the same request; review_required means Ledig must review it. Retain the requestId and do not create a replacement. Creating an address does not add funds to your balance.

Authorizations

x-ledig-key
string
header
required

Your business API key ID. Keep its secret on your server and use that secret to sign each request.

x-ledig-timestamp
string
header
required

The current Unix timestamp in seconds, used in the signed request.

x-ledig-signature
string
header
required

The request's HMAC-SHA256 signature. Use the v1= prefix for supported own-business requests, or v2= when acting for a managed business with signed business-selection headers. Follow the authentication guide to construct and sign the exact request.

Headers

Idempotency-Key
string
required

A unique value for this request. On endpoints that require it, retry with the same key and identical inputs to avoid creating the operation twice.

Body

application/json
nickname
string
required
Required string length: 1 - 255
network
string
required

A network ID returned by GET /v1/wallets/options.

Minimum string length: 1
memo
string

Response

The complete receiving setup is ready.

status
string
required
Allowed value: "success"
data
object
required
message
string