{"id":28766282,"url":"https://github.com/0xapp123/solana-trading-cli-bot-grpc","last_synced_at":"2026-04-09T20:39:26.005Z","repository":{"id":296140468,"uuid":"992395879","full_name":"0xapp123/Solana-trading-cli-bot-grpc","owner":"0xapp123","description":"A high-performance library for develop Solana Trading Strategies: CLI, gRPC bots, BOT, low-latency integrations with Jito, Nozomi, DEXes, and local PostgreSQL database support.","archived":false,"fork":false,"pushed_at":"2025-05-30T06:13:05.000Z","size":35549,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"typescript-main","last_synced_at":"2025-05-30T07:58:46.751Z","etag":null,"topics":["algo-trading","cli","command-line-tool","dev-tool","developer-tool","dex","grpc","high-frequency-trading","jito","meteora","orca","raydium","solana","trading-bot"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xapp123.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-05-29T05:00:21.000Z","updated_at":"2025-05-30T06:13:08.000Z","dependencies_parsed_at":"2025-05-30T07:58:51.722Z","dependency_job_id":"844589f7-2d68-4bf5-ae38-4bf91ff98b7d","html_url":"https://github.com/0xapp123/Solana-trading-cli-bot-grpc","commit_stats":null,"previous_names":["0xapp123/solana-trading-cli","0xapp123/solana-trading-cli-bot-grpc"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/0xapp123/Solana-trading-cli-bot-grpc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xapp123%2FSolana-trading-cli-bot-grpc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xapp123%2FSolana-trading-cli-bot-grpc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xapp123%2FSolana-trading-cli-bot-grpc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xapp123%2FSolana-trading-cli-bot-grpc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xapp123","download_url":"https://codeload.github.com/0xapp123/Solana-trading-cli-bot-grpc/tar.gz/refs/heads/typescript-main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xapp123%2FSolana-trading-cli-bot-grpc/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260355369,"owners_count":22996463,"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":["algo-trading","cli","command-line-tool","dev-tool","developer-tool","dex","grpc","high-frequency-trading","jito","meteora","orca","raydium","solana","trading-bot"],"created_at":"2025-06-17T12:00:41.647Z","updated_at":"2026-04-09T20:39:25.998Z","avatar_url":"https://github.com/0xapp123.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Solana Trading CLI Logo](https://github.com/0xapp123/Solana-trading-cli-bot-grpc/blob/typescript-main/assets/sol-repo.jpg)\n\n## If you have some questions, ask [@Tr1030109](https://t.me/Tr1030109) in Telegram and 0xapp123 in Discord\n\n# Solana Trading CLI\nA simple, fast, powerful Library for building custom trading strategies on Solana. It's built for speed, variety, and real-time data, using Cutting-edge Tech. Here's what you get:\n\n- Uses low-latency systems like Jito, BloXroute, and Nozomi to execute trades,\n\n- Read/write Pumpfun data in a local postgreSQL db.\n\n- Supports DEXs like Raydium, Orca, Meteora, and Pump.fun for more trading options.\n\n- Streams transactions and/or accounts state from a third-party's geyser gRPC node.\n\n- Fetches account state info via optimized RPC methods.\n\nThis bot fits into your trading system, perfect for newbies.\n\n# Core Components\n\n## Token Creation and Multi-DEX Support\nCreate your own Solana SPL tokens on mainnet via Pump.fun and swap tokens across multiple decentralized exchanges:\n\n| Exchange | Documentation |\n|----------|---------------|\n| Jupiter  | [CLI \u0026 trading functions guide](https://github.com/0xapp123/Solana-trading-cli-bot-grpc/blob/typescript-main/src/jupiter/README.md) |\n| Raydium   | [CLI \u0026 trading functions guide](https://github.com/0xapp123/Solana-trading-cli-bot-grpc/blob/typescript-main/src/raydium/README.md) |\n| Orca      | [CLI \u0026 trading functions guide](https://github.com/0xapp123/Solana-trading-cli-bot-grpc/blob/typescript-main/src/orca/README.md) |\n| Meteora   | [CLI \u0026 trading functions guide](https://github.com/0xapp123/Solana-trading-cli-bot-grpc/blob/typescript-main/src/meteora/README.md) |\n| Pump.fun  | Integrated support |\n\n\n## Local Database Setup (In Development)\n\nThe project includes a PostgreSQL database for storing Pump.fun trading data and market analysis. For detailed setup instructions, see [Database Documentation](docker_postgres_db/README.md).\n\nQuick setup:\n```bash\n# Navigate to database directory\ncd docker_postgres_db\n\n# Create environment file\ncp .env.example .env\n\n# Start database\ndocker-compose up -d\n```\n\n\n## Low-Latency Infrastructure\nAccelerate transaction finality using Jito and bloXroute for lightning-fast trades. Both capable of pushing your trasaction faster then any other service provider on the market\n\n| Provider | Description |\n|----------|---------------|\n| Jito      | Fast trascation and optimizes transaction ordering and execution specifically |\n| Bloxroute | Fast trascation and accelerates transaction propagation |\n| Nozomi    | Optimzed tx submission to current blockleader |\n\n\nThe database stores:\n- Trading history and limit orders\n- Token tracking and pool migrations\n- Market analysis and transaction data\n\n\n## Open-Source Geyser gRPC Bots\nLeverage our cutting-edge, open-source gRPC trading bots:\n\n| Bot Name | Features | Source |\n|----------|----------|--------|\n| gRPC Pump.fun Sniper Bot | Ultra-low latency (0.4-2 seconds) | [View source](https://github.com/0xapp123/Solana-trading-cli-bot-grpc/tree/typescript-main/src/grpc_streaming_dev/grpc-pf-sniper) |\n| gRPC Copy Bot | Replicate successful trading strategies | [View source](https://github.com/0xapp123/Solana-trading-cli-bot-grpc/tree/typescript-main/src/grpc_streaming_dev/grpc-copy-bot) |\n| gRPC Raydium Sniper Bot | Optimized for Raydium DEX | [View source](https://github.com/0xapp123/Solana-trading-cli-bot-grpc/tree/typescript-main/src/grpc_streaming_dev/grpc-raydium-sniper) |\n\n\n## Real-Time Market Data\nFetch critical metrics for any liquidity pool in real-time with RPC calls:\n- Price\n- LP-burn percentage\n- Pool reserve\n- Market cap\n\n\n### Extensibility\nOur comprehensive toolkit provides everything you need to create your own custom trading bot, tailored to your unique strategies and requirements.\n\n## 🛠️ Installation\nFollow these steps to get your development environment set up:\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/0xapp123/Solana-trading-cli-bot-grpc.git\n   ```\n\n2. **Navigate to the project directory**\n   ```bash\n   cd Solana-trading-cli-bot-grpc\n   ```\n\n3. **Install the correct Node.js version**\n   ```bash\n   nvm install\n   nvm use\n   ```\n\n4. **Install dependencies**\n   ```bash\n   npm install\n   ```\n\n5. **Run the test script**\n   ```bash\n   ts-node test.ts\n   ```\n\n### Installation Prerequisites\n\n- [Node Version Manager (nvm)](https://github.com/nvm-sh/nvm)\n- [Node.js](https://nodejs.org/) (version specified in `.nvmrc`)\n- [npm](https://www.npmjs.com/) (comes with Node.js)\n\n### Troubleshooting\n\nIf you encounter any issues during installation, please check our [FAQ](link-to-faq) or [open an issue](https://github.com/0xapp123/Solana-trading-cli-bot-grpc/issues).\n\n## 🚨 Set Up \n\nBefore you begin, ensure you have completed the following steps:\n\n### 1. Environment Configuration\n\n1. Locate the template file:\n   ```\n   src/helpers/.env.example\n   ```\n\n2. Copy this file and rename it to `.env` in the same directory.\n\n3. Open the `.env` file and add the following required information:\n   - Mainnet wallet secret key (required)\n   - RPC endpoint (required)\n   - Custom Jito fee (if needed)\n\n4. Optional configurations:\n   - Devnet wallet secret key\n   - Helius RPC url + key (e.g. getting latest price from dexes)\n   - Shyft geyser gRPC token (for grpc trading bots development) (Link to Shyft: https://shyft.to/)\n\n### 2. API Keys and Wallet Setup\n\n- **Solana Wallet**: Ensure you have a funded Solana mainnet wallet. The secret key is required for mainnet transactions.\n- **RPC Endpoint**: Obtain a RPC endpoint from reliable node operator like Helius to connect to Solana\n- **Jito Integration**: If uses Jito, prepare your custom fee configuration.\n- **Shyft Geyser gRPC** (Optional): If you are developing algo trading bot, buy a grpc token from reliable operator like Shyft.\n\n### 3. Final Check\n\n- Confirm that your `.env` file is properly configured and saved.\n- Ensure the `.env` file is in the correct location: `src/helpers/.env`\n- Verify that you haven't accidentally committed your `.env` file to version control.\n\n\u003e ⚠️ **Security Note**: Never share or commit your `.env` file or any private keys. The `.env` file is included in `.gitignore` for your safety.\n\nFor any issues with configuration, please refer to our [Troubleshooting Guide](link-to-troubleshooting) or [open an issue](https://github.com/yourusername/your-repo-name/issues).\n\n## 🤝 Feedback and Contributions\nWe've made every effort to implement all the main aspects of solana trading in the best possible way. However, the development journey doesn't end here, and your input is crucial for our continuous improvement.\n\n\u003e [!IMPORTANT]\n\u003e Whether you have feedback on features, have encountered any bugs, or have suggestions for enhancements, we're eager to hear from you. Your insights help us make the Solana Trading Client library more robust and user-friendly.\n\nPlease feel free to contribute by submitting an issue, joining the discussions, or joining our discord. Each contribution helps us grow and improve.\n\nWe appreciate your support and look forward to making our product even better with your help!\n\n### How to Contribute\n\n- Contributions is wellcome!!!\n- Fork it\n- `git checkout -b feature/YourNewFeature`\n- `git commit -m 'bug Fixed/added new feature'`\n- `git push origin feature/YourNewFeature`\n- And Please open a pull request\n\n### Apply Latest Changes from remote repo\n\n- `git stash -u  # Stash your changes`\n- `git pull --rebase # Pull the latest changes`\n- `git stash pop # Apply Your stashed changes`\n\n## ✅ Credits\n\n- https://github.com/raydium-io/raydium-sdk-V2\n- https://github.com/rckprtr/pumpdotfun-sdk\n- https://github.com/rpcpool/yellowstone-grpc\n- https://github.com/Al366io/solana-transactions-wrapper\n\n## ‼️ Disclaimer\n\nThis software is provided \"as is\", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.\n\n**Use at your own risk.** The authors take no responsibility for any harm or damage caused by the use of this software. Users are responsible for ensuring the suitability and safety of this software for their specific use cases.\n\nBy using this software, you acknowledge that you have read, understood, and agree to this disclaimer.\n\n### Discord handle: 0xapp123\n\n### If you think this will steal your keys, i have no time to convince you to use it.\n\n## 🤖 Plans\n\n- A local-based db to store your limit orders ✅\n\n- Smart scripts to help you detect potential rug pulls on pump.fun, e.g. dev sold, master wallet, similar past rug patterns\n\n- More gRPC bots to come ✅\n\n- More algos to trade on raydium/Pump.fun\n\n- Make it more easier to install, deploy the bot using docker ✅\n\n## 🪙 Final State of this repo\n\n- Best trading framework on Solana\n\n- Best package/library for trading development on solana, e.g.(we could make it easy to like Raydium.buy(\"token\", 0.01sol, 1%slippage))\n\n- Best open-soured trading bot\n\n- Succeed with Solana dev!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xapp123%2Fsolana-trading-cli-bot-grpc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xapp123%2Fsolana-trading-cli-bot-grpc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xapp123%2Fsolana-trading-cli-bot-grpc/lists"}