Proxy Gateway

🚀 Secure HTTP Proxy for AI Agents — Unrestricted internet access with pay-per-use pricing. Start with 10 free requests, then only $0.001 per API call.

When to Use

Use this skill when you need to:

• - Give AI agents internet access — No local proxy setup required, just call the API
• Web scraping and data extraction — Collect data from public websites at scale
• API integrations — Connect AI agents to external APIs without network configuration
• Research automation — Automate web research and content aggregation tasks
• Multi-region proxy needs — Access content through US, EU, or Asia proxy nodes
• Cost-effective proxy solution — Pay only $0.001 per request instead of monthly subscriptions
• Self-hosted proxy option — Run your own proxy server for maximum privacy

---

⚠️ Security & Privacy Notice

Please read carefully before using this service:

🔒 Privacy Risks

All requests transit through the proxy server, including:

• - Full request URLs
• All HTTP headers
• Request bodies
• Response content

DO NOT use this proxy for:

• - API keys or access tokens
• Private keys or passwords
• Personal or sensitive data
• Internal/private network endpoints
• Banking or financial credentials

💰 Trust Model & Risk Disclosure

This service operates on a custodial model with the following risks:

Risk	Description	Mitigation
Custody Risk	User funds are held in platform-controlled wallets	Use small amounts, withdraw frequently
Operator Risk

Platform operator could mismanage funds | Open source, audited code |
| Smart Contract Risk | Payment verification relies on external contracts | Multi-sig, timelock protections |
| Privacy Risk | All requests visible to proxy operator | Self-host for complete privacy |

Recommendations:

• - Only deposit amounts you are willing to risk
• Monitor your balance regularly
• Consider self-hosting for sensitive use cases
• Withdraw unused balances periodically

🏠 Self-Hosting Option

For maximum privacy and control, self-host this service:

• - Full source code available (MIT License)
• Complete data sovereignty
• No third-party visibility
• Easy deployment with Docker or pip

---

📋 System Requirements

Runtime Dependencies

Component	Version	Required	Notes
Python	3.10+	✅	Core runtime
Redis

6.0+ | ⚠️ | Required for production (multi-process safety) | | Polygon RPC | - | ✅ | Mainnet or testnet endpoint |

Python Packages

CODEBLOCK0

Network Requirements

• - Inbound: Port 8080 (configurable via PORT env var)
• Outbound: HTTPS (443) for proxy requests
• Outbound: WebSocket (optional) for blockchain events

Optional Components

• - Nginx: For SSL termination and reverse proxy
• Docker: For containerized deployment
• Systemd: For service management on Linux

---

✨ Why Proxy Gateway?

Feature	Benefit
🎁 10 Free Requests	Start instantly, no credit card required
⚡ Zero Configuration

No local proxy setup, just call the API | | 💵 Pay-Per-Use | Only $0.001 per request, no subscriptions | | 🔐 Security Audited | 6 security audits, 13 P0 vulnerabilities fixed | | 📖 Open Source | MIT licensed, fully auditable code | | 🌍 Multi-Region | US, EU, Asia proxy nodes | | 🔗 Web3 Native | Polygon blockchain, USDC payments | | 🏠 Self-Host Ready | Deploy your own instance in minutes |

---

🚀 Quick Start

1. Start with Free Trial (10 Requests)

CODEBLOCK1

2. Continue with Paid Mode

After free trial, deposit USDC to continue:

CODEBLOCK2

---

💰 Pricing

Tier	Price	Features
Free Trial	FREE	10 requests, no registration
Pay-Per-Use

$0.001/request | Unlimited calls, pay as you go |
| Self-Hosted | FREE | Run your own server |

• - Currency: USDC on Polygon
• Minimum Deposit: None (top up any amount)
• Network Fees: Paid by user for deposits

---

🌐 API Endpoints

Endpoint	Method	Description	Auth
INLINECODE1	GET	Service info	None
INLINECODE2

