API Reference

The Sandbox Interface

All trading operations go through a unified interface (SandboxBase). Whether you are backtesting or live trading, the API is identical.

Category	Functions
Account	get_spot_summary(), get_perp_summary(), get_perp_position(asset)
Trading	buy(asset, qty, price), sell(asset, qty, price)
Futures	long(asset, qty, price), short(asset, qty, price), reduce_position(asset, qty)
Leverage	set_leverage(asset, leverage)
Price	get_perp_price(asset), get_spot_price(asset)
OHLCV	get_spot_ohlcv(asset, interval, limit), get_futures_ohlcv(asset, interval, limit)
Funding	get_funding_rate(asset), get_funding_rate_history(asset, limit)
OI	get_open_interest(asset), get_open_interest_history(asset, limit)
Orders	get_perp_open_orders(), get_spot_open_orders(), cancel_perp_orders(asset, ids)
Time	get_current_time()

Package Modules

import vibetrading.strategy   # generate & validate strategies from prompts
import vibetrading.backtest   # backtest engine (BacktestEngine, run())
import vibetrading.sandbox    # exchange sandboxes & live runner
import vibetrading.tools      # data download & CSV loading
import vibetrading.models     # order & position data models

Architecture

User Prompt (natural language)
         │
         ▼
┌─────────────────────────┐
│   LLM Agent             │  ← any model (GPT, Claude, Gemini, ...)
│   + prompt template     │  ← vibetrading.strategy.STRATEGY_SYSTEM_PROMPT
└────────┬────────────────┘
         │ generates
         ▼
Strategy Code (@vibe decorated)
         │
         ▼
┌─────────────────────────┐
│   vibetrading module    │  ← runtime-injected API
│   (mock namespace)      │
└────────┬────────────────┘
         │
    ┌────┴────┐
    ▼         ▼
Backtest    Live
Engine      Runner
    │         │
    ▼         ▼
Static     Exchange
Sandbox    Sandbox
    │      (Hyperliquid, Paradex,
    ▼       Extended, Lighter, ...)
vibetrading.tools
(CCXT → CSV cache)

Project Structure

vibetrading/
├── __init__.py         # Package root (vibe decorator + version)
├── strategy.py         # → vibetrading.strategy (generate, validate, prompts)
├── backtest.py         # → vibetrading.backtest (BacktestEngine, run())
├── sandbox.py          # → vibetrading.sandbox (SandboxBase, LiveRunner, create)
├── tools.py            # → vibetrading.tools (download_data, load_csv)
├── models.py           # → vibetrading.models (order & position types)
├── _config.py          # Configuration & exchange registry
├── _agent/             # Strategy generation internals
├── _core/              # Core engine internals
├── _exchanges/         # Exchange adapters
├── _models/            # Data models
├── _metrics/           # Performance metrics
├── _tools/             # Data acquisition internals
└── _utils/             # Utilities