orion-finance-sdk-py 1.3.0

A Python SDK for interacting with Orion Finance smart contracts

About

A Python Software Development Kit (SDK) to facilitate interactions with the Orion Finance protocol. This repository provides tools and utilities for quants and developers to seamlessly integrate with Orion's on-chain portfolio management infrastructure.

For comprehensive documentation, including setup guides, API references, and developer resources, visit sdk.orionfinance.ai.

License

This software is distributed under the BSD-3-Clause license. See the LICENSE file for the full text.

Setup for Development

If you're working on the SDK itself:

# Clone the repository
git clone https://github.com/OrionFinanceAI/orion-finance-sdk-py.git
cd orion-finance-sdk-py

# Install dependencies
make uv-download
make venv
source .venv/bin/activate
make install

# Run tests (includes coverage)
make test

# Run code style checks
make codestyle

# Run docstring checks
make docs

Installation from PyPI

For end users, install the latest stable version from PyPI:

pip install orion-finance-sdk-py

Environment Variables Setup

The SDK uses RPC_URL from your .env if set; otherwise it uses a default public RPC. See SDK Installation for optional RPC setup.

Additional variables depend on what you do:

• Deploy a vault: STRATEGIST_ADDRESS, MANAGER_PRIVATE_KEY
• Submit orders: ORION_VAULT_ADDRESS, STRATEGIST_PRIVATE_KEY
• Update strategist / fee model / deposit access: ORION_VAULT_ADDRESS, MANAGER_PRIVATE_KEY

Examples of Usage

The SDK supports transparent Orion vaults: deploy, read state, submit order intents, and manage fees/strategist via the CLI or Python API.

List available commands

orion --help
orion deploy-vault --help
orion submit-order --help

Deploy a new Orion vault

orion deploy-vault --strategist-address 0x... --name "Algorithmic Liquidity Provision & Hedging Agent" --symbol "ALPHA" --fee-type hard_hurdle --performance-fee 10 --management-fee 1

Submit an order intent to a vault

submit-order accepts --order-intent (alias --order-intent-path):

• File: .json (object mapping addresses → weights that sum to 1), .csv / .parquet (tabular; see docs)
• Inline: a JSON object or Python dict literal string (no file needed)

# From a JSON file
echo '{"0x...": 0.4, "0x...": 0.2, "0x...": 0.15, "0x...": 0.15, "0x...": 0.1}' > order_intent.json
orion submit-order --order-intent order_intent.json

# Inline
orion submit-order --order-intent '{"0x...": 0.4, "0x...": 0.6}'

Parquet support requires pyarrow (pip install 'orion-finance-sdk-py[parquet]' or it is included in the dev extra).

Update the strategist address for a vault

orion update-strategist --new-strategist-address 0x...

Update the fee model for a vault

orion update-fee-model --fee-type high_water_mark --performance-fee 5.5 --management-fee 0.1