Smart Wallets FAQs

Use these answers to enable Smart Wallets, choose a plan, and integrate the beta service with your existing Tatum API key.

What are Smart Wallets?

Smart Wallets is Tatum's MPC-based custodian wallet service, currently in beta. You can create and manage end-user wallets server-side through the Tatum Wallet SDK and the /v4/wallets API, including client creation, sessions, wallet generation, transaction signing, and backup and recovery, without handling raw private keys.

Why do I get wallets.custodian.api.key.missing when calling /v4/wallets/clients?

This error means Smart Wallets is not enabled for your account. During the beta, access is not granted automatically: your regular RPC and Data API access continues to work, but custodian endpoints such as GET /v4/wallets/clients and custodian.createClient return this error until Smart Wallets is activated.

Contact [email protected] from the email associated with your Tatum account and request Smart Wallets activation.

How do I get access to Smart Wallets?

During the beta, the Tatum team activates Smart Wallets manually:

1. Move your account to the Pay-as-you-go plan or higher. Smart Wallets is not available on the Free plan.
2. Email [email protected] and request Smart Wallets access.
3. Wait for activation, which takes up to four hours after your request.

Is Smart Wallets available on the Free plan?

No. Smart Wallets requires the Pay-as-you-go plan or higher. A qualifying plan does not enable the feature automatically during the beta, so you must also contact [email protected] to activate it.

Once activated, is the full feature set enabled?

Yes. Activation enables the complete custodian surface for your account, including custodian.createClient, sessions, wallet generation, transaction signing, and backup and recovery.

Which chains are supported? Can I use testnets?

Smart Wallets supports more than 13 chains. You can use the networks that fit your project, including testnets such as Ethereum Sepolia and Base Sepolia during development.

Do I need a separate API key for the Wallet SDK?

No. Smart Wallets uses your existing Tatum API key in the Wallet SDK. After activation, you can use the same key for the custodian endpoints that you use for RPC and Data API access.

What are the wallet, signing, and transaction limits?

Smart Wallets has no hard limits on wallets, signing operations, or transactions. Each operation consumes credits through Tatum's standard credit system, so maintain a sufficient credit balance for the operations you run.

Is there a sandbox or free trial environment?

No. Smart Wallets requires the Pay-as-you-go plan or higher. To test an integration, use testnets, operations still consume credits, but you do not send/use mainnet funds.

How long does activation take, and what do you need from me?

After you contact [email protected], activation takes a maximum of four hours. You do not need to provide onboarding information beyond the details associated with your account.