---
title: "Track a derivation scheme"
method: POST
path: "/v1/cryptos/{cryptoCode}/derivations/{derivationScheme}"
tags: ["Derivations"]
---

# Track a derivation scheme

`POST /v1/cryptos/{cryptoCode}/derivations/{derivationScheme}`

Starts tracking a new derivation scheme (wallet) for the specified cryptocurrency. This allows NBXplorer to monitor all addresses derived from the provided derivation scheme and notify about related transactions. Once tracked, NBXplorer will start indexing the addresses and UTXOs associated with this derivation scheme.

## Path parameters

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

## Request body

- object
  - `derivationOptions` object[] — Optional. A list of derivation options specifying address generation features and address pool sizes.
    - `feature` 'Deposit' | 'Change' | 'Direct' | 'Custom', required — The type of address chain to pre-generate addresses for. Possible values: - `Deposit`: External chain (`0/*`), used for receiving payments. - `Change`: Internal chain (`1/*`), used for change addresses. - `Direct`: Direct chain (`*`), used in certain cases. - `Custom`: Custom chain if using a custom key path template.
    - `minAddresses` integer — Optional. The minimum number of addresses to pre-generate for this feature.
    - `maxAddresses` integer — Optional. The maximum number of addresses to pre-generate for this feature to prevent uncontrolled growth.
  - `wait` boolean — Optional. If set to `true`, the server will wait until the derivation scheme is fully tracked before responding. Default is `false`.

## Response `200`

Successfully started tracking the derivation scheme.

- object
  - `message` string

## Other responses

- `400` — Bad Request. The request was invalid. Possible reasons include an invalid `cryptoCode` or `derivationScheme`.
- `404` — Not Found. The specified `cryptoCode` is not supported or not found.

---

[API](https://skmtc.net/btcpayserver/apis/nbxplorer-api.md) · [All operations](https://skmtc.net/btcpayserver/apis/nbxplorer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/btcpayserver/nbxplorer-api/revisions/208cac39e31a/schema)