---
title: "Create or import wallet"
method: POST
path: "/api/wallets"
tags: ["Wallets", "Wallet and web3"]
---

# Create or import wallet

`POST /api/wallets`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/wallets`
- Auth: HTTP bearer

PIN is required for every create path. Custodial create: `{ pin, legalTermsVersion }` only — server generates secrets. Import/link: `pin` plus `address` plus `encryptedPrivateKey` or `privateKey` (optional `mnemonic`).

## Request body

- object
  - `pin` string, required: Required for custodial create and import/link. Exactly 6 digits.
  - `legalTermsVersion` string: Required for custodial create
  - `address` string: Required for import/link
  - `encryptedPrivateKey` string
  - `privateKey` string
  - `mnemonic` string

## Response `200`

{ wallet }

## Changes

- **2026-08-16** `e01b7873e3f4`: 1 breaking
  - the request property `pin` became required
- **2026-08-16** `16bfbac187d7`: 4 info
  - added the new optional request property `legalTermsVersion`
  - added the new optional request property `mnemonic`
  - added the new optional request property `pin`
  - added the new optional request property `privateKey`
- **2026-03-12** `099fcb1a1540`: 1 info
  - api tag `Wallet and web3` added
- **2026-03-08** `120afc4ee72c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/wallets/post.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
