@agentbadge/bstock-tracker
Delta tracker engine for Binance tokenized stocks (bStocks) vs underlying
US equities (EPIC-141). Pure logic package — no server imports; consumed by
hackathon/server wiring and the standalone Fly.io deployment.
Delta formula
delta% = (bStockMid − underlyingMid × multiplier) / (underlyingMid × multiplier) × 100
multiplier comes from Binance /sapi/v1/equity/market/tokenized-assets
and is NOT always 1 (e.g. NVDAB = 1.00077822).
Config (env)
Required: BINANCE_BSTOK_API_KEY, BINANCE_BSTOK_API_SECRET,
FINNHUB_API_KEY.
Optional: ALPACA_API_KEY + ALPACA_API_SECRET (fallback provider),
TELEGRAM_BOT_BSTOK_TOKEN (+ TELEGRAM_BSTOK_CHAT_ID,
TELEGRAM_BSTOK_BATCH_MS), MCP_AGENT_TOKENS (comma-separated bearers),
threshold overrides BSTOCK_DELTA_ALERT_PCT (0.5), BSTOCK_STALE_MS
(15000), BSTOCK_REST_POLL_MS (30000), BSTOCK_OFF_MARKET_ALERT_MS
(10800000), BSTOCK_ROLLING_WINDOW_POINTS (1440).
Scripts
bun run build — tsc → dist/
bun test / bunx vitest run --run — vitest
Questions & Contact