Skip to main content
POST
/
v1
/
wallets
Create a wallet
curl --request POST \
  --url https://api.ledger.so/v1/wallets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerId": "cus_abc123",
  "provider": "solana"
}
'
{
  "ok": true,
  "data": {
    "id": "wal_def456",
    "customerId": "cus_abc123",
    "chain": "solana",
    "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "status": "active",
    "walletType": "custodial",
    "createdAt": "2025-01-15T11:00:00Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key passed as a Bearer token. Format: ld_<env>_<prefix>_<secret> where <env> is test or live.

Headers

​
Idempotency-Key
string

Unique key to ensure idempotent request processing. Reusing a key for a different route or method returns 409 Conflict.

Example:

"idk_a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Body

application/json
​
customerId
string
required

The customer to create the wallet for.

Example:

"cus_abc123"

​
provider
string
required

The blockchain provider/chain for the wallet.

Example:

"solana"

Response

Wallet created successfully

​
ok
boolean
required

Indicates the request was successful.

​
data
object