circle-user-controlled-wallets

User-Controlled Wallets API documentation.

API version: 1.0
Package version: 9.6.0

Requirements.

Python 3.9+

Installation

pip install

pip install circle-user-controlled-wallets

Then import the package:

from circle.web3 import user_controlled_wallets

Usage

Generate an API key, if you haven't already, in the Web3 Services Console. This API key will be used for authentication and authorization when making requests to Circle's APIs. API key can be set by environment variable or function parameter

export CIRCLE_WEB3_API_KEY="Your API KEY"

Follow our User-Controlled QuickStart. This step ensures that you fully grasp the concept of Circle's User-Controlled Wallets.
Initiate API client

from circle.web3 import utils

client = utils.init_user_controlled_wallets_client(api_key="Your API KEY")

Interact with the client:

import uuid
from circle.web3 import user_controlled_wallets

# generate a user id
user_id = str(uuid.uuid4())

# create user
api_instance = user_controlled_wallets.UsersApi(client)
try:
    request = user_controlled_wallets.CreateUserRequest(user_id=user_id)
    api_instance.create_user(request)
except user_controlled_wallets.ApiException as e:
    print("Exception when calling UsersApi->create_user: %s\n" % e)

# get user
try:
    response = api_instance.get_user(id=user_id)
    print(response.data)
except user_controlled_wallets.ApiException as e:
    print("Exception when calling UsersApi->get_user: %s\n" % e)

# get user token
try:
    auth_api_instance = user_controlled_wallets.PINAuthenticationApi(client)
    request = user_controlled_wallets.UserTokenRequest.from_dict({"userId": user_id})
    response = auth_api_instance.get_user_token(request)
    print(response)
except user_controlled_wallets.ApiException as e:
    print("Exception when calling PINAuthenticationApi->get_user_token: %s\n" % e)

We recommend reading through the official documentation and QuickStart guides mentioned above to ensure a smooth setup and usage experience.

Configuration

The client accept following configuration parameters:

Option	Required	Description
api_key	Yes	Api Key that is used to authenticate against Circle APIs. Must be provided by ether env variable or function parameter.
host	No	Optional base URL to override the default: https://api.circle.com/v1/w3s.
user_agent	No	Optional custom user agent request header. We will prepend it to default user agent header if provided.

Need help or have questions?

Here are some helpful links, if you encounter any issues or have questions about this SDK:

📖 Getting started: Check out our official User-Controlled Wallets QuickStart.
🎮 Join our Discord Community: Engage, learn, and collaborate.
🛎 Visit our Help-Desk Page: Dive into curated FAQs and guides.
📧 Direct Email: We're always a message away.
📖 Read docs: Check out our developer documentation. Happy coding!

Metadata

Release files for circle-user-controlled-wallets 9.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for circle-user-controlled-wallets 9.6.0
File	Size	Uploaded
circle_user_controlled_wallets-9.6.0.tar.gz	86.9 kB	May 29, 2026	Details

Release files / circle_user_controlled_wallets-9.6.0.tar.gz

Download URL	circle_user_controlled_wallets-9.6.0.tar.gz
Size	86.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`2e377578f8970d6ef87f5ec79c7137bde42295fd234e0fbe48513f0580b8e96a`
BLAKE2b-256 checksum How to use checksums	`a50038bb6a435e43bce62fbbb3f70e2bab34fb8183bf7b761102d939e3927158`
Upload date	May 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.17 {"installer":{"name":"uv","version":"0.11.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`