aptos-sdk
Aptos SDK
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 on this page — 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
aptos-sdk on PyPI
pip
pip install aptos-sdkuv
uv add aptos-sdkpoetry
poetry add aptos-sdkInstalling 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 the current Python release (>=3.9.0) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 10 — ecdsa, python-graphql-client, httpx, PyNaCl, tomli, typing-extensions, behave, types-six, h11, multidict |
| Maintenance | actively maintained — 441 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 99,148/month — #13,039 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: aptos_sdk-0.11.0-py3-none-any.whl
Keywords: web3, sdk, aptos, blockchain
Tags
More Internet packages
Botocore provides low-level, data-driven access…
permissive · top 100 on PyPI
aiobotocoreProvides an async client for AWS services using…
permissive · top 100 on PyPI
pydanticPydantic validates Python data structures…
permissive · top 100 on PyPI
filelockProvides a platform-independent file locking…
permissive · top 100 on PyPI
fastapiFastAPI is a Python web framework for building…
permissive · top 100 on PyPI
googleapis-common-protosProvides common Protocol Buffer message…
permissive · top 100 on PyPI
web3web3.py is a Python library for interacting…
permissive · top 5,000 on PyPI
cdp-sdkPython client library for the Coinbase…
permissive · top 15,000 on PyPI
injective-pyInjective Python SDK provides client libraries…
permissive · top 15,000 on PyPI
bittensorBittensor is a Python SDK and CLI for…
permissive · top 15,000 on PyPI
fireblocks-sdkOfficial Python SDK for the Fireblocks API that…
permissive · top 15,000 on PyPI
solanaSolana.py is a Python SDK for building…
permissive · top 5,000 on PyPI
cosmpyCosmPy provides Python bindings to interact…
permissive · top 15,000 on PyPI
substrate-interfaceInterfaces with Substrate blockchain nodes to…
permissive · top 15,000 on PyPI
LucoPyLucoPy is a Python SDK for interacting with the…
permissive · top 15,000 on PyPI
fireblocksPython SDK for integrating with the Fireblocks…
permissive · top 15,000 on PyPI