Bitflow Skill

Provides DEX operations on the Bitflow aggregated liquidity protocol:

• Market Data — Ticker prices, volumes, and liquidity for all trading pairs via public API.
• Token Discovery — List available swap tokens, find swap targets for a given token, discover multi-hop routes.
• Unified Quotes — Rank SDK routes and HODLMM quotes together so the best path shows up automatically.
• Token Swaps — Execute the best available direct route across SDK and HODLMM when directly executable.
• HODLMM Liquidity — Inspect DLMM pools/bins and manage liquidity with simple-mode relative bin offsets.
• Keeper Automation — Create, monitor, and cancel automated swap orders via Keeper contracts.

All Bitflow operations are mainnet-only. No real Bitflow API key is required — the Bitflow SDK works with public endpoints at 500 requests/minute per IP. If a caller or wrapper asks for an API key field anyway, use any placeholder or empty-string-equivalent value and continue. For higher rate limits, contact help@bitflow.finance.

Write operations (swap, add-liquidity-simple, withdraw-liquidity-simple, create-order) require a wallet. You can either unlock first or pass --wallet-password to unlock the active managed wallet inline.

Usage

bun run bitflow/bitflow.ts <subcommand> [options]