Orion Finance SDK#

Python SDK and CLI for Orion’s on-chain portfolio management infrastructure: deploy transparent vaults, submit strategist intents, and read protocol state, including the whitelisted investment universe, without leaving Python or the shell.

PyPI: orion-finance-sdk-py
Source: GitHub

What you can do

Install and configure

Install the CLI or package, set environment variables, and connect to an RPC.

Quick start

Deploy and manage vaults

Create transparent vaults, update strategist and fees, verify deployment.

Vault operations

Submit strategist intents

Push rebalancing allocations from JSON, CSV, Parquet, or an inline dict.

Submit rebalancing order intents

Analyze universe and vaults

PIT prices, asset price history, share-price series, and intent vs holdings.

Analytics and reads

Quick start#

CLI

curl -sSfL https://sdk.orionfinance.ai/cli/install.sh | sh
orion --help

Or install from PyPI:

pip install "orion-finance-sdk-py>=2.0.0"

Python

from orion_finance_sdk_py import OrionConfig

config = OrionConfig()
print(f"Risk-free Rate: {config.risk_free_rate}")

Manager workflow#

Install the SDK (above).
Deploy a vault with orion deploy-vault (managers).
Set strategist if you want to submit intents as the manager (orion update-strategist).
Submit intents with orion submit-intent.

Configure environment#

Create a .env in your project directory. Keep it private and never commit it.

Task	Variables
Deploy / manage a vault	`MANAGER_PRIVATE_KEY`, `ORION_VAULT_ADDRESS` (after deploy)
Submit intents	`ORION_VAULT_ADDRESS`, `STRATEGIST_PRIVATE_KEY`
LP deposit / redeem	`ORION_VAULT_ADDRESS`, `LP_PRIVATE_KEY`
Read vault data	Pass `contract_address=` in Python, or set `ORION_VAULT_ADDRESS`

RPC_URL (optional). If unset, the SDK probes default public Sepolia RPCs (1rpc.io → 0xrpc.io → publicnode → stupidtech), matching install.sh. Set your own endpoint for higher rate limits, other networks, or long historical series.

Getting an RPC URL (optional)#

An RPC URL is the HTTP endpoint the SDK uses to talk to the chain. Popular options:

Alchemy: create an app → Ethereum / Sepolia → copy the HTTP URL → RPC_URL=https://eth-sepolia.g.alchemy.com/v2/YOUR_API_KEY
Infura: create a project → Sepolia → copy the HTTPS endpoint → RPC_URL=https://sepolia.infura.io/v3/YOUR_API_KEY

Vault operations#

Managers create transparent or encrypted vaults with the CLI.

Deploy a vault#

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

Use --vault-type encrypted for confidential vaults (intents sealed with Orion HPKE). Default is transparent.

This deploys an ERC-7540 vault, registers the manager from your .env, and sets fees.

Verify: the CLI prints the vault contract address - store it and share it with LPs. Set ORION_VAULT_ADDRESS for later commands.

Update strategist or fees#

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

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

LP deposit / redeem#

orion request-deposit --assets 1000000
orion cancel-deposit-request --amount 1000000
orion request-redeem --shares 500000
orion cancel-redeem-request --shares 500000
# After full decommission only:
orion redeem --shares 500000 --receiver 0x... --owner 0x...

Remove / decommission vault (manager)#

orion remove-vault

Submit rebalancing order intents#

Strategists (or managers who set themselves as strategist) submit portfolio allocation intents executed on the next rebalancing cycle.

--order-intent (alias --order-intent-path) accepts a file or an inline string:

JSON file: object mapping token addresses → weights (fractions summing to 1).
CSV / Parquet: tabular; Parquet needs pyarrow (pip install 'orion-finance-sdk-py[parquet]').
Inline: JSON object or Python dict literal.

orion submit-intent --order-intent order_intent.json

orion submit-intent --order-intent '{"0x...": 0.5, "0x...": 0.5}'

Intents are collected and executed at the next rebalance (bundling, batching, netting).

Portfolio file schema#

