vike-perp-overview

One-shot market overview for perpetuals, plus the cross-venue price-gap tool. The overview is exactly what these three tools return: funding arbs, price gaps and the HL leaderboard. There is no open-interest, market-wide volume or per-venue mark-price tool in the CLI; say so if asked.

Price spreads

vike-data perp spreads --json                 # up to 10 symbols with a cross-venue price gap >= 0.5%
vike-data perp spreads --symbol BTC --json    # the same list, filtered to one symbol

Rows: symbol, buy_exchange, buy_price, sell_exchange, sell_price, spread_pct. Pre-ranked: cite the rows directly.

• "Spread" is perp vs perp across venues, not spot vs perp. buy_exchange is the cheapest venue and sell_exchange the dearest for that symbol.
• --symbol only filters the global top 10. An empty answer means the symbol is not among today's widest gaps, not that its venues agree. Don't answer "where's X cheapest" from an empty result; say the tool only lists the 10 widest gaps.
• Outliers (> 400 bps off the cross-venue median) are filtered upstream — typically unit-mismatch listings like 1000SHIB vs SHIB, or stale prices.
• It reads the latest ticker snapshots: a row is a current snapshot, not a forecast.

spread_pct = 0.7% on a liquid pair is an opportunity before taker fees, slippage and the time to move inventory between venues. For the funding side of the same trade use vike-perp-funding.