Wallets

List Wallets

List Wallets

GET https://nchain.provide.services/api/v1/wallets

Returns a list of wallets in the authorized scope

Headers

Name	Type	Description
authorization	string	bearer scoped to an Application , Organization or User

200: OK

[
    {
        "id": "a20a4b36-4793-43c2-bcf3-077e9c73bc8f",
        "created_at": "2021-08-17T01:42:18.839878Z",
        "user_id": "49a02f33-33f2-4d69-a301-ffb1933e77cc",
        "vault_id": "190822c9-62f5-4caf-a419-df735a793b2f",
        "key_id": "55295b7c-a29b-4fc3-a901-9d30082ebd60",
        "purpose": 44,
        "public_key": "xpub661MyMwAqRbcEuU2GgrffeNM1K3grU4MJ9dFYvadomYe3qB9Qtf151xzpZ7hQB693j1N5ongrouRg7cWNnRFmUhdvNBqcgYb5S4opevCcgC"
    },
    {
        "id": "d690c37a-ec36-49fd-8612-2da93356599a",
        "created_at": "2021-08-16T19:25:18.063619Z",
        "user_id": "49a02f33-33f2-4d69-a301-ffb1933e77cc",
        "vault_id": "190822c9-62f5-4caf-a419-df735a793b2f",
        "key_id": "b67fb1fb-5e07-448b-88c5-a3ae2fa4e51d",
        "purpose": 44,
        "public_key": "xpub661MyMwAqRbcEog1wst4megMhGjdE49GusZJUWCVhEBjQNsF8eXkCUwmKhVbQDiv9DqsteBgznMtYpGGgeSAtwpJfXqL9CLhrJ8i2RW4mni"
    }
]

Create Wallet

Create Wallet

POST https://nchain.provide.services/api/v1/wallets

Creates an HD (hierarchical deterministic)

Wallet

in accordance with BIP32.. A

Wallet

may be setup as custodial or non-custodial. If the wallet is custodial then the platform will derive addresses and securely persist an

Account

for each of those derived addresses.

Headers

Name	Type	Description
authorization	string	bearer scoped to an Application , Organization or User

Request Body

Name	Type	Description
key_id	string	id of key to be used to derive Wallet
purpose	string	specification to be used by the HD node subtree; set to 44 for 44' (i.e., 0x8000002C following the BIP43 recommendation)
user_id	string	id of host User
vault_id	string	id of host Vault

201

{
    "id": "dd62c471-09d4-46d2-b54f-485586d8778c",
    "created_at": "2021-08-17T01:50:25.472817293Z",
    "user_id": "49a02f33-33f2-4d69-a301-ffb1933e77cc",
    "vault_id": "190822c9-62f5-4caf-a419-df735a793b2f",
    "key_id": "37a1024e-f326-45e2-8036-97a0223e1099",
    "purpose": 44,
    "public_key": "xpub661MyMwAqRbcEckmZd5gAhUk3bMciVkEhN1dYfnZPzgTNNCnH26EjBH5ks3SabVHkbth42pKXZcXpyhC3o65XmkkrkKeRmgTphFs7G4nqJv"
}

List Wallet Accounts

List Wallet Accounts

GET https://nchain.provide.services/api/v1/wallets/:id/accounts

Retrieves a list of

Account

instances for a specified

Wallet

Path Parameters

Name	Type	Description
id	string	id of host Wallet

Headers

Name	Type	Description
authorization	string	bearer scoped to an Application , Organization or User

200: OK

[
    {
        "address": "0x65dabEf381CE60CCB0A6D5bEFC7F15bab6CaF107",
        "hd_derivation_path": "m/44'/60'/0'/0/0",
        "private_key": null,
        "public_key": null
    },
    {
        "address": "0x302004DE78B15E575308A4d09de24455c8A49Cef",
        "hd_derivation_path": "m/44'/60'/0'/0/0/0/1",
        "private_key": null,
        "public_key": null
    }
]