Python SDK

This library provides both high-level convenience functions and lower-level components for Tristero's trading platform. You can make spot trades, take leveraged margin positions, and swap assets cross-VM via Feather.

Installation

pip install tristero

How it works

Tristero supports two primary swap mechanisms:

Permit2 Swaps (EVM-to-EVM)

Quote & Approve - Request a quote and approve tokens via Permit2 (gasless approval)
Sign & Submit - Sign an EIP-712 order and submit for execution
Monitor - Track swap progress via WebSocket updates

private_key = os.getenv("TEST_ACCOUNT_PRIVKEY")
w3 = make_async_w3(os.getenv("ARB_RPC_URL"))
account = Account.from_key(private_key)

result = await execute_permit2_swap(
    w3=w3,
    account=account,
    src_t=TokenSpec(
      chain_id=ChainID(42161),
      token_address="0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
    ),  # USDC (Arbitrum)
    dst_t=TokenSpec(
      chain_id=ChainID(8453),
      token_address="0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2"
    ),  # USDT (Base)
    raw_amount=1_000_000,  # 1 USDC (6 decimals)
    timeout=300,
)
print(result) # Print the result if the trade succeeded

Feather Swaps (Cross-VM)

Quote & Deposit - Request a quote to receive a deposit address
Manual Transfer - Send funds to the provided deposit address
Monitor - Track swap completion via WebSocket updates

This example makes a swap from Ethereum to Bitcoin:

src_t = TokenSpec(chain_id=ChainID.ethereum, token_address="native")
dst_t = TokenSpec(chain_id=ChainID.bitcoin, token_address="native")
dst_addr = "YOUR_BTC_ADDRESS"

swap = await start_feather_swap(
    src_t=src_t,
    dst_t=dst_t,
    dst_addr=dst_addr,
    raw_amount=1e17,
)

order_id = swap.data['id']
if not order_id:
    raise RuntimeError(f"Feather swap response missing order id: {swap.data}")

print("deposit_address:", swap.deposit_address)
print("Waiting for completion...")
async for update in wait_for_completion(order_id, order_type=OrderType.FEATHER):
    print(update) # Iterate over order update events

Examples

It may be easiest to learn how to use the SDK by viewing the Examples page.

Overview