Skip to main content
POST
/
api
/
v1
/
wallet
/
create
Create a wallet
curl --request POST \
  --url https://api.example.com/api/v1/wallet/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "network": "mainnet",
  "ark_server": "<string>",
  "ark_server_access_token": "<string>",
  "birthday_height": 1,
  "chain_source": {
    "bitcoind": {
      "bitcoind": "<string>",
      "bitcoind_auth": {
        "cookie": {
          "cookie": "<string>"
        }
      }
    }
  },
  "mnemonic": "<string>"
}
'
{
  "fingerprint": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://second.tech/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Base64url-encoded auth token

Body

application/json
network
enum<string>
required

The network to use for the wallet

Available options:
mainnet,
signet,
mutinynet,
regtest
ark_server
string | null

The Ark server to use for the wallet. Optional when a config.toml already exists in the datadir.

ark_server_access_token
string | null

An access token for a private Ark server

birthday_height
integer<int32> | null

An optional birthday height to start syncing the wallet from

Required range: x >= 0
chain_source
object

The chain source to use for the wallet. Optional when a config.toml already exists in the datadir.

mnemonic
string | null

The optional mnemonic to use for the wallet

Response

Wallet created successfully

fingerprint
string
required