{"id":20994608,"url":"https://github.com/dracor22/handi-cat_wallet-tracker","last_synced_at":"2026-01-19T12:01:47.681Z","repository":{"id":258637298,"uuid":"823457017","full_name":"DracoR22/handi-cat_wallet-tracker","owner":"DracoR22","description":"Solana wallet tracker Telegram Bot, follow any wallet and get detailed information about every transaction in Raydium, Jupiter, Pump.fun and PumpSwap 😺","archived":false,"fork":false,"pushed_at":"2025-03-28T00:16:48.000Z","size":2819,"stargazers_count":159,"open_issues_count":10,"forks_count":70,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-28T17:02:04.205Z","etag":null,"topics":["crypto","pumpfun","pumpfun-bot","raydium","solana","solana-wallet-tracker","telegram-bot","web3"],"latest_commit_sha":null,"homepage":"https://t.me/handi_cat_bot","language":"TypeScript","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/DracoR22.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}},"created_at":"2024-07-03T04:38:03.000Z","updated_at":"2025-03-28T00:16:51.000Z","dependencies_parsed_at":"2024-11-10T16:17:10.923Z","dependency_job_id":"b7b590ae-a15a-4905-8fd3-c5c05c3acf68","html_url":"https://github.com/DracoR22/handi-cat_wallet-tracker","commit_stats":null,"previous_names":["dracor22/handi-cat_wallet-tracker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DracoR22%2Fhandi-cat_wallet-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DracoR22%2Fhandi-cat_wallet-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DracoR22%2Fhandi-cat_wallet-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DracoR22%2Fhandi-cat_wallet-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DracoR22","download_url":"https://codeload.github.com/DracoR22/handi-cat_wallet-tracker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247226211,"owners_count":20904465,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["crypto","pumpfun","pumpfun-bot","raydium","solana","solana-wallet-tracker","telegram-bot","web3"],"created_at":"2024-11-19T07:18:54.359Z","updated_at":"2026-01-19T12:01:47.669Z","avatar_url":"https://github.com/DracoR22.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- Improved compatibility of back to top link: See: https://github.com/othneildrew/Best-README-Template/pull/73 --\u003e\n\n\u003ca id=\"readme-top\"\u003e\u003c/a\u003e\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/DracoR22/handi-cat_wallet-tracker\"\u003e\n    \u003cimg src=\"showcase/logo.jpg\" alt=\"Logo\" width=\"80\" height=\"80\"\u003e\n  \u003c/a\u003e\n\n  \u003ch3 align=\"center\"\u003e🐱 Handi Cat | Wallet Tracker\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    Track any Solana transaction in Real-Time\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://t.me/handi_cat_bot\"\u003e\u003cstrong\u003eUse the Telegram bot -\u003e\u003c/strong\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n\n## About The Project\n\n[![Product Name Screen Shot][product-screenshot]](https://t.me/handi_cat_bot)\n\nHandi Cat is a Telegram bot that can track any Solana wallet in real time, it provides relevant information\nof each transaction made in Raydium, Jupiter, Pump.fun and Pump AMM(PumpSwap) including transaction hash, tokens and amount swapped, price of the token in SOL, token market cap and much more.\n\n## Features\n\n- 📈 Tracks in Real-Time any SOL transfer\n- 🔍 Detects Raydium, Jupiter, Pump.fun and PumpSwap transactions\n- 💰 Gets SOL price of the token swapped\n- 📊 Gets token market cap at the time swapped\n- 💰 Gets token amount and supply percentage owned by each tracked wallet\n- 🤖 Each transaction message includes links to popular Solana trading bots to quickly buy the token\n- 🔗 Each transaction provides links to Photon, GMGN and Dex Screener to quickly see the token chart\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Bot Commands\n\n- `/start` – Opens the bot's main menu\n- `/add` – Add a new wallet address\n- `/delete` – Delete a wallet addresss\n- `/upgrade` – Access the subscription menu\n- `/ban_wallet` – Flag a wallet as BANNED and remove it from the wallet pool **(admin only)**\n- `/help_notify` – Learn how bot notifications work\n- `/help_group` – Instructions for adding the bot to group chats\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Built With\n\n- 🌐 Node.JS\n- 📘 TypeScript\n- 📊 Prisma ORM\n- 🪙 Solana Web3.js\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- GETTING STARTED --\u003e\n\n## Getting Started\n\nFollow these simple steps to setup Handi Cat locally on your machine\n\n### Prerequisites\n\n**Node version 14.x**\n\n### Steps\n\n1. Clone the repo\n\n   ```sh\n   git clone https://github.com/DracoR22/handi-cat_wallet-tracker.git\n   ```\n\n2. Install NPM packages\n\n   ```sh\n   pnpm install\n   ```\n\n3. Rename `.env.example` file to `.env`\n\n4. Create a Postgres database and paste the connection string into `DATABASE_URL` in .env\n\n5. Create a new `Telegram Bot` using `Bot Father` and get your `BOT_TOKEN`. Paste it into the corresponding variable in `.env`\n\n6. Run the migration command to push the database schemas and generate all types\n\n```sh\n  pnpm db:migrate\n```\n\n7. `(Optional)` To use a webhook connection instead of polling, set your .env like this:\n\n```env\nENVIRONMENT=production\nAPP_URL=https://your-domain.com\n\n# APP_URL must be the public HTTPS URL where your bot is deployed.\n# The bot will automatically register its webhook at `APP_URL/webhook/telegram.\n```\n\n8. `(Optional)` Set up custom RPC providers by adding them to the RPC_ENDPOINTS environment variable.\n   You can list multiple endpoints separated by commas, e.g.:\n\n```env\nRPC_ENDPOINTS=https://rpc1.com,https://rpc2.com\n```\n\n9. Start the bot\n\n```sh\n  pnpm start\n```\n\n10. That's it! now your local version of Handi Cat is ready to use.\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"./showcase/cli-pic.png\" width=\"95%\" alt=\"Screenshot of bot succesfully running\"/\u003e\u003c/\u003e\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- CONTACT --\u003e\n\n## Contact\n\n\u003c!-- [@your_twitter](https://twitter.com/your_username)  --\u003e - rdraco039@gmail.com\n\nMy solana wallet for the struggles - `5EVQsbVErvJruJvi3v8i3sDSy58GUnGfewwRb8pJk8N1`\n\nProject Link: [https://github.com/DracoR22/handi-cat_wallet-tracker](https://github.com/DracoR22/handi-cat_wallet-tracker)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n\n[contributors-shield]: https://img.shields.io/github/contributors/othneildrew/Best-README-Template.svg?style=for-the-badge\n[contributors-url]: https://github.com/othneildrew/Best-README-Template/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/othneildrew/Best-README-Template.svg?style=for-the-badge\n[forks-url]: https://github.com/othneildrew/Best-README-Template/network/members\n[stars-shield]: https://img.shields.io/github/stars/othneildrew/Best-README-Template.svg?style=for-the-badge\n[stars-url]: https://github.com/othneildrew/Best-README-Template/stargazers\n[issues-shield]: https://img.shields.io/github/issues/othneildrew/Best-README-Template.svg?style=for-the-badge\n[issues-url]: https://github.com/othneildrew/Best-README-Template/issues\n[license-shield]: https://img.shields.io/github/license/othneildrew/Best-README-Template.svg?style=for-the-badge\n[license-url]: https://github.com/othneildrew/Best-README-Template/blob/master/LICENSE.txt\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge\u0026logo=linkedin\u0026colorB=555\n[linkedin-url]: https://linkedin.com/in/othneildrew\n[telegram-bot]: https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge\u0026logo=telegram\u0026logoColor=white\n[product-screenshot]: showcase/notifications-new.png\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdracor22%2Fhandi-cat_wallet-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdracor22%2Fhandi-cat_wallet-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdracor22%2Fhandi-cat_wallet-tracker/lists"}