This project is educational and testing software only. It is NOT suitable for production use or handling real financial assets.
- Key Management: Private keys are stored in plaintext
.envfiles (acceptable for testing, NOT for production) - No Audit: Code has not undergone professional security audit
- No Insurance: No liability coverage or insurance protecting users
- Experimental: Claude AI decision-making is experimental and unproven for trading
- No Compliance: No legal/compliance review for securities regulations
- Limited Testing: Not tested under adverse market conditions or extreme volatility
If you wanted to build a real trading system similar to this:
- Hardware Security Module (HSM) for private key storage
- Professional security audit by qualified firm
- Regulatory compliance review (CFTC, SEC, etc.)
- Insurance & liability coverage
- Institutional-grade monitoring and alerting
- Rate limiting & circuit breakers for risk management
- Formal user agreement with risk disclaimers
- 24/7 operational support
- ✅ Never commit
.env.localto version control - ✅ Use
.env.exampleas your template - ✅ Keep
.env.localin.gitignore - ✅ Test with small amounts only if using real credentials
- ✅ Rotate API keys regularly
- ✅ Use separate API keys for testing vs. production
- ✅ Run in
PAPERmode (simulated) for learning
Since this is educational software:
- Create a GitHub issue describing the vulnerability (do not include details about how to exploit)
- Email the maintainer if you prefer non-public disclosure
- Allow time for response - this is not a security-focused project
- Do NOT publicly disclose until maintainer has time to respond
- ❌ Real financial trading with significant amounts
- ❌ Production deployment without major modifications
- ❌ Handling other people's funds or credentials
- ❌ Bypassing security features or risk controls
- ❌ Automated trading without proper regulatory compliance
THIS 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.
The authors accept no liability for:
- Financial losses from trading
- Data breaches or credential exposure
- System failures or bugs
- Use in any production environment
Use at your own risk.
Never commit files containing:
ANTHROPIC_API_KEY- Claude API credentialsPRIVATE_KEY- Ethereum/blockchain wallet private keyPOLYMARKET_API_KEY- API credentialsNEWS_API_KEY- Third-party API keys- Any wallet addresses if combined with private keys
✅ Good:
cp .env.example .env.local
# Edit .env.local locally (not in git)
# Use environment variables for CI/CD❌ Bad:
git commit .env.local
git commit secrets/private_key.txt
echo "PRIVATE_KEY=0x..." in configFor any keys committed accidentally:
- Immediately revoke the key through the API provider
- Generate a new key
- Update .env locally
- Force push if in git history (nuclear option - understand implications)
- Scan git history for similar issues
# Search for potential leaks
git log --all -S "sk-ant-" --full-history
git log --all -S "0x" --full-history | grep -i "private"If you find vulnerabilities:
- Do NOT create public issues
- Email maintainers privately first
- Include: vulnerability description, reproduction steps, proposed fix
- Allow 30 days for response
- Disclose publicly after patch is ready
For more details, see:
LICENSE- MIT License with disclaimersREADME.md- "Security Notes" section.env.example- Safe environment template