DriftPy

DriftPy is the Python client for the Drift protocol. It allows you to trade and fetch data from Drift using Python.

Read the full SDK documentation here!

Installation

pip install driftpy

Note: requires Python >= 3.10.

⚠️ IMPORTANT ⚠️

If you are using QuickNode free plan, you must use AccountSubscriptionConfig("demo"), and you can only subscribe to 1 perp market and 1 spot market at a time.

Non-QuickNode free RPCs (including the public mainnet-beta url) can use cached as well.

Example setup for AccountSubscriptionConfig("demo"):

    # This example will listen to perp markets 0 & 1 and spot market 0
    # If you are listening to any perp markets, you must listen to spot market 0 or the SDK will break

    perp_markets = [0, 1]
    spot_market_oracle_infos, perp_market_oracle_infos, spot_market_indexes = get_markets_and_oracles(perp_markets = perp_markets)

    oracle_infos = spot_market_oracle_infos + perp_market_oracle_infos

    drift_client = DriftClient(
        connection,
        wallet, 
        "mainnet",             
        perp_market_indexes = perp_markets,
        spot_market_indexes = spot_market_indexes,
        oracle_infos = oracle_infos,
        account_subscription = AccountSubscriptionConfig("demo"),
    )
    await drift_client.subscribe()

If you intend to use AccountSubscriptionConfig("demo), you must call get_markets_and_oracles to get the information you need.

get_markets_and_oracles will return all the necessary OracleInfos and market_indexes in order to use the SDK.

SDK Examples

examples/ folder includes more examples of how to use the SDK including how to provide liquidity/become an lp, stake in the insurance fund, etc.

Setting Up Dev Env

bash setup.sh

Building the docs

Local Docs: mkdocs serve

Updating public docs: poetry run mkdocs gh-deploy --force

Releasing a new version of the package

python new_release.py
Create a new release at https://github.com/drift-labs/driftpy/releases.
- (The CI process will upload a new version of the package to PyPI)

Development

Ensure correct python version (using pyenv is recommended):

pyenv install 3.10.11
pyenv global 3.10.11
poetry env use $(pyenv which python)

Install dependencies:

poetry install

Run tests:

poetry run bash test.sh

Run Acceptance Tests

poetry run bash acceptance_test.sh

Metadata

Release files for driftpy 0.7.48

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for driftpy 0.7.48
File	Size	Uploaded
driftpy-0.7.48.tar.gz	136.3 kB	Apr 11, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for driftpy 0.7.48
File	Interpreter	ABI	Platform	Reset
driftpy-0.7.48-py3-none-any.whl 167.5 kB Apr 11, 2024	Python 3	none	any	Details

Total release size: 303.8 kB

Release files / driftpy-0.7.48.tar.gz

Download URL	driftpy-0.7.48.tar.gz
Size	136.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`915bea3cbdca03fe63ff2afbfb8675c31930fff4feca68e313c00265bb92f7ec`
BLAKE2b-256 checksum How to use checksums	`707c36704295b41349983f4c09cf7302d3be27207fe7b028b3e62f90ca41f91a`
Upload date	Apr 11, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.4.2 CPython/3.10.10 Linux/6.5.0-1017-azure`

Release files / driftpy-0.7.48-py3-none-any.whl

Download URL	driftpy-0.7.48-py3-none-any.whl
Size	167.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`fccd4827caa171a08ee205d723b12b2eabf6e13da2e2b5a882b64443408097aa`
BLAKE2b-256 checksum How to use checksums	`28d280b0461024d23d5f3afb1cc8608e747838f50d564b86a512bfdb89076381`
Upload date	Apr 11, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.4.2 CPython/3.10.10 Linux/6.5.0-1017-azure`