Backpack Exchange SDK

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Português

A complete Python SDK for the Backpack Exchange API. Supports all 70 API endpoints including REST and WebSocket.

Project Docs

• Changelog
• Security Policy
• Contributing

Features

• Authentication Client: Full access to authenticated endpoints (orders, capital, history, RFQ, strategies)
• Public Client: Access public market data, system status, and trade data
• WebSocket Client: Real-time streaming for market data and account updates
• Complete Coverage: All 70 API endpoints implemented
• Type Hints: Full type annotations for better IDE support
• Enums: Comprehensive enums for type-safe API calls

Installation

pip install backpack-exchange-sdk

Or install from source:

git clone https://github.com/solomeowl/backpack_exchange_sdk.git
cd backpack_exchange_sdk
pip install .

Quick Start

Public Client

from backpack_exchange_sdk import PublicClient

client = PublicClient()

# Get all markets
markets = client.get_markets()

# Get ticker
ticker = client.get_ticker("SOL_USDC")

# Get order book depth
depth = client.get_depth("SOL_USDC")

Authentication Client

from backpack_exchange_sdk import AuthenticationClient

client = AuthenticationClient("<API_KEY>", "<SECRET_KEY>")

# Get account balances
balances = client.get_balances()

# Place an order
order = client.execute_order(
    orderType="Limit",
    side="Bid",
    symbol="SOL_USDC",
    price="100",
    quantity="1"
)

# Get order history
history = client.get_order_history(symbol="SOL_USDC")

Using Enums

from backpack_exchange_sdk import AuthenticationClient
from backpack_exchange_sdk.enums import OrderType, Side, TimeInForce

client = AuthenticationClient("<API_KEY>", "<SECRET_KEY>")

order = client.execute_order(
    orderType=OrderType.LIMIT.value,
    side=Side.BID.value,
    symbol="SOL_USDC",
    price="100",
    quantity="1",
    timeInForce=TimeInForce.GTC.value
)

API Reference

Public Client Methods

Authentication Client Methods

WebSocket Client

from backpack_exchange_sdk import WebSocketClient

# Public streams (no auth required)
ws = WebSocketClient()

# Private streams (auth required)
ws = WebSocketClient(api_key="<API_KEY>", secret_key="<SECRET_KEY>")

# Subscribe to streams
def on_message(data):
    print(data)

ws.subscribe(
    streams=["bookTicker.SOL_USDC"],
    callback=on_message
)

# Private stream example
ws.subscribe(
    streams=["account.orderUpdate"],
    callback=on_message,
    is_private=True
)

Available Enums

from backpack_exchange_sdk.enums import (
    # Order related
    OrderType,          # Limit, Market
    Side,               # Bid, Ask
    TimeInForce,        # GTC, IOC, FOK
    SelfTradePrevention,
    TriggerBy,

    # Market related
    MarketType,         # Spot, Perp
    FillType,
    KlineInterval,

    # Status related
    OrderStatus,
    DepositStatus,
    WithdrawalStatus,

    # And more...
)

Examples

See the examples directory for complete usage examples:

• example_public.py - Public API examples
• example_authenticated.py - Authenticated API examples
• example_websocket.py - WebSocket streaming examples

Documentation

For detailed API documentation, visit the Backpack Exchange API Docs.

Changelog

v1.1.0

• Added 21 new API endpoints (RFQ, Strategy, Prediction Markets, etc.)
• Added 25+ new enum types
• Refactored SDK architecture using mixins
• 100% API coverage (70 endpoints)
• Full type hints support

v1.0.x

• Initial release with basic API support

Support

If this SDK has been helpful, please consider:

1. Using my referral link to register: Register on Backpack Exchange
2. Giving this repo a star on GitHub

License

MIT License