---
id: aptos-sdk
version: "0.11.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aptos-sdk — Aptos SDK

License: permissive · Maintenance: active · Downloads: 99.1K/mo

## What it is and what it does

Aptos SDK is a Python library for building applications that interact with the Aptos blockchain. It provides async and sync clients for submitting transactions, querying account state, and interacting with smart contracts deployed on Aptos. The package wraps HTTP and GraphQL communication with the Aptos network, handling cryptographic signing via ecdsa and PyNaCl, and serialization of Move contract calls.

The SDK is actively maintained but explicitly noted as still in development and not recommended for production use. The sync client is deprecated in favor of async-only development. It requires Python 3.9 or later and depends on standard HTTP/crypto libraries (httpx, ecdsa, PyNaCl) plus graphql-client for indexer queries.

Use it for:

- Build a Python bot or service that submits transactions to Aptos mainnet or testnet
- Query account balances, transaction history, and smart contract state via GraphQL indexer
- Integrate Aptos blockchain functionality into a larger Python application or web service
- Automate Move contract deployments and function calls from Python scripts
- Test Aptos smart contracts locally using the SDK against a local testnet

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python bindings to interact with the Aptos blockchain, enabling transaction submission, account management, and on-chain data queries through async and sync clients.

Yes, with conditions. Install if you are building on Aptos and need a Python client—the low install friction, active maintenance, and permissive license support that. Do not install for production systems yet; the package is explicitly in development. Avoid the deprecated sync client; use async only for new projects.

## Install

pip install aptos-sdk
uv add aptos-sdk
poetry add aptos-sdk

## Installing aptos-sdk

Before you install: Low install friction with a pure Python wheel and stable active maintenance. Last commit 2026-08-14 with 6439 repository stars. Note that the sync client is deprecated; new projects should use the async client only.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions, typical for blockchain SDKs.

Quickstart:

pip install aptos-sdk

from aptos_sdk.async_client import AsyncClient

client = AsyncClient("https://api.testnet.aptos.dev/v1")
# Use client to submit transactions or query state

Requires Python 3.9 or later. Local testnet integration requires Aptos CLI and environment variables (APTOS_NODE_URL, APTOS_FAUCET_URL, etc.) for end-to-end testing.

Verify before relying:

- Whether async client is production-ready or still in development like the sync client
- Specific Aptos node version compatibility requirements beyond Python version
- Performance characteristics for high-throughput transaction submission

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 99.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aptos blockchain python client, web3 sdk aptos, aptos transaction submission, blockchain interaction python, aptos account management, aptos graphql queries, aptos move contract interaction, blockchain, web3, async-first

[View on SkillFed](https://skillfed.io/packages/aptos-sdk) · [View on PyPI](https://pypi.org/project/aptos-sdk/)