GET | Health check | None | | /network-info | GET | Network configuration | None | | /api/v1/regions | GET | Available proxy regions | None | | /api/v1/fetch | POST | Fetch any URL via proxy | Client ID or API Key | | /deposit-info | GET | Get deposit address | None | | /balance | GET | Check balance | Client ID |

---

🏠 Self-Hosting Guide

Why Self-Host?

Aspect	Hosted Service	Self-Hosted
Privacy	Server sees all requests	Complete privacy
Control

Platform managed | Full control | | Cost | Per-request fees | Server costs only | | Trust | Requires trust | Trustless | | Setup | Instant | 5-minute setup |

Quick Deploy

CODEBLOCK3

Docker Deploy

CODEBLOCK4

---

🔒 Security Features

• - ✅ 6 Security Audits Completed by independent reviewers
• ✅ 13 P0 Vulnerabilities Fixed All critical issues resolved
• ✅ Input Validation Strict validation on all inputs (amount limits: 0 < x ≤ 1000 USDC)
• ✅ Lua Script Sandboxing Redis Lua execution with parameter validation
• ✅ Anti-Replay Protection Transaction replay attack prevention
• ✅ Atomic Deduction Balance updates are atomic
• ✅ HTTPS/TLS All communications encrypted
• ✅ Open Source Full code transparency

Security Policy: See SECURITY.md for detailed security information and vulnerability reporting.

---

🛡️ Best Practices

✅ DO

• - Use for public API access
• Use for web scraping public data
• Use for research automation
• Use for content aggregation
• Self-host for sensitive operations

❌ DON'T

• - Send API keys through the proxy
• Send passwords or credentials
• Access private/internal networks
• Send personal information
• Send financial data

---

📝 Environment Variables

Required (for self-hosting)

Variable	Description	Example
INLINECODE8	Polygon address for USDC deposits	INLINECODE9
INLINECODE10

Admin authentication token | random_string_16+ |

Optional

Variable	Default	Description
INLINECODE12	INLINECODE13	Network mode (mainnet/testnet)
INLINECODE14

localhost | Redis server host | | REDIS_PORT | 6379 | Redis server port | | FREE_TRIAL_LIMIT | 10 | Free trial request limit | | COST_PER_REQUEST | 0.001 | Price per request (USDC) | | CORS_ORIGINS | * | Allowed CORS origins |

See .env.example for complete configuration template.

---

🤝 Contributing

Contributions are welcome! Please see our contributing guidelines and submit PRs.

📄 License

MIT License - See LICENSE for details.

🆘 Support

• - Documentation: https://proxy.easky.cn
• Issues: GitHub Issues
• Email: support@proxy.easky.cn

---

💡 Tips

Free Trial Tips

• - Start instantly: Use X-Client-ID header with any unique identifier to get 10 free requests without registration
• Monitor usage: Check remaining_calls in response to track free trial usage
• No credit card: Free trial requires no payment information

Cost Optimization

• - Batch requests: Combine multiple data needs into fewer requests when possible
• Use caching: Cache responses locally to avoid redundant proxy calls
• Self-host for high volume: If using >1000 requests/day, self-host to eliminate per-request fees

Error Handling Best Practices

• - Always check status codes: 429 = rate limit/insufficient balance, 402 = payment required, 401 = invalid auth
• Implement retry logic: Use exponential backoff for 429 errors
• Set timeouts: Use 30-second timeout for most requests, 60+ for slow endpoints

Privacy & Security

• - Never send secrets: API keys, passwords, tokens should never pass through the proxy
• Self-host for sensitive data: Run your own instance for internal APIs or sensitive operations
• Monitor balance regularly: Check /balance endpoint to avoid unexpected service interruptions

Development Tips

• - Test with free tier: Use free trial for development and testing
• Use consistent Client-ID: Reuse the same X-Client-ID to maintain balance across sessions
• Check regions: Call /api/v1/regions to see available proxy locations

Troubleshooting

• - Connection refused: Verify target URL is accessible and not blocking proxy IPs
• Slow responses: Try a different proxy region closer to your target server
• Balance not updating: Blockchain confirmations may take 1-2 minutes on Polygon

---

Built with ❤️ for the AI Agent ecosystem