Injective Python SDK
Dependencies
Ubuntu
sudo apt install python3.X-dev autoconf automake build-essential libffi-dev libtool pkg-config
Fedora
sudo dnf install python3-devel autoconf automake gcc gcc-c++ libffi-devel libtool make pkgconfig
macOS
brew install autoconf automake libtool bufbuild/buf/buf
Quick Start
Installation
pip install injective-py
Usage
Requires Python 3.9+
Please install poetry following the steps described in the documentation
$ poetry install
# connecting to Injective Exchange API
# and listening for new orders from a specific spot market
$ poetry run python examples/exchange_client/spot_exchange_rpc/8_StreamOrderbookUpdate.py
# sending a msg with bank transfer
# signs and posts a transaction to the Injective Chain
$ poetry run python examples/chain_client/bank/1_MsgSend.py
Upgrade pip to the latest version, if you see these warnings:
WARNING: Value for scheme.platlib does not match. Please report this to <https://github.com/pypa/pip/issues/10151>
WARNING: Additional context: user = True home = None root = None prefix = None
Development
- Generate proto binding & build
make gen
poetry build
- Install pkg
# from local build
pip uninstall injective-py
pip install injective-py --no-index --find-links /path/to/injective/sdk-python/dist
# from pypi
pip uninstall injective-py
pip install injective-py
- Run all unit tests in a development environment
poetry run pytest -v
Maintainers: see MAINTAINERS.md for how to regenerate proto bindings, refresh
pyinjective/ofac.json, and cut a new release.
Async client (exchange V2)
The Injective Python SDK exposes AsyncClient from the async_client_v2 module:
- Import using:
from pyinjective.async_client_v2 import AsyncClient - Example:
from pyinjective.async_client_v2 import AsyncClient
from pyinjective.network import Network
async def main():
client = AsyncClient(network=Network.mainnet())
# Or use testnet
# client = AsyncClient(network=Network.testnet())
Market Format Differences:
- V1 AsyncClient: Markets are initialized with values in chain format (raw blockchain values)
- V2 AsyncClient: Markets are initialized with values in human-readable format (converted to standard decimal numbers)
Exchange Endpoint Format Differences:
- V1 Exchange endpoints: All values (amounts, prices, margins, notionals) are returned in chain format
- V2 Exchange endpoints:
- Human-readable format for: amounts, prices, margins, and notionals
- Chain format for: deposit-related information (to maintain consistency with the Bank module)
Important Note: The ChainClient (V1) will not receive any new endpoints added to the Exchange module. If you need access to new exchange-related endpoints or features, you should migrate to the V2 client. The V2 client ensures you have access to all the latest exchange functionality and improvements.
License
Copyright © 2021 - 2026 Injective Labs Inc. (https://injectivelabs.org/)
Originally released by Injective Labs Inc. under:
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
2 maintainers
Release files for injective-py 1.16.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| injective_py-1.16.2.tar.gz | 646.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| injective_py-1.16.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.8 MB
Release files / injective_py-1.16.2.tar.gz
| Download URL | injective_py-1.16.2.tar.gz |
|---|---|
| Size | 646.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3acf917d20316eeda150b023e573aed42ebf703b9b90929a5e8889c8e9714e8a
|
|
BLAKE2b-256 checksum How to use checksums |
91b20de53daf2522de3d4501ed5ef26fb8e9634f8aec6530be5714eb5a226368
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.5.1 CPython/3.12.3 Linux/6.17.0-1022-azure
|
Release files / injective_py-1.16.2-py3-none-any.whl
| Download URL | injective_py-1.16.2-py3-none-any.whl |
|---|---|
| Size | 1.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8aacf4e628cefb5091c701855ac64f0ec3e12b8c23bfe85b91d965edf9e2f9b3
|
|
BLAKE2b-256 checksum How to use checksums |
d6eb0cfab54e116152ad021222c36e4d8067a6193c7735e54cfb64429511a26a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.5.1 CPython/3.12.3 Linux/6.17.0-1022-azure
|
