API Deprecations

We try very hard to maintain backward compatibility with our schema but occasionally we need to deprecate some parts to streamline our code base and to make way for new features. We will always try to give as much notice as possible with changes like these.

If you have any concerns or queries regarding the changes please feel free to reach out to us through chat or email us at help@bitpandacustody.com and we will be happy to answer any queries you may have.

Deprecated as of 27th March 2025

The balances endpoint uses an internal list of assets to return balances which only returns a limited number of assets. The new property balance will allow you to specify an asset (contract address) and a chainId. If the chain is available in the TrustVault system, the balance will be returned.

Deprecated New
BlockChainSubWallet.balances subWallet.balance

Deprecated as of January 2023 (COMPLETED)

We have removed the old csv request and made it a mutation that will email results. This was to allow for longer processing time to generate the report of larger data.

Deprecated New
user.requestCsvTransactions mutation requestCsvTransactions
user.getCsvTransactions mutation requestCsvTransactions
subwallet.requestCsvTransactions mutation requestCsvTransactions

Deprecated as of 13th June 2023 (COMPLETED)

We have been phasing out support for binance chain for the past year and as of the 13th June 2023 we will completely remove support. Please note this will not affect Binance Smart Chain which is still fully supported.

Deprecated as of 1st March 2023 (COMPLETED)

The following items in the schema will be deprecated and no longer supported from 1st March 2023, below you can find examples of some of the migrations.

Inputs

Deprecated New
CreateBitcoinAddressInput.subWalletId CreateBitcoinAddressInput.subWalletIdString
CreateBitcoinTransactionParams.fromSubWalletId CreateBitcoinAddressInput.subWalletId

Responses

Deprecated New
CreateEthereumTransactionResponse.transactionId CreateEthereumTransactionResponse.requestId
CreateEthereumTransactionResponse.trustVaultTransactionId CreateEthereumTransactionResponse.requestId
CreateXdcNetworkTransactionResponse.transactionId CreateXdcNetworkTransactionResponse.requestId
CreateBitcoinTransactionIdResponse.transactionId CreateBitcoinTransactionIdResponse.requestId
RequestItem.signature RequestItem.signatures

Types

Deprecated New
UserWallet User
User.wallets User.walletsInfo
User.wallet User.walletsInfo
UserWallet.getAccounts User.walletsInfo
UserWallet.getTransactionInfo transactionInfo
SubWallet.id SubWallet.subWalletId
BitcoinPublicKeyProvenance.accountHSMProvenanceSignature BitcoinPublicKeyProvenance.trustVaultProvenanceSignature
WalletConnection.allWalletsPortfolio User.portfolio
SubWalletConnection.allSubWalletsPortfolio User.portfolio

Examples

Migration from user.wallets to user.walletsInfo.

OldQuery
Copy
Copied
query {
  user {
    wallets {
      items {
        id # Referenced as walletId in walletsInfo
        address # subwallet address now has to be retrieved by querying user.subWallets or user.subWallet
        walletType # walletType exposed through user.subWallets or user.subWallet
        name # subwallet name exposed through user.subWallets or user.subWallet
        createdAt # subwallet createdAt exposed through user.subWallets or user.subWallet
        updatedAt # subwallet updatedAt exposed through user.subWallets or user.subWallet
        subWalletId {  # subWalletId exposed through user.subWallets or user.subWallet as a string (subWalletId)
          id
          index
          type
        }
        subWalletIdString  # subWalletId exposed through user.subWallets or user.subWallet as a subWalletId 
      }
    }
  }
}
NewQuery
Copy
Copied
query {
  user {
    walletsInfo{
      items {
        deleted
        walletId
        walletName
        subWalletsSummary {
          subWalletType
          deleted
          count
        }
      }
      nextToken
    }
  }
}

Migration from WalletConnection.allWalletsPortfolio to User.portfolio

OldQuery
Copy
Copied
  query {
    user {
      wallets {
        allWalletsPortfolio {
          total {
            **value**
            currency
            timestamp
          }
          balances {
            items {
              amount {
                value
                currency
                ...
              }
              asset {
                name
                symbol
                ...
              }
            }
          }
        }
      }
    }
  }
NewQuery
Copy
Copied
  query {
    user {
      portfolio {
        items {
          total {
            value
            currency
            timestamp
          }
          balances {
            items {
              amount {
                value
                currency
                ...
              }
              asset {
                displaySymbol
                name
                ...
              }
            }
          }
        }
      }
    }
  }