liquidity-depth-comparison

liquidity-depth-comparison is the repo for the edgeX liquidity comparison dashboard.

It collects live order-book depth for edgeX contracts, compares each market with mapped contracts on other venues, and writes the latest snapshot rows into a Lark Bitable table for the dashboard.

What This Repo Does

• Uses the live edgeX contract list as the main comparison universe
• Pulls perp depth from edgeX, Binance, OKX, Bybit, Bitget, MEXC, BingX, Aster, Hyperliquid, and Lighter
• Supports grouped mappings for non-crypto markets, including edgeX CLUSD, Binance CLUSDT, and MEXC USOIL_USDT
• Syncs the latest comparison rows into Lark Bitable
• Can run as a one-off sync or on a local schedule

What This Repo Is Not

This is not the repo for the edgeX whale-trade and L1 withdrawal alerts.

That alerting service lives in realnaka/edgex-flow-monitor.

Main Commands

• npm run depth:sync
• npm run depth:sync -- --dry-run
• npm run depth:start
• npm run depth:cleanup

The older alert commands are still present in the codebase, but the daily dashboard workflow uses the depth:* commands.

Required Setup

At minimum, configure:

• FEISHU_APP_ID
• FEISHU_APP_SECRET
• BITABLE_APP_TOKEN
• TABLE_DEPTH_COMPARISON

Useful optional settings:

• DEPTH_EXCHANGES
• DEPTH_SYMBOLS
• EDGEX_DEPTH_LEVEL
• DEPTH_SAMPLE_COUNT
• DEPTH_SAMPLE_INTERVAL_MS

See .env.example for the full list.

Scheduling

• GitHub Actions remains available for manual dispatch
• The recurring production sync was moved off GitHub Actions on March 23, 2026
• The current daily sync runs locally and writes directly to the Lark table

Repo Layout

src/
  api/           Exchange and edgeX API clients
  depth/         Depth collection, mappings, and exchange adapters
  bitable.ts     Lark Bitable sync
  index.ts       CLI entrypoint
  config.ts      Environment-driven config

License

MIT