ИИ-агент может сам пройти весь цикл через API: проверить предложения, пополнить баланс своими USDC, арендовать выделенный мобильный прокси на 1 или 30 дней, получить данные подключения, менять IP и продлевать аренду. Вы один раз настраиваете его с API-ключом; дальше панель управления ему не нужна.
- Базовый адрес API:
https://ipvolt.com/beta/api/v1 - Адрес оплаты для пополнений:
https://ipvolt.com/api/v1 - Справочник API, описание OpenAPI и настройка Proxy Toolkit MCP (на английском)
Цикл
- Проверить предложения:
GET /stock, ключ не нужен. - Пополнить баланс:
GET /fund?amountMinor=Nотвечает402с предложением. Агент подписывает перевод USDC в сети Base, отправляет его со своим ключом и опрашиваетstatusUrl, пока платёж не станетcredited, обычно в течение нескольких минут. От $1 до $500 за пополнение; подробности — в разделе «Пополнение баланса агентом» справочника API. - Арендовать:
POST /rentalsсIdempotency-Keyи максимальной ценой за устройство вmaxPriceMinor, затемGET /orders/{orderId}, пока заказ в статусеpaid. - Получить данные подключения: когда заказ
fulfilled,GET /rentals/{id}даёт хост, порты, логин и пароль прокси. - Сменить IP:
POST /rentals/{id}/rotateзапрашивает новый IP. - Продлить:
GET /rentals/{id}/extension-price, затемPOST /rentals/{id}/extendсIdempotency-KeyиmaxPriceMinor.
Аренда и продление оплачиваются с баланса и учитываются в дневном лимите ключа. Пополнение тратит собственные USDC агента, никогда не деньги клиента, и не возвращается в блокчейне: оно остаётся на балансе.
Разовая настройка
- В разделе Account settings → API keys панели управления создайте ключ с доступом на чтение и запись, сроком 30 или 90 дней и дневным лимитом. Скопируйте ключ: он показывается один раз.
- Передайте ключ агенту в переменной окружения
IPVOLT_API_KEYи никогда не передавайте его в промпте. - Для пополнений дайте ему кошелёк с USDC в сети Base, закрытый ключ которого тоже хранится в его окружении. Вы также можете сами пополнить баланс в панели управления.
Ключ только для чтения позволяет агенту смотреть, ничего не тратя. В справочнике API есть все эндпоинты, ошибки и примеры на cURL, Python и Node.js, в том числе пополнение баланса с последующей арендой.
Proxy Toolkit MCP
При локальном запуске сервер Proxy Toolkit MCP (на английском) добавляет инструменты для работы с аккаунтом, если в его окружении задана IPVOLT_API_KEY; они обращаются к API с этим ключом. Без этой переменной у локального сервера нет инструментов аккаунта, а у размещённого сервера https://mcp.ipvolt.com/mcp остаются его четыре инструмента, которым ключ не нужен.
{
"mcpServers": {
"ipvolt-proxy-toolkit": {
"command": "npx",
"args": [
"--yes",
"@ipvolt/proxy-toolkit-mcp@0.3.0"
],
"env": {
"IPVOLT_API_KEY": "YOUR_API_KEY"
}
}
}
}В конфигурации хранится ключ, поэтому держите файл в закрытом доступе. Чтобы попробовать инструменты до создания аккаунта, задайте вместо ключа IPVOLT_SANDBOX со значением 1: тогда они работают с имитацией аккаунта внутри локального сервера, не отправляют запросов в ipvolt и ничего не списывают.
Без аккаунта
Агент может арендовать выделенный мобильный прокси и без аккаунта ipvolt. Он создаёт заказ запросом POST /guest/orders, принимая Условия, и один раз получает идентификатор счёта (invoice ID). Он платит своими USDC по адресу оплаты, указанному выше, отправляя идентификатор счёта в заголовке Authorization, а затем арендует через POST /rentals. GET /guest описывает шаги, версию Условий и лимиты. Идентификатор счёта — единственный способ вернуться к заказу: агент должен хранить его в секрете и не потерять. Пакет трафика покупается так же: в заказе указывается его packId, а POST /traffic/purchase оплачивает его с баланса заказа.
Токены агентов
Агент может получить доступ и через auth.md вместо ключа: вы подтверждаете его 6-значным кодом и выбираете доступ только для просмотра или лимит расходов.
Ко всему, что агент делает через API, применяются Правила допустимого использования (на английском).