Placing Your First Trade

pip install turbine-py-client

git clone https://github.com/ojo-network/turbine-py-client.git
cd turbine-py-client
python3 -m venv .venv && source .venv/bin/activate
pip install -e .

from eth_account import Account

acct = Account.create()
print(f"Address: {acct.address}")
print(f"Private Key: {acct.key.hex()}")
# SAVE THESE SECURELY!

TURBINE_PRIVATE_KEY=0xyour_private_key_here
CHAIN_ID=137
TURBINE_HOST=https://api.turbinefi.com

import os
import time
from dotenv import load_dotenv
from turbine_client import TurbineClient, Outcome, Side

# Load environment variables
load_dotenv()

# Initialize client
client = TurbineClient(
    host="https://api.turbinefi.com",
    chain_id=137,  # Polygon mainnet
    private_key=os.getenv("TURBINE_PRIVATE_KEY"),
)

print(f"Connected as: {client.address}")

# Get the current BTC quick market
market = client.get_quick_market("BTC")
print(f"\nMarket: {market.question}")
print(f"Strike Price: ${market.start_price / 1e6:,.2f}")
print(f"Expires: {time.strftime('%H:%M:%S', time.localtime(market.end_time))}")

# Check the current orderbook
orderbook = client.get_orderbook(market.market_id)
if orderbook.bids:
    best_bid = orderbook.bids[0].price / 10000
    print(f"\nBest YES bid: {best_bid:.2f}%")
if orderbook.asks:
    best_ask = orderbook.asks[0].price / 10000
    print(f"Best YES ask: {best_ask:.2f}%")

# Place a limit buy order for YES shares at 45%
order = client.create_limit_buy(
    market_id=market.market_id,
    outcome=Outcome.YES,
    price=450000,      # 45% (price scaled by 1e6)
    size=2_000_000,    # 2 shares (6 decimals)
)

print(f"\nOrder created: {order.order_hash}")

# Submit the order
result = client.post_order(order)
print(f"Order submitted!")
print(f"  Order hash: {result['orderHash']}")
print(f"  Status: {result.get('status', 'pending')}")

# Clean up
client.close()

python first_trade.py

Connected as: 0x1234...

Market: Will BTC be above $97,250 at 15:15:00?
Strike Price: $97,250.00
Expires: 15:15:00

Best YES bid: 48.50%
Best YES ask: 51.20%

Order created: 0xabcd...
Order submitted!
  Order hash: 0xabcd...
  Status: pending

from turbine_client import TurbineClient
import os
from dotenv import load_dotenv

load_dotenv()

client = TurbineClient(
    host="https://api.turbinefi.com",
    chain_id=137,
    private_key=os.getenv("TURBINE_PRIVATE_KEY"),
)

# Get your open orders
orders = client.get_orders(trader=client.address)

print(f"Open orders for {client.address}:")
for order in orders:
    price_pct = order.price / 10000
    shares = order.size / 1_000_000
    filled = order.filled_size / 1_000_000
    side = "BUY" if order.side == 0 else "SELL"
    outcome = "YES" if order.outcome == 0 else "NO"
    
    print(f"\n  {order.order_hash[:10]}...")
    print(f"  {side} {shares:.2f} {outcome} @ {price_pct:.2f}%")
    print(f"  Filled: {filled:.2f} / {shares:.2f}")
    print(f"  Status: {order.status}")

client.close()