Quick Start

Installation

pip install asockslib

Or with uv:

uv add asockslib

Set your API key

export ASOCKS_API_KEY="sk-your-api-key"

Python — async usage

import asyncio
from asockslib import ASocksClient

async def main():
    async with ASocksClient(api_key="sk-...") as client:
        # Check balance
        balance = await client.get_balance()
        print(f"Balance: ${balance.balance}")

        # List existing proxy ports
        ports = await client.list_ports()
        for p in ports.items:
            print(p.proxy_url)

asyncio.run(main())

CLI — quick commands

# Generate 10 US SOCKS5 proxies
asocks generate 10 --country US --format txt

# Interactive wizard
asocks wizard

# List all your ports
asocks list

# Check account balance
asocks balance

# See all available countries
asocks countries

Next steps

• Smart Proxy Manager — automatic rotation & healing
• CLI Reference — full command details
• API Reference — all client methods