Cross-Exchange Funding Rate Arbitrage

Config

• Symbol (base asset) (required): Base asset to compare (e.g. BTC, ETH). The workflow uses the corresponding perpetual on each exchange (e.g. BTC/USDT on Binance, BTCUSDT on Bybit). Example: BTC.

• Min spread to alert (%) (optional, default: 0.01): Alert only when the absolute difference between the two funding rates is at least this many percentage points. Example: 0.01. Lower values alert more often; higher values only when the spread is larger.

• Alert method (optional, default: telegram): How to notify when the spread meets the threshold. Options: telegram (send to Telegram if configured), none (no notification, only log and output).

• Binance API (required): Used to fetch Binance perpetual funding rates.

• Bybit API (required): Used to fetch Bybit perpetual funding rates.

• Telegram (optional): If you choose telegram as alert method, configure this so alerts are sent to your chat.

Logic

1. Read symbol base, min spread, and alert method; ensure both exchange credentials are available.
2. Fetch current funding rates from Binance and Bybit in parallel for the chosen symbol.
3. Compute the absolute spread between the two rates (as a percentage). Determine which exchange has the lower rate (suggested long leg) and which the higher (suggested short leg).
4. If the spread is at or above the min spread and alert method is telegram and Telegram is configured, send one message with symbol, spread, rates, suggested long/short exchanges, and threshold.
5. Finish and report symbol, both rates, spread, whether the threshold was met, suggested long/short exchanges, and whether an alert was sent.

When it stops: After one run.

If something fails: If fetching either rate or sending the alert fails, the error propagates and the workflow ends.