Buckets

Add a wallet's addresses from its public key

Send a wallet's extended public key and SoChain adds its used addresses on the receive and change chains, plus spare unused ones after the last used (default 20). The bucket is made if it doesn't exist (then network is needed). Sending the same public key again adds newly used addresses and tops the spare ones up; another wallet's key is refused (409). The public key is used for this request only and not kept: the bucket keeps addresses, positions and the key's fingerprint. A private key (xprv…) is refused. Single-key wallets (BIP44/49/84/86).

post/buckets/{bucket}/xpub

Request

  • Base URL: https://sochain.com/api/v3
  • URL: https://sochain.com/api/v3/buckets/{bucket}/xpub
  • Auth: API key in header API-KEY

Path parameters

bucketstring required

Request body

xpubstring required

The account public key: xpub, ypub, zpub, tpub, upub, vpub, Ltub, Mtub, ttub or dgub.

networkstring

Needed when the bucket doesn't exist yet.

type'p2pkh' | 'p2sh-p2wpkh' | 'p2wpkh' | 'p2tr'

Implied by a ypub, zpub, upub, vpub or Mtub. A plain xpub, tpub, Ltub, ttub or dgub is used for every type: say which, or leave it out and the type the wallet has used is picked (a wallet with no history yet needs it).

spareinteger

Response

Filled or topped up.

status'success'

Changes

No recorded changes to this operation across all 1 revision of this API.