# LiqGuard

- **Event:** [Meta Global AI Developer Hackathon](https://cerebralvalley.ai/e/meta-ai-developer-hackathon)
- **When:** Oct 26, 12:00 PM – Nov 4, 9:00 PM (EST)
- **Where:** Online
- **Team:** [CHUNYUAN Chang](https://cerebralvalley.ai/u/moonlight007)
- **GitHub:** https://github.com/CryptoCat007/liqguard
- **Demo video:** https://youtu.be/qBJfIDNJPtg
- **Gallery:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery
- **Page:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/1580

LiqGuard warns perpetual-futures traders before they get liquidated and tells them what to do next. It is a Telegram bot (@futureswatchbot) plus a web dashboard (https://152-42-176-155.sslip.io), in English and Traditional Chinese.

Exchange liquidation prices assume your other cross-margin positions stand still, ignore funding drift, and say nothing when several positions are in trouble at once. LiqGuard connects to Binance with a read-only API key or to Hyperliquid with a wallet address, polls positions every 30 seconds, and computes the true liquidation price, distance, funding impact and rescue options.

Features: a portfolio stress test with correlated-liquidation alerts, escalating alerts that repeat until you tap "I'm awake", a risk overview that ranks which position to handle first, a rescue simulator (add margin vs. reduce vs. hedge, with costs), and a stop-loss check that flags missing stops or stops beyond the liquidation price. Every alert and report carries a one-line explanation from Meta Muse.

LiqGuard is read-only. It never asks for private keys or seed phrases, rejects keys that can trade or withdraw, and places no orders on mainnet. I built it solo; I work in CEX futures operations and collected these pain points from real traders.

## More from Meta Global AI Developer Hackathon

- [am solo builder](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/1577)
- [Alrevion](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/1578)
- [Proactive Assistant](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/1579)
- [DamantaraStudio](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/1581)
- [RI-SWAP](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/1582)
- [Pyroscan](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/1583)

---

Markdown version of https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/1580. Site index for agents: https://cerebralvalley.ai/llms.txt · full text: https://cerebralvalley.ai/llms-full.txt