{"id":51065645,"url":"https://github.com/hypeprinter007-stack/hyperliquid-starter-bot","last_synced_at":"2026-07-11T09:01:02.640Z","repository":{"id":349244279,"uuid":"1201450153","full_name":"hypeprinter007-stack/hyperliquid-starter-bot","owner":"hypeprinter007-stack","description":"Minimal algo trading bot for Hyperliquid perps with fused signal layer (SignalFuse)","archived":false,"fork":false,"pushed_at":"2026-04-20T18:37:17.000Z","size":9,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-20T20:33:48.643Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hypeprinter007-stack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-04T17:37:42.000Z","updated_at":"2026-04-20T18:37:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hypeprinter007-stack/hyperliquid-starter-bot","commit_stats":null,"previous_names":["hypeprinter007-stack/hyperliquid-starter-bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hypeprinter007-stack/hyperliquid-starter-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypeprinter007-stack%2Fhyperliquid-starter-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypeprinter007-stack%2Fhyperliquid-starter-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypeprinter007-stack%2Fhyperliquid-starter-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypeprinter007-stack%2Fhyperliquid-starter-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hypeprinter007-stack","download_url":"https://codeload.github.com/hypeprinter007-stack/hyperliquid-starter-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypeprinter007-stack%2Fhyperliquid-starter-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35356478,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-11T02:00:05.354Z","response_time":104,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-23T06:30:36.359Z","updated_at":"2026-07-11T09:01:02.624Z","avatar_url":"https://github.com/hypeprinter007-stack.png","language":"Python","funding_links":[],"categories":["Alpha"],"sub_categories":["Trading and Sniper Bot"],"readme":"# Hyperliquid Starter Bot\n\nA minimal, production-ready algorithmic trading bot for [Hyperliquid](https://hyperliquid.xyz) perpetuals.\nUses [SignalFuse](https://signalfuse.co) for trading intelligence — fused sentiment, macro regime, and market structure in one API call.\n\n## Features\n\n- Hyperliquid Python SDK — market + limit orders, position management\n- SignalFuse signal layer — fused sentiment + macro + market structure\n- Two payment modes — credit tokens (simplest) or x402 per-call (USDC on Base)\n- Simple strategy scaffold — plug in your own logic\n- Clean async architecture — runs on any Linux/Mac\n\n## Quick Start\n\n```bash\ngit clone https://github.com/hypeprinter007-stack/hyperliquid-starter-bot\ncd hyperliquid-starter-bot\npip install -r requirements.txt\ncp .env.example .env\n# Fill in your .env values\npython main.py\n```\n\n## How SignalFuse Works\n\n```python\nfrom signalfuse_client import SignalFuseClient\n\n# Credit token (simplest)\nsf = SignalFuseClient(credit_token=\"your-token\")\n\n# Or x402 per-call (requires x402 + eth-account packages)\n# sf = SignalFuseClient(wallet_private_key=\"0x...\")\n\nsignal = await sf.get_signal(\"BTC\")\n\nprint(signal)\n# {\n#   \"symbol\": \"BTC\",\n#   \"signal\": \"long\",\n#   \"signal_strength\": 74,\n#   \"confidence\": 0.82,\n#   \"regime\": \"risk_on\",\n#   \"components\": {\n#     \"social\": {\"score\": 0.49, \"label\": \"bullish\"},\n#     \"macro\": {\"score\": 0.63, \"label\": \"bullish\"},\n#     \"market\": {\"score\": 0.42, \"label\": \"long_bias\"}\n#   }\n# }\n```\n\nGet 5 free calls — no signup:\n```bash\ncurl -X POST https://api.signalfuse.co/v1/credits/trial \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"wallet\":\"YOUR_ETH_ADDRESS\"}'\n```\n\nFull docs at [https://signalfuse.co](https://signalfuse.co)\n\n## Strategy Logic\n\nThe default strategy is simple and intentionally minimal — override `strategy.py` with your own logic:\n\n1. Fetch SignalFuse signal for each asset in your watchlist\n2. If `signal_strength \u003e 62` and direction is `long` -\u003e enter long, size based on confidence\n3. If `signal_strength \u003c 38` and direction is `short` -\u003e enter short or close long\n4. Trailing stop at 2% from entry\n\n## Architecture\n\n```\nmain.py              — entry point, main loop\nsignalfuse_client.py — SignalFuse API wrapper\nstrategy.py          — signal -\u003e order logic\n.env                 — your keys (never commit this)\n```\n\n## Contributing\n\nPRs welcome. If you build something cool on top of this, open an issue and share it.\n\n## Disclaimer\n\nThis bot executes real trades with real funds. SignalFuse provides a data fusion API, not financial advice. Signals are mathematical composites that can be wrong. You are responsible for your own trading decisions and risk management. Trade at your own risk.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypeprinter007-stack%2Fhyperliquid-starter-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhypeprinter007-stack%2Fhyperliquid-starter-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypeprinter007-stack%2Fhyperliquid-starter-bot/lists"}