Python SDK

pip install liquidtrading-python

uv add liquidtrading-python

from liquidtrading import LiquidClient

client = LiquidClient(
    api_key="lq_...",
    api_secret="sk_...",
)

ticker = client.get_ticker("BTC-PERP")
print(ticker.mark_price)

from liquidtrading import LiquidClient

client = LiquidClient(
    api_key="lq_...",
    api_secret="sk_...",
    base_url="https://api.liquid.trade",  # default
    timeout=30.0,                          # seconds
    max_retries=0,                         # retries for GET on 429/5xx
)

# Get all markets
markets = client.get_markets()

# Get ticker
ticker = client.get_ticker("ETH-PERP")
print(f"ETH: {ticker.mark_price} | Funding: {ticker.funding_rate}")

# Get order book
book = client.get_orderbook("BTC-PERP", depth=10)
print(f"Spread: {book.asks[0].price - book.bids[0].price}")

# Get 1h candles
candles = client.get_candles("BTC-PERP", interval="1h", limit=24)

account = client.get_account()
print(f"Equity: {account.equity}")
print(f"Available: {account.available_balance}")

for pos in client.get_positions():
    print(f"{pos.symbol} {pos.side} | PnL: {pos.unrealized_pnl}")

# Market buy with TP/SL
order = client.place_order(
    symbol="BTC-PERP",
    side="buy",
    type="market",
    size=100.0,       # USD notional
    leverage=2,
    tp=72000.0,
    sl=68000.0,
)
print(f"Filled: {order.order_id}")

# Limit sell
limit = client.place_order(
    symbol="ETH-PERP",
    side="sell",
    type="limit",
    size=50.0,
    price=4200.0,
    leverage=3,
)

# Cancel
client.cancel_order(limit.order_id)

# Close entire position
client.close_position("BTC-PERP")

# Partial close (0.025 BTC, not USD)
client.close_position("BTC-PERP", size=0.025)

# Update TP/SL
client.set_tp_sl("BTC-PERP", tp=75000.0, sl=65000.0)

# Change leverage
client.update_leverage("ETH-PERP", leverage=10, is_cross=False)

from liquidtrading import LiquidClient
from liquidtrading.errors import (
    InvalidApiKeyError,
    InvalidSignatureError,
    InsufficientScopeError,
    InsufficientBalanceError,
    OrderRejectedError,
    SymbolNotFoundError,
    RateLimitError,
    ValidationError,
)

client = LiquidClient(api_key="lq_...", api_secret="sk_...")

try:
    client.place_order("BTC-PERP", "buy", size=100, leverage=2)
except InvalidApiKeyError:
    print("Check your API key")
except InvalidSignatureError:
    print("Check your API secret")
except InsufficientScopeError:
    print("Key needs TRADE scope")
except InsufficientBalanceError:
    print("Not enough balance")
except OrderRejectedError as exc:
    print(f"Exchange rejected: {exc.message}")
except SymbolNotFoundError:
    print("Invalid symbol — call get_markets() to list valid symbols")
except RateLimitError as exc:
    print(f"Retry after {exc.retry_after}s")
except ValidationError as exc:
    print(f"Bad request: {exc.message}")