Wallets

Learn how to create deposit wallets for accounts to be able to receive crypto deposits.

Before You Begin

Make sure you've created an account and noted down the id attribute.

Create a Wallet

1. Make a POST request to https://sandbox.conduit.financial/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/wallets with the following body but replace the Account Holder id with the one you noted down:

Copy

Copied

{
  "data": {
    "attributes": {
      "assetType": "asset:eth:USDC",
      "function": "deposit"
    }
  }
}

2. If successful, you will see a similar response from the API.

Copy

Copied

{
  "data": {
    "id": "id:wlt:2MW2qbpfnXZoUDUd7L2v1UQJuyQ",
    "type": "wallet",
    "attributes": {
      "address": "wlt:eth:0x44a8938044c8f1a2cfd6ff7e66a46482377fa390",
      "assetType": "asset:eth:USDC",
      "networkId": "net:eth:ropsten",
      "function": "deposit"
    }
  }
}

Check Account

Now that the wallet has been created, let's verify that it has been added to the account.

1. Make a Get request to https://sandbox.conduit.financial/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE but make sure to replace the account id with the one you noted down and if successful, you will see a similar response from the API:

Tip

Note down the address attribute (e.g. 0x44a8938044c8f1a2cfd6ff7e66a46482377fa390) to be used for depositing crypto.

Copy

Copied

{
  "data": {
    "id": "id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE",
    "type": "account",
    "attributes": {
      "balances": {
        "available": [
          {
            "assetType": "asset:eth:ETH",
            "amount": "0"
          },
          {
            "assetType": "asset:eth:USDC",
            "amount": "0"
          }
        ],
        "pending": [
          {
            "assetType": "asset:eth:ETH",
            "amount": "0"
          },
          {
            "assetType": "asset:eth:USDC",
            "amount": "0"
          }
        ]
      }
    },
    "relationships": {
      "account-holders": {
        "links": {
          "self": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/relationships/account-holders",
          "related": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/account-holders"
        },
        "data": [
          {
            "id": "id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0",
            "type": "account-holder"
          }
        ]
      },
      "allocations": {
        "links": {
          "self": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/relationships/allocations",
          "first": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/relationships/allocations",
          "next": null,
          "related": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/allocations"
        },
        "data": [
          {
            "id": "id:allc:2J8OkA50iEKCUdAP64xbgU14Irf",
            "type": "allocation"
          }
        ]
      },
      "wallets": {
        "links": {
          "self": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/relationships/wallets",
          "related": "/accounts/id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE/wallets"
        },
        "data": [
          {
            "id": "id:wlt:2MW2qbpfnXZoUDUd7L2v1UQJuyQ",
            "type": "wallet"
          }
        ]
      }
    }
  },
  "included": [
    {
      "id": "id:allc:2J8OkA50iEKCUdAP64xbgU14Irf",
      "type": "allocation",
      "attributes": {
        "effectiveYieldRate": "0",
        "conduitTakeRate": "20",
        "clientTakeRate": "0",
        "poolId": "id:pool:2H1E3EPxcafvzFKOyoLUwO2PfcK",
        "poolYieldRate": "0",
        "accountId": "id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE",
        "poolName": "default_pool_usdc",
        "balances": {
          "available": [
            {
              "assetType": "asset:eth:ETH",
              "amount": "0"
            },
            {
              "assetType": "asset:eth:USDC",
              "amount": "0"
            }
          ],
          "pending": [
            {
              "assetType": "asset:eth:ETH",
              "amount": "0"
            },
            {
              "assetType": "asset:eth:USDC",
              "amount": "0"
            }
          ],
          "accruedYield": [
            {
              "assetType": "asset:eth:USDC",
              "amount": "0"
            }
          ]
        }
      }
    },
    {
      "id": "id:wlt:2MW2qbpfnXZoUDUd7L2v1UQJuyQ",
      "type": "wallet",
      "attributes": {
        "address": "wlt:eth:0x44a8938044c8f1a2cfd6ff7e66a46482377fa390",
        "assetType": "asset:eth:USDC",
        "networkId": "net:eth:ropsten",
        "function": "deposit"
      }
    }
  ]
}

Next Steps

Now that you've successfully created a wallet, let's simulate depositing some crypto.