x402.ai x402.aiПротокол x402 превращает оплату API в обычный платёжный ответ сервера. x402-wallet держит ключи. Агент получает данные — сервис получает USDC. Без карт, без OAuth, без офиса.
Как это работает → Читать о ИИ-агентах
Открытый платёжный протокол для машин. Вместо редиректов и логинов — стандартный HTTP-ответ 402 Payment Required, несущий платёжные инструкции.
Клиент (агент) шлёт обычный запрос. Сервер отвечает 402 с ценой и адресом оплаты в заголовке PAYMENT-REQUIRED.
Расчёты в стейблкоине, микросуммы, почти нулевая комиссия. Подходит для тысяч вызовов в минуту.
Никаких API-ключей вручную, никаких договоров. Есть баланс — есть доступ. Нет баланса — сервер вежливо отказал.
x402 спроектирован так, чтобы им пользовался софт, а не вы. Агент сам решает: заплатить и получить данные, или нет.
x402-wallet — CLI-кошелёк для x402-платежей: хранит ключи и подписывает платежи от имени агента. Сам цикл выглядит так:
Агент стучится к платному эндпоинту. Например, запрашивает свежие рыночные данные или вызов LLM.
402 Payment RequiredВ заголовке PAYMENT-REQUIRED — цена в USDC и адрес для оплаты. Агент видит: «столько стоит этот вызов».
Кошелёк агента формирует платёжную авторизацию (USDC), и клиентский SDK прикладывает её к повторному запросу. Подпись берёт на себя протокол.
Платёж валидируется через facilitator (settlement), и агент получает ответ. Всё за одну-две сетевые итерации, без редиректов.
// Node.js (x402 client SDK)
import { x402 } from "x402";
const res = await x402.fetch("https://api.example.com/data"); // платит сам, если пришёл 402
Факты по спецификации: сервер отвечает 402 Payment Required с инструкцией в заголовке PAYMENT-REQUIRED; клиент платит через SDK. Точный тип кошелька (x402-wallet, CDP-managed и др.) зависит от вашей реализации — см. docs.x402.org.
Минимальный путь, чтобы ваш агент начал платить через x402. Нужен Node.js (или Python) и немного USDC в сети Base.
Официальный Python SDK — x402 (PyPI). CLI-кошелёк для автономных платежей агентов — x402-wallet. Сид-фразу держите локально, не в облаке.
# Python SDK pip install x402 # CLI-кошелёк для агентов (npm >= 18) npm i -g x402-wallet # проверка x402-wallet --help
Команда генерирует приватный ключ локально (в Base). Никуда не уходит. Сохраните сид-фразу в надёжном месте.
x402-wallet init --network base # выведет seed-фразу и адрес — запишите их x402-wallet address # 0x... <- сюда переводить USDC
Переведите немного USDC в сети Base на адрес из предыдущего шага. Этого хватит на тысячи микровызовов. Проверить баланс:
x402-wallet balance --token usdc # Balance: 2.50 USDC
В коде агента используйте x402-клиент: он сам поймёт 402, подпишет платёж кошельком и повторит запрос. Никакой ручной логики оплаты писать не нужно.
// Node.js
import { x402 } from "x402";
const data = await x402.fetch(url); // платит автоматически
# Python
from x402 import x402_fetch
data = x402_fetch(url) # тоже авто-оплата
Запустите агента. Первый платный запрос пройдёт через 402 → подпись → данные. Готово — агент платит сам.
python agent.py # или node agent.js
Команды выше — рабочий минимум по официальным SDK (PyPI: x402, CLI: x402-wallet). Точные имена пакетов и флагов уточняйте в документации под вашу версию: docs.x402.org.
Идея x402 — в том, чтобы агенты были полезными и самодостаточными. Мы собрали одного такого: он круглосуточно сканирует рынок BTC/ETH, ищет дивергенции RSI и объёмные импульсы и присылает сигналы, по которым можно ставить грид-ботов.
Это не «гарантия прибыли» и не финсовет — просто рабочий пример агента, который делает рутину за вас. Решать, торговать или нет, всё равно вам.
Ссылка ведёт на внешний сервис. Относитесь к торговле ответственно.
CLI-кошелёк для автономных x402-платежей агента. Ниже — основные команды после установки через npm i -g x402-wallet. Имена флагов могут отличаться по версиям — проверяйте x402-wallet --help.
Создать новый кошелёк агента (или импортировать сид-фразу). Генерирует приватный ключ локально — никуда не уходит.
x402-wallet init --network base
Показать адрес кошелька в сети Base. На него нужно перевести USDC.
x402-wallet address
Проверить баланс USDC. Если пусто — агент не сможет платить за вызовы.
x402-wallet balance --token usdc
Вручную подписать платёж для URL (для тестов). В коде агента это делает SDK автоматически.
x402-wallet pay --url https://api.example.com/data
Точные флаги зависят от версии x402-wallet (GitHub 0xKoda/x402-wallet). Команда x402-wallet --help покажет актуальный список.
Коротко по самому важному. Без воды.
Базовая сеть — Base (L2 Ethereum). Расчёты в USDC. Комиссии копеечные, подходят для микроплатежей.
Сам протокол бесплатен. Платите только за вызовы API тому сервису, к которому стучится агент. Микросуммы — центы и меньше.
Приватный ключ генерится и хранится локально (x402-wallet init). Не выгружайте сид-фразу в облако. Альтернатива — CDP-managed wallet (ключи у провайдера, но без локального файла).
Нет. Агент и кошелёк работают на той же машине, где запущен ваш скрипт. Достаточно Node.js или Python и баланса USDC.
Официально: x402.org и docs.x402.org. По x402-wallet — репозиторий на GitHub (0xKoda/x402-wallet) и сайт x402-wallet.com.
Сервер вернёт 402 с той же инструкцией. Агент просто не получит данные, пока вы не пополните USDC. Ничего не ломается.