Hummingbot Integration Helper#

seesaw-hummingbot-helper is a dependency-light Python package for preparing a Hummingbot integration. It is not a Hummingbot ConnectorBase and has no Hummingbot dependency. It does not provide order tracking, balance polling, network lifecycle, order submission, or cancellation. A production Hummingbot connector does not exist in this repository.

Scope#

Included:

• trading-pair discovery from /api/v1/exchange/symbols
• REST orderbook snapshots from /api/v1/exchange/orderbook/{symbol}
• REST ticker snapshots from /api/v1/exchange/ticker/{symbol}
• local order intents that convert Hummingbot decimal probabilities into Seesaw integer price_bps values

Excluded:

• hosted WebSocket orderbook streaming
• outbound webhooks
• historical data exports
• hosted order placement, signing, or custody

For replayable fills or account events, run a user-owned Solana RPC or stream provider and apply the Trustless Stream Consumer Recipes.

Install From Source#

pip install "git+https://github.com/palominito/seesaw.git#subdirectory=packages/hummingbot-connector"

Example#

from decimal import Decimal

from seesaw_hummingbot import SeesawHummingbotIntegrationHelper

helper = SeesawHummingbotIntegrationHelper()
pairs = helper.trading_pairs(limit=50)
snapshot = helper.order_book_snapshot(pairs[0], depth=25)

intent = helper.build_order_intent(
    trading_pair=pairs[0],
    market_address=snapshot.market_address,
    trade_type="BUY",
    order_type="LIMIT",
    price=Decimal("0.5125"),
    amount=Decimal("1000000"),
    client_order_id="hb-1",
)

intent is not submitted. It is a deterministic handoff object for a wallet-signed Solana transaction builder.

Building a real Hummingbot connector remains external integration work. It would need an owned ConnectorBase, order/balance tracking, network lifecycle, submission and cancellation, plus Hummingbot's connector certification tests.