๐ Issue the next BTC address
Code samples
POST /api/v1/btc/xpub/{id}/address
curl -X POST 'https://settla.net/api/v1/btc/xpub/{id}/address' \
-H 'X-API-Key: $SETTLA_API_KEY' \
-H 'Accept: application/json'
Increments the per-key index under a row lock, so concurrent calls never hand out the same address twice.
๐ ๏ธ Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | true | none |
Example responses
201 Response
{
"address": "bc1qcr8te4kr609gcawutmrza0j4xv80jy8z306fyu",
"index": 0,
"path": "m/84'/0'/0'/0/0"
}
๐ Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | Address issued | Inline |
| 404 | Not Found | Key not found | None |
| 422 | Unprocessable Entity | Per-key address limit reached | None |
๐ Response Schema
Status Code 201
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| ยป address | string | false | none | none |
| ยป index | integer | false | none | none |
| ยป path | string | false | none | none |