Skip to main content
Install the Fireblocks Documentation MCP first. Whether you’re using an AI assistant or not, this makes it easy to search, reference, and keep your Fireblocks work grounded in the official docs. The setup steps are in Getting Started.

​
Overview

A Python developer can use the Fireblocks API easily with the official Python SDK: In this guide, you’ll set up the Fireblocks Python SDK and see an example of a basic API script to create a vault and print its data. Additionally if you are developing on EVM chains - you might be using some of the familiar library, such as web3.py - Fireblocks is well integrated into these libraries as described in the Local JSON RPC guide.

​
Using the Fireblocks SDK

​
Install Python 3.8 or newer

The Fireblocks Python SDK requires Python 3.8 or newer. You can check which version of Python you already have installed with the following command. python --version or python3 --version Learn how to install or update Python to a newer version.

​
Install py-sdk

The Fireblocks Python SDK is open-source and hosted on both GitHub and PIP, the official package repository. Installing the latest SDK is easy with pip: pip install fireblocks

​
Your First Fireblocks Python script!

Use the correct API Base URLMake sure you’re using the correct value for the API base URL for your environment:
from fireblocks.base_path import BasePath
  • For Sandbox workspaces: BasePath.Sandbox
  • For US Mainnet or Testnet workspaces: BasePath.US
  • For EU Mainnet or Testnet workspaces: BasePath.EU
  • For EU2 Mainnet or Testnet workspaces: BasePath.EU2

​
Import

For this basic example, we should import the following from the fireblocks module: 
from fireblocks.client import Fireblocks
from fireblocks.client_configuration import ClientConfiguration
from fireblocks.base_path import BasePath
from fireblocks.models.create_vault_account_request import CreateVaultAccountRequest
from pprint import pprint

​
Load your API Secret and API key

from fireblocks.client import Fireblocks
from fireblocks.client_configuration import ClientConfiguration
from fireblocks.base_path import BasePath
from fireblocks.models.create_vault_account_request import CreateVaultAccountRequest
from pprint import pprint

my_api_key="your_api_key"
with open('your_secret_key_file_path', 'r') as file:
    secret_key_value = file.read()

​
Build the configuration

from fireblocks.client import Fireblocks
from fireblocks.client_configuration import ClientConfiguration
from fireblocks.base_path import BasePath
from fireblocks.models.create_vault_account_request import CreateVaultAccountRequest
from pprint import pprint

my_api_key="your_api_key"
with open('your_secret_key_file_path', 'r') as file:
    secret_key_value = file.read()

configuration = ClientConfiguration(
        api_key=my_api_key,
        secret_key=secret_key_value,
        base_path=BasePath.US
)

​
Create a new vault account

from fireblocks.client import Fireblocks
from fireblocks.client_configuration import ClientConfiguration
from fireblocks.base_path import BasePath
from fireblocks.models.create_vault_account_request import CreateVaultAccountRequest
from pprint import pprint

my_api_key="your_api_key"
with open('your_secret_key_file_path', 'r') as file:
    secret_key_value = file.read()

configuration = ClientConfiguration(
        api_key=my_api_key,
        secret_key=secret_key_value,
        base_path=BasePath.Sandbox
)

with Fireblocks(configuration) as fireblocks:
    create_vault_account_request: CreateVaultAccountRequest = CreateVaultAccountRequest(
                                    name='My First Vault Account',
                                    hidden_on_ui=False,
                                    auto_fuel=False
                                    )
    try:
        # Create a new vault account
        future = fireblocks.vaults.create_vault_account(create_vault_account_request=create_vault_account_request)
        api_response = future.result()  # Wait for the response
        print("The response of VaultsApi->create_vault_account:\n")
        pprint(api_response.data.to_json())
    except Exception as e:
        print("Exception when calling VaultsApi->create_vault_account: %s\n" % e)