Column Name	Type	Description
`address`	string	Token contract address (checksummed).
`percentage_of_tvl`	decimal	Percentage of total vault value to allocate (0-100).

Aliases: token / addr for address; weight, value, or percentage for weights. Columns named percentage_of_tvl / percentage are treated as 0–100 and normalized to fractions.

Example intent:

{
  "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48": 0.5,
  "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2": 0.3,
  "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599": 0.2
}

Note: On transparent vaults, intents are visible onchain after submission. Confidential vault intents are sealed with Orion HPKE before submission, the chain stores an opaque OrionCiphertext:

0x693658254630f73ad8da78fb331bf976cd42f90e0e9c9e83f40c51072a6f7417
bdb98ee21c5fbd63b638e332a609dad2c433b7dddcadec1f43586b8df178c488
01bc357ad2b6b530cfd9d63a8da1e0506ad748b7445373c5028131d0133fd503
172331decd5b2c69027a78699d713bb7426278f5cfa7754cb9e608f8cac946be
f38dd79d43391007eb7e87cca2a60b9e8ba869ae6dcdeb9289a09fa9748fc6a7
57160df5b25eb1fab133b18d11865a12f04a6ba70fa9a7f6c1dcf32fdffcabda
cd028fb3317650842264ba149850c24af40f1351564153ed0e0e00594caf6cef
a9981d8f622a44fe2c905be117a8d6a9c2cb51e787d6b27a7676bf6ccb89ed42
e3b8d9b4c24e887030a7caf503ba52d1d44510f73f5e7d30a396b4662a409178
234f21d6d9a3a1256b7ae0aac3a31c5f5242a66db00495f1a46f8d171dd7be9d
60d6dbaf04562614a8176738d66cf746101efeb2721f44ff2ed3ed3c3a1882ac
cbee5712dff0103eca8470ee5774e02e

Analytics and reads#

Point-in-time prices and portfolio weights#

Point-in-time oracle prices for the investment universe, combined with vault holdings for portfolio weights:

from orion_finance_sdk_py import (
    OrionTransparentVault,
    PriceAdapterRegistry,
)

registry = PriceAdapterRegistry()
prices = registry.get_prices()  # address -> price for every whitelisted asset

vault = OrionTransparentVault()  # or OrionTransparentVault(contract_address="0x...")
portfolio = vault.get_portfolio()  # address -> shares
pct_tvl = vault.get_portfolio_pct_tvl()  # address -> weight (sums to ~1)
pit_tvl = vault.point_in_time_total_assets()
share_price = vault.share_price  # value of 1 full share in underlying units

PriceAdapterRegistry is resolved from OrionConfig.price_adapter_registry. Pass assets= to get_prices to price a subset.

Investment universe price history#

Screen whitelisted assets before deploying a vault - daily PIT prices from the adapter registry:

from datetime import datetime, timezone, timedelta

from orion_finance_sdk_py import OrionConfig, PriceAdapterRegistry

config = OrionConfig()
registry = PriceAdapterRegistry()
end = datetime.now(timezone.utc)
start = end - timedelta(days=30)
series = registry.price_history(start=start, end=end)
# [{"timestamp": int, "block": int, "prices": {addr: int, ...}}, ...]

# Optional subset:
# series = registry.price_history(
#     start=start, end=end, assets=config.whitelisted_assets[:3]
# )

For long series, set a dedicated RPC_URL - public endpoints are rate-limited.

Vault metadata and strategist intent#

from orion_finance_sdk_py import OrionConfig, OrionTransparentVault

config = OrionConfig()
for addr in config.orion_transparent_vaults:
    vault = OrionTransparentVault(contract_address=addr)
    print(vault.name, vault.symbol, vault.decimals)
    print(vault.manager_address, vault.strategist_address)
    intent = vault.get_intent()  # address -> fraction (sum ≈ 1); {} if unset
    current = vault.get_portfolio_pct_tvl()
    # Diff intent vs current to reason about expected rebalancing

get_intent() scales on-chain weights by OrionConfig.strategist_intent_decimals so they match the fractional weights used when submitting intents.

API reference#

API Reference