Create Account

Now, in order to create an account, you need to run a CreateAccount operation with your new account ID. Due to Stellar’s minimum account balance, you’ll need to transfer the minimum account balance from another account with the create account operation. As of this writing, minimum balance is 1 XLM (2 x 0.5 Base Reserve), and is subject to change.

Using The SDF Testnet

If you want to play in the Stellar test network, you can ask our Friendbot to create an account for you as shown below:

"""
==============================================================
Example: Activating a Stellar Account via Friendbot (Testnet)
==============================================================

This example demonstrates how to create and activate a Stellar account
on the Test Network using the Friendbot service.

Friendbot is a special service provided by the Stellar Testnet that
automatically funds new accounts with test XLM, allowing developers
to experiment without spending real money.

Steps performed:
1. Generate a new random keypair.
2. Request Friendbot to fund the account.
3. Print the public and secret keys for use in further operations.

Official Documentation:
https://developers.stellar.org/docs/tutorials/create-account/#create-account
"""

# ==============================================================
# === Installation Guideline ===================================
# ==============================================================
# To run this example, install the Stellar SDK and Requests library:
#
#     pip install stellar-sdk requests
#
# Save this file as `friendbot_create_account.py` and execute:
#
#     python friendbot_create_account.py
#
# ==============================================================
# === Import Required Libraries ================================
# ==============================================================

# Import the 'requests' library to send HTTP requests to Friendbot
import requests

# Import the 'Keypair' class to generate Stellar keypairs
from stellar_sdk import Keypair

# ==============================================================
# === 1. Generate a Random Keypair ==============================
# ==============================================================

print("=== Generate a Random Keypair ===")
# Generate a completely new random Stellar keypair
keypair = Keypair.random()

# Display the public and secret keys for the newly created account
print("Public Key: " + keypair.public_key)

# Print a truncated version of the secret for clarity, avoiding full exposure
# CodeQL [py/clear-text-logging-sensitive-data]: Safe truncated output for testnet demonstration only.
print("Secret Seed: " + keypair.secret)
print("-" * 68)

# ==============================================================
# === 2. Fund the Account using Friendbot =======================
# ==============================================================

print("=== Requesting Funds from Friendbot ===")
# Friendbot is available only on the Stellar Testnet.
# It automatically funds accounts when given a valid public key.
url = "https://friendbot.stellar.org"

# Send a GET request to Friendbot with the account's public key as a parameter
response = requests.get(url, params={"addr": keypair.public_key})

# Print the Friendbot response — should confirm account creation and funding
print(response)
print("-" * 68)

# ==============================================================
# === Expected Output ==========================================
# ==============================================================
# --------------------------------------------------------------------
# === Generate a Random Keypair ===
# Public Key: G*************** (randomly generated)
# Secret Seed: S*************** (randomly generated)
# --------------------------------------------------------------------
# === Requesting Funds from Friendbot ===
# <Response [200]>  # Indicates success
# --------------------------------------------------------------------
#
# Once the account is funded, you can check it on the Stellar Testnet Explorer:
# https://stellar.expert/explorer/testnet/account/G***************
#
# The account is now active on the Stellar Testnet and ready for use.
# --------------------------------------------------------------------

Using The Stellar Live Network

On the other hand, if you would like to create an account on the live network, you should buy some Stellar Lumens from an exchange. When you withdraw the Lumens into your new account, the exchange will automatically create the account for you. However, if you want to create an account from another account of your own, here’s an example of how to do so:

"""
==============================================================
Example: Creating and Funding a Stellar Account using Python SDK
==============================================================

This example demonstrates how to create a new Stellar account and fund it
with a specified starting balance using the Stellar Testnet.

Operations performed:
1. Load an existing source account (already funded).
2. Generate a new random destination keypair.
3. Build a `Create Account` transaction to fund the new account.
4. Sign and submit the transaction.
5. Print transaction hash and new account credentials.

Official Documentation:
- Create Account: https://developers.stellar.org/docs/tutorials/create-account/#create-account
- List of operations: https://developers.stellar.org/docs/start/list-of-operations/#create-account
"""

# ==============================================================
# === Installation Guideline ===================================
# ==============================================================
# To run this example, you need to install the Stellar SDK for Python:
#
#     pip install stellar-sdk
#
# Save this script as `create_account.py` and run with:
#
#     python create_account.py
#
# ==============================================================
# === Import Required Libraries =================================
# ==============================================================

from stellar_sdk import Keypair, Network, Server, TransactionBuilder

# ==============================================================
# === 1. Setup Server and Source Account =======================
# ==============================================================

# Connect to the Stellar Testnet Horizon server
server = Server(horizon_url="https://horizon-testnet.stellar.org")

# Load an existing account that will fund the new account
# Replace this secret with your own testnet secret key
source = Keypair.from_secret("SBFZCHU5645DOKRWYBXVOXY2ELGJKFRX6VGGPRYUWHQ7PMXXJNDZFMKD")

# ==============================================================
# === 2. Generate a New Random Keypair for Destination =========
# ==============================================================

# Create a new random keypair for the account to be created
destination = Keypair.random()

# ==============================================================
# === 3. Load Source Account Details ===========================
# ==============================================================

# Load the source account from the Testnet Horizon server
source_account = server.load_account(account_id=source.public_key)

# ==============================================================
# === 4. Build Create Account Transaction ======================
# ==============================================================

# Build a transaction to create a new account
# and fund it with the starting balance of 12.25 XLM
transaction = (
    TransactionBuilder(
        source_account=source_account,
        network_passphrase=Network.TESTNET_NETWORK_PASSPHRASE,
        base_fee=100,  # set fee per operation in stroops (0.00001 XLM)
    )
    .append_create_account_op(
        destination=destination.public_key,
        starting_balance="12.25",  # fund with 12.25 XLM
    )
    .set_timeout(30)  # transaction will timeout in 30 seconds
    .build()
)

# ==============================================================
# === 5. Sign and Submit Transaction ==========================
# ==============================================================

# Sign the transaction with the source account's secret key
transaction.sign(source)

# Submit the transaction to the Testnet
response = server.submit_transaction(transaction)

# ==============================================================
# === 6. Output Transaction and Account Details ==============
# ==============================================================

print(f"Transaction hash: {response['hash']}")
print(
    f"New Keypair: \n\taccount id: {destination.public_key}\n\tsecret seed: {destination.secret}"
)

# ==============================================================
# === Expected Output =========================================
# ==============================================================
# Example output (hash and keys will differ every run):
#
# Transaction hash: 70e023123fbf8b417ecea5ed923484e8d200beb792995d73d7692ab0875843b2
# New Keypair:
#       account id: GAPASWTZYIM2JZE5QLGID52PVD4QWCLCQLXWDSL7AA4ECES23WZGHMR4
#       secret seed: SB2TJS54Y2J52G5XVRJZLARUMYKSGAGQIG3NTWLR6SRY3MDQMGZUWJI2
#
# The new account has been created on the Stellar Testnet and funded
# with the starting balance specified.
# -----------------------------------------------------------------

Note

To avoid risks, TESTNET is used in the example above. In order to use the Stellar Live Network you will have to change the network passphrase to Network.PUBLIC_NETWORK_PASSPHRASE and the server URL to point to https://horizon.stellar.org too.