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:

RiskDescriptionMitigationCustody RiskUser funds are held in platform-controlled walletsUse small amounts, withdraw frequentlyOperator RiskPlatform operator could mismanage fundsOpen source, audited codeSmart Contract RiskPayment verification relies on external contractsMulti-sig, timelock protectionsPrivacy RiskAll requests visible to proxy operatorSelf-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#

ComponentVersionRequiredNotesPython3.10+✅Core runtimeRedis6.0+⚠️Required for production (multi-process safety)Polygon RPC-✅Mainnet or testnet endpoint

Python Packages#

text

fastapi>=0.100.0
uvicorn>=0.23.0
redis>=4.6.0
web3>=6.0.0
pydantic>=2.0.0
python-dotenv>=1.0.0
httpx>=0.24.0

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?#

FeatureBenefit🎁 10 Free RequestsStart instantly, no credit card required⚡ Zero ConfigurationNo local proxy setup, just call the API💵 Pay-Per-UseOnly $0.001 per request, no subscriptions🔐 Security Audited6 security audits, 13 P0 vulnerabilities fixed📖 Open SourceMIT licensed, fully auditable code🌍 Multi-RegionUS, EU, Asia proxy nodes🔗 Web3 NativePolygon blockchain, USDC payments🏠 Self-Host ReadyDeploy your own instance in minutes

---

🚀 Quick Start#

1. Start with Free Trial (10 Requests)#

python

import requests

try:
    response = requests.post(
        "https://proxy.easky.cn/api/v1/fetch",
        headers={"X-Client-ID": "my_agent_001"},
        json={
            "url": "https://api.github.com/users/github",
            "method": "GET"
        },
        timeout=30
    )
    response.raise_for_status()

    data = response.json()
    print(data["content"])  # Response content
    print(f"Remaining free calls: {data['remaining_calls']}")

except requests.exceptions.HTTPError as e:
    if e.response.status_code == 429:
        print("Error: Rate limit exceeded or free trial exhausted. Please deposit USDC to continue.")
    elif e.response.status_code == 401:
        print("Error: Invalid or missing API key.")
    else:
        print(f"HTTP Error: {e}")
except requests.exceptions.Timeout:
    print("Error: Request timed out. The target server may be slow.")
except requests.exceptions.RequestException as e:
    print(f"Request failed: {e}")

2. Continue with Paid Mode#

After free trial, deposit USDC to continue:

python

import requests

# Use your user_id as API Key after deposit
headers = {"X-API-Key": "my_agent_001"}

try:
    response = requests.post(
        "https://proxy.easky.cn/api/v1/fetch",
        headers=headers,
        json={
            "url": "https://api.example.com/data",
            "method": "GET"
        },
        timeout=30
    )
    response.raise_for_status()

    data = response.json()
    print(f"Response: {data['content']}")
    print(f"Balance remaining: {data.get('balance', 'N/A')} USDC")

except requests.exceptions.HTTPError as e:
    if e.response.status_code == 402:
        print("Error: Insufficient balance. Please deposit more USDC.")
    elif e.response.status_code == 429:
        print("Error: Rate limit exceeded.")
    else:
        print(f"HTTP Error: {e}")
except requests.exceptions.Timeout:
    print("Error: Request timed out.")
except requests.exceptions.RequestException as e:
    print(f"Request failed: {e}")

---

💰 Pricing#

TierPriceFeaturesFree Trial****FREE10 requests, no registrationPay-Per-Use****$0.001/requestUnlimited calls, pay as you goSelf-Hosted****FREERun your own server

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

---

🌐 API Endpoints#

EndpointMethodDescriptionAuth/GETService infoNone/healthGETHealth checkNone/network-infoGETNetwork configurationNone/api/v1/regionsGETAvailable proxy regionsNone/api/v1/fetchPOSTFetch any URL via proxyClient ID or API Key/deposit-infoGETGet deposit addressNone/balanceGETCheck balanceClient ID

---

🏠 Self-Hosting Guide#

Why Self-Host?#

AspectHosted ServiceSelf-HostedPrivacyServer sees all requestsComplete privacyControlPlatform managedFull controlCostPer-request feesServer costs onlyTrustRequires trustTrustlessSetupInstant5-minute setup

Quick Deploy#

bash

# 1. Clone repository
git clone https://github.com/openclaw/proxy-gateway.git
cd proxy-gateway

# 2. Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# 3. Install dependencies
pip install -r requirements.txt

# 4. Configure environment
cp .env.example .env
# Edit .env with your settings:
# - HOSTED_WALLET: Your Polygon wallet address
# - ADMIN_TOKEN: Secure random string (16+ chars)

# 5. Start server
uvicorn app.main:app --host 0.0.0.0 --port 8080

Docker Deploy#

bash

# Build image
docker build -t proxy-gateway .

# Run container
docker run -d \
  -p 8080:8080 \
  -e NETWORK=mainnet \
  -e HOSTED_WALLET=0x... \
  -e ADMIN_TOKEN=... \
  proxy-gateway

---

🔒 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)#

VariableDescriptionExampleHOSTED_WALLETPolygon address for USDC deposits0x1234...abcd``ADMIN_TOKENAdmin authentication tokenrandom_string_16+

Optional#

VariableDefaultDescriptionNETWORK``testnetNetwork mode (mainnet/testnet)REDIS_HOST``localhostRedis server hostREDIS_PORT``6379Redis server portFREE_TRIAL_LIMIT``10Free trial request limitCOST_PER_REQUEST``0.001Price 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