Skip to main content

A library for interacting with the cosmos networks

Project description


A python library for interacting with cosmos based blockchain networks

PyPI PyPI - Python Version License
PyPI - Wheel CosmPy sanity checks and tests Download per Month

We recently stopped using the develop branch for feature consolidation and renamed master to main. Please see the Contribution Guides for up-to-date instructions.

To Install

pip3 install cosmpy

Getting Started

Below is a simple example for querying an account's balances:

from cosmpy.aerial.client import LedgerClient, NetworkConfig

# connect to network using default parameters
ledger_client = LedgerClient(NetworkConfig.fetchai_mainnet())

alice: str = 'fetch12q5gw9l9d0yyq2th77x6pjsesczpsly8h5089x'
balances = ledger_client.query_bank_all_balances(alice)

# show all coin balances
for coin in balances:


The full documentation can be found here.


Under the examples directory, you can find examples of basic ledger interactions using cosmpy, such as transferring tokens, staking, deploying and interacting with a smart contract, and performing atomic swaps.


All contributions are very welcome! Remember, contribution is not only PRs and code, but any help with docs or helping other developers solve their issues are very appreciated!

Read below to learn how you can take part in the CosmPy project.

Code of Conduct

Please be sure to read and follow our Code of Conduct. By participating, you are expected to uphold this code.

Contribution Guidelines

Read our contribution guidelines to learn about our issue and pull request submission processes, coding rules, and more.

Development Guidelines

Read our development guidelines to learn about the development processes and workflows.

Issues, Questions and Discussions

We use GitHub Issues for tracking requests and bugs, and GitHub Discussions for general questions and discussion.


The CosmPy project is licensed under Apache License 2.0.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cosmpy-0.9.1.tar.gz (205.7 kB view hashes)

Uploaded source

Built Distribution

cosmpy-0.9.1-py3-none-any.whl (413.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page