{"openapi":"3.1.0","info":{"title":"On-Demand Liq & Whale Signal API","description":"Agent-First-Signale aus dem Hyperliquid-Liquidations-Radar: Positionen am Abgrund ('Liqs channeln'), Smart-Money-Bias, drohende Kaskaden, realisierte Liquidationen, Whale-Ein-/Ausstiege und das Wallet-Register. Auth via Header goose-LIQ-API-KEY.","version":"1.0.0"},"paths":{"/v1/health":{"get":{"tags":["meta"],"summary":"Status & Datenfrische (kein Key nötig)","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/coins":{"get":{"tags":["meta"],"summary":"Alle handelbaren Coins im aktuellen Zyklus","operationId":"coins_v1_coins_get","parameters":[{"name":"goose-LIQ-API-KEY","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Goose-Liq-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/keys/trial":{"post":{"tags":["keys"],"summary":"🔑 Kostenlosen 24h-Test-Key holen (kein Login, kein Key nötig)","description":"Self-Service-Test-Key: gibt einen 24h-Key zurück. **1 pro IP** — erneuter Aufruf liefert denselben Key\n(idempotent), sammelt sich also nicht an. Danach im Header `X-API-Key` verwenden.","operationId":"create_trial_key_v1_keys_trial_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/positions/at-risk":{"get":{"tags":["signals"],"summary":"🎯 Riesen-Positionen nahe der Liquidation ('Liqs channeln')","operationId":"positions_at_risk_v1_positions_at_risk_get","parameters":[{"name":"coin","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"HL-Symbol, z. B. BTC. Leer = alle.","title":"Coin"},"description":"HL-Symbol, z. B. BTC. Leer = alle."},{"name":"min_notional","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Mindest-Positionsgröße in USD.","default":0,"title":"Min Notional"},"description":"Mindest-Positionsgröße in USD."},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(distanz|groesse)$","description":"distanz = am nächsten an Liq zuerst; groesse = größte zuerst.","default":"distanz","title":"Sort"},"description":"distanz = am nächsten an Liq zuerst; groesse = größte zuerst."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":25,"title":"Limit"}},{"name":"goose-LIQ-API-KEY","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Goose-Liq-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus":{"get":{"tags":["signals"],"summary":"🧠 Netto-Bias je Coin unter Smart-Money-Wallets","operationId":"consensus_v1_consensus_get","parameters":[{"name":"min_wallets","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Mindestzahl Smart-Wallets je Coin für einen echten Konsens.","default":3,"title":"Min Wallets"},"description":"Mindestzahl Smart-Wallets je Coin für einen echten Konsens."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"goose-LIQ-API-KEY","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Goose-Liq-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/cascades":{"get":{"tags":["signals"],"summary":"💥 Drohende Liquidations-Kaskaden (Cluster je Coin+Seite)","operationId":"cascades_v1_cascades_get","parameters":[{"name":"coin","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coin"}},{"name":"danger_pct","in":"query","required":false,"schema":{"type":"number","maximum":50,"exclusiveMinimum":0,"description":"Positionen mit Abstand-zu-Liq < diesem % zählen.","default":10,"title":"Danger Pct"},"description":"Positionen mit Abstand-zu-Liq < diesem % zählen."},{"name":"acute_pct","in":"query","required":false,"schema":{"type":"number","maximum":50,"exclusiveMinimum":0,"description":"Cluster gilt als 'acute', wenn die nächste Position < diesem % ist.","default":3,"title":"Acute Pct"},"description":"Cluster gilt als 'acute', wenn die nächste Position < diesem % ist."},{"name":"min_wallets","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":3,"title":"Min Wallets"}},{"name":"goose-LIQ-API-KEY","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Goose-Liq-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/liquidations":{"get":{"tags":["signals"],"summary":"☣️ Jüngste tatsächlich realisierte Liquidationen (mit Fill-Kurs)","operationId":"liquidations_v1_liquidations_get","parameters":[{"name":"coin","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coin"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":15,"title":"Limit"}},{"name":"goose-LIQ-API-KEY","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Goose-Liq-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/entries":{"get":{"tags":["signals"],"summary":"🎯 Frische Smart-Money/Whale-Neueinstiege (+ Einstiegskurs)","operationId":"entries_v1_entries_get","parameters":[{"name":"coin","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coin"}},{"name":"min_notional","in":"query","required":false,"schema":{"type":"number","minimum":0,"default":0,"title":"Min Notional"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":25,"title":"Limit"}},{"name":"goose-LIQ-API-KEY","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Goose-Liq-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/exits":{"get":{"tags":["signals"],"summary":"🚪 Freiwillige Smart-Money/Whale-Ausstiege (+ PnL)","operationId":"exits_v1_exits_get","parameters":[{"name":"coin","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coin"}},{"name":"min_notional","in":"query","required":false,"schema":{"type":"number","minimum":0,"default":0,"title":"Min Notional"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":25,"title":"Limit"}},{"name":"goose-LIQ-API-KEY","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Goose-Liq-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/wallets/{address}":{"get":{"tags":["signals"],"summary":"🐋 Wallet-Steckbrief: Tags (smart/whale/active), Quellen, Liq-Historie","operationId":"wallet_v1_wallets__address__get","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","title":"Address"}},{"name":"goose-LIQ-API-KEY","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Goose-Liq-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}