How It Works

Accounts consolidate an Account Holder's asset details such as crypto addresses, investment pool balances, and token balances. Create multiple accounts per Account Holder as needed.

Our system also allows multiple allocations for each asset type, using a default allocation as an initial holding place. For example, a USDC deposit starts in the default USDC allocation and transitions to an Aave allocation for yield generation.

📘
Deposit wallets can be enabled by Conduit admins at the Client level - contact your account rep for details.

Before You Begin

Make sure you've created an Account Holder and noted the id attribute.

Create an Account

📘
Note the response's account id and allocation id for default_pool_usdc for future use.

POST https://sandbox.conduit.financial/accounts

Replace the Account Holder id with your noted one.

{
  "data": {
    "relationships": {
      "account-holders": {
        "data": [
          {"type": "account-holder", "id": "id:ahl:2J8Ocs7KFZJt3CMPi9f0x8UCCQ0"}
        ]
      }
    }
  }
}

{
  "data": {
    "id": "id:acct:2J8Ok1bfIrvpNcX2V8QwDMigUKE",
    "type": "account",
    "attributes": {
      "balances": {
        "available": [
          {
            "assetType": "asset:eth:USDC",
            "amount": "0"
          }
        ],
        "pending": [
          {
            "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": []
      }
    }
  },
  "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:USDC",
              "amount": "0"
            }
          ],
          "pending": [
            {
              "assetType": "asset:eth:USDC",
              "amount": "0"
            }
          ],
          "accruedYield": [
            {
              "assetType": "asset:eth:USDC",
              "amount": "0"
            }
          ]
        }
      }
    }
  ]
}