API Reference

/utxo/btc/addresses/{masterKey}

get
https://translate.noves.fi/utxo/btc/addresses/

Utility endpoint for Bitcoin. Returns a list of derived addresses for a given xpub, ypub or zpub master key.

Supports different Bitcoin address types:

  • Legacy (0): Legacy P2PKH addresses starting with "1" - Most compatible, higher fees
  • SegWit (1): Native SegWit P2WPKH addresses starting with "bc1" - Lower fees, modern standard
  • SegWitP2SH (2): SegWit P2SH-P2WPKH addresses starting with "3" - Backward compatible SegWit
  • Taproot (3): Taproot P2TR addresses starting with "bc1p" - Enhanced privacy and flexibility

Examples:

  • GET /utxo/btc/addresses/{masterKey} - Returns 20 legacy addresses (default)
  • GET /utxo/btc/addresses/{masterKey}?count=50&addressType=1 - Returns 50 Native SegWit addresses
  • GET /utxo/btc/addresses/{masterKey}?count=100&addressType=SegWit - Same as above using string value
Path Params
string
required

Master key address to derive the related BTC addresses from

Query Params
int32
1 to 10000
Defaults to 20

Number of addresses to derive from the master key (values between 1-10000). Default: 20

string
enum

Bitcoin address type to generate. Supports both numeric (0-3) and string values (Legacy, SegWit, SegWitP2SH, Taproot). Default: Legacy (0)

Allowed:
Headers
string
required
Defaults to demokey

API Key for Translate API. To generate an API Key, visit https://noves.fi/pricing

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated 8 months ago

Language
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain
text/json
Updated 8 months ago