---
title: "Get a new unused address"
method: GET
path: "/v1/cryptos/{cryptoCode}/derivations/{derivationScheme}/addresses/unused"
tags: ["Derivations"]
---

# Get a new unused address

`GET /v1/cryptos/{cryptoCode}/derivations/{derivationScheme}/addresses/unused`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/cryptos/{cryptoCode}/derivations/{derivationScheme}/addresses/unused`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/btcpayserver/apis/nbxplorer-api/docs/v1/cryptos/:cryptoCode/derivations/:derivationScheme/addresses/unused/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a new unused address from the specified derivation scheme. This endpoint allows you to generate new addresses for receiving funds, ensuring that you do not reuse addresses.

## Path parameters

- `cryptoCode` string, required
- `derivationScheme` string, required

## Query parameters

- `feature` 'Deposit' | 'Change' | 'Direct' | 'Custom'
- `skip` integer
- `reserve` boolean
- `autoTrack` boolean

## Response `200`

Successfully retrieved an unused address.

- KeyInformation
  - `trackedSource` string, nullable: The tracked source identifier, typically representing the derivation scheme being used.
  - `feature` string: Specifies the type of address generated. Possible values are: - `Deposit`: A deposit address from the external chain (`0/x`). - `Change`: A change address from the internal chain (`1/x`). - `Direct`: An address from the direct chain (`x`). - `Custom`: An address using a custom key path template.
  - `derivationStrategy` string: The derivation strategy used to derive addresses, typically the extended public key (xpub) with optional suffixes indicating the script type.
  - `keyPath` string, nullable: The derivation path used to generate this address, e.g., `0/123`. (Only for standard derivation schemes)
  - `index` integer, nullable: The derivation path index of this address
  - `scriptPubKey` string: The scriptPubKey of the generated address in hexadecimal format.
  - `address` string: The generated address, in base58 or bech32 format, depending on the script type.
  - `redeem` string, nullable: The redeem script associated with the address (if applicable). Returns the SegWit redeem script if the derivation scheme is P2SH-P2WPKH or P2WPKH, or the P2SH redeem script if the script type is P2SH.
  - `blindingKey` string, nullable: The blinding private key (Liquid Only)

## Other responses

- `400`: Bad Request. The derivation scheme is not found or invalid.
- `404`: Not Found. The specified cryptocurrency code is not supported or not found.

## Changes

- **2026-09-29** `52231f42c765`: 5 info
  - added the new optional `query` request parameter `autoTrack`
  - the response property `httpCode` became required for the status `400`
  - the response property `httpCode` became required for the status `404`
  - the response property `message` became required for the status `400`
  - …1 more
- **2025-04-04** `7a5c59ac1e4d`: 1 info
  - added the optional property `blindingKey` to the response with the `200` status
- **2024-12-25** `eb48f5312f18`: 3 breaking, 1 info
  - the response property `keyPath` became nullable for the status `200`
  - the response property `redeem` became nullable for the status `200`
  - the response property `trackedSource` became nullable for the status `200`
  - added the optional property `index` to the response with the `200` status
- **2024-11-28** `32910c4ec4c8`: 1 info
  - api operation id `GetUnused` was added
- **2024-11-25** `cfaf4efd4ea8`: 4 breaking, 6 info
  - the `code` response's property type changed from `integer` to `string` for status `400`
  - the `code` response's property type changed from `integer` to `string` for status `404`
  - removed the required property `error` from the response with the `400` status
  - removed the required property `error` from the response with the `404` status
  - …6 more

[Operation history](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/changes/v1/cryptos/:cryptoCode/derivations/:derivationScheme/addresses/unused/get.md)

---

[API](https://skmtc.dev/btcpayserver/apis/nbxplorer-api.md) - [All operations](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/revisions/52231f42c765?raw)