Документация

Протокол x402 и API PAYFORAPI

Как агент находит сервис, платит за вызов и получает данные. Без аккаунтов, подписок и API-ключей.

Что такое x402

402 Payment Required

Сервер отвечает HTTP 402 и прикладывает манифест платежа: сколько, в какой валюте (USDC, сеть Base) и на какой адрес платить.

Газлесс-платёж

Клиент подписывает EIP-3009 (transferWithAuthorization) — комиссию за газ платит facilitator, у покупателя не обязано быть ETH.

Мгновенный расчёт

Facilitator подтверждает платёж, продавец сразу отдаёт ответ. Деньги поступают напрямую продавцу — площадка не кастодиан.

Как платить

Три шага до данных

1Вызовите эндпоинт — сервер ответит 402 и манифестом платежа.
2Подпишите платёж приватным ключом (EIP-3009) и повторите запрос с подписью.
3Получите 200 с данными. Оплачен только этот вызов — без подписок.

Совместимы с Machine Payments Protocol (MPP v2) — платёжный цикл проверен живым тестом клиента mppx (EIP-3009, USDC на Base).

Готовые клиенты: официальный SDK x402 (TypeScript), Python-пакет x402 и mppx (Machine Payments Protocol). x402 (TypeScript), x402 (Python), mppx (Machine Payments Protocol).

# 1. Prices and manifest
curl https://payforapi.com/.well-known/x402.json

# 2. Call — the server answers 402 + payment manifest
curl -X POST https://payforapi.com/v1/inn-lookup \\
  -H 'Content-Type: application/json' \\
  -d '{"inn": "7707083893"}'

# 3. Signature (EIP-3009) and retry with payment
curl -X POST https://payforapi.com/v1/inn-lookup \\
  -H 'Content-Type: application/json' \\
  -H 'PAYMENT-SIGNATURE: <signed-voucher>' \\
  -d '{"inn": "7707083893"}'
# → 200 + EGRUL data

# Alternative: mppx (pays for you)
MPPX_PRIVATE_KEY=0x... npx mppx \\
  https://payforapi.com/v1/inn-lookup \\
  -J '{"inn": "7707083893"}' --network mainnet

Эндпоинты

Все сервисы оплачиваются за вызов в USDC (Base). Полный каталог — на странице каталога. странице каталога.

Сервис	Эндпоинт	Цена	Время
Проверка российской компании по ИНН Проверка российской компании/ИП по ИНН — официальный госреестр ЕГРЮЛ, недоступный зарубежным сервисам. Статус, руководитель, реквизиты. Без капчи.	`/v1/inn-lookup`	$0.01	~2 с
Поиск по рунету Поиск по рунету (русскоязычному интернету) через Яндекс — товары, цены, продавцы, отзывы, которых нет в англоязычных поисках. Единственное легальное окно в российский рынок.	`/v1/ru-search`	$0.02	~1.5 с
RU-поиск ×10 RU-поиск пакетом: до 10 поисков по русскоязычному интернету через Яндекс за один платёж со скидкой 10% — список запросов и готовые результаты по каждому. Для агентов, которые ищут пакетами: цены, продавцы, отзывы.	`/v1/ru-search/x10`	$0.18	latency.~3–5 с
RU-поиск ×100 RU-поиск максимальным пакетом: до 100 поисков по русскоязычному интернету через Яндекс за один платёж со скидкой 20% — массовый сбор данных рунета одним вызовом: каталоги, поставщики, мониторинг цен.	`/v1/ru-search/x100`	$1.60	latency.~15–25 с
Глобальный веб-поиск Глобальный поиск (Tavily) — западная половина пары с рунет-поиском: иностранные поставщики, мировые цены, зарубежные новости о России. Сравнение «вне vs внутри» РФ-рынка.	`/v1/web-search`	$0.02	~2 с
Русскоязычная страница → Markdown Чистый текст русскоязычной страницы в Markdown (trafilatura) — карточка товара, магазин, новость. Нативная обработка, точнее западных инструментов.	`/v1/ru-page`	$0.01	~2 с
Досье по рунету Поиск по рунету + сборка топ-страниц в один отчёт — досье на продавца, товар или компанию из эксклюзивных русскоязычных источников: отзывы, репутация, новости.	`/v1/research`	$0.02	~3 с
Глубокое досье по рунету Три поиска, до 10 страниц из эксклюзивных российских источников — суды, СМИ, реестры. Проверка продавца и владельцев перед крупной сделкой.	`/v1/research/deep`	$0.05	~20 с
Трекинг Почты России Статус и история отправления по трек-номеру через официальный SOAP Почты России — единственный легальный трекинг РФ.	`/v1/pochta-track`	$0.01	~2 с
Тарифы Почты России Расчёт стоимости доставки Почтой России: посылки, письма, бандероли — по классу и весу. Для корзины с доставкой по РФ.	`/v1/pochta-tariff`	$0.01	~1.5 с
Сроки доставки Почты России Контрольные сроки доставки между отделениями Почты России — когда заказ дойдёт до покупателя.	`/v1/pochta-delivery-time`	$0.01	~1.5 с
Отделения Почты России Поиск отделений Почты России: адрес, режим, услуги. Пункты выдачи по всей России.	`/v1/pochta-offices`	$0.01	~1.5 с
Почтовые индексы РФ Проверка и поиск почтовых индексов РФ по адресу или отделению. Валидация адреса доставки.	`/v1/pochta-zip`	$0.01	~1 с
Нормализация адресов РФ Приведение адреса к стандарту Почты России: индекс, регион, улица, дом. Чистый адрес доставки по РФ.	`/v1/pochta-address`	$0.01	~1.5 с
Доставка Почты России Пакет «Доставка Почты России»: адрес, индекс, отделение, стоимость и срок доставки — одним платежом. Весь расчёт доставки в корзине за один вызов.	`/v1/pochta-delivery`	$0.04	~4 с
Проверка контрагента (KYB-досье) Пакет «Проверка контрагента»: ЕГРЮЛ + статус самозанятого (НПД) + deep-досье по рунету — одним платежом. KYB-решение «платить или нет» за один вызов.	`/v1/company-report`	$0.05	~20 с
Крипто-тикеры Крипто-тикеры Bybit: цена, изменение, объём. Цена товара/услуги в криптовалюте.	`/v1/ticker`	$0.01	latency.~0.3 с
Курсы ЦБ РФ Официальные курсы валют ЦБ РФ — государственный референс для пересчёта цен в рубли.	`/v1/cbr-rates`	$0.01	latency.~0.2 с
Котировки Мосбиржи Акции, валюта и индексы Мосбиржи: цена, изменение, объём. Живые данные российского рынка.	`/v1/moex-quote`	$0.01	latency.~0.3 с
Статус самозанятого РФ (НПД) Проверка через ФНС по ИНН: зарегистрирован ли человек как самозанятый РФ (НПД). Перед выплатой подрядчику.	`/v1/fns-npd-check`	$0.01	~1 с
Agent Data Pro Премиальные исследовательские статьи для ИИ-агентов: on-chain сигналы, DeFi, governance, compliance. Оплата статьи через x402 (USDC на Base).	`https://agentdatapro.com/api/articles`	$0.01	—
AI Agents Archive Каталог «распакованных» работ агентов на Base: исследования, неудачные подходы и прогоны моделей — разблокировка каждой через x402 (USDC). Бесплатный каталог: /api/discover.	`https://aiagentsarchive.com/api/handoffs/AAA-2377/body`	$0.00	—

MCP-сервер

Подключите агента за одну строку

MCP (Model Context Protocol) — стандартный способ дать агенту инструменты. Наш сервер отдаёт 11 tools с x402-оплатой: ИНН, поиск, страницы, досье и сервисы Почты России.

# URL for any MCP client:
https://payforapi.com/mcp

# Claude Desktop / mcp-remote clients:
npx mcp-remote https://payforapi.com/mcp

# Available tools:
# inn_lookup, ru_search, ru_page,
# ru_research, ru_research_deep,
# pochta_tariff, pochta_track,
# pochta_delivery_time, pochta_offices,
# pochta_zip, pochta_address

Что такое x402: платёжный протокол для ИИ-агентовx402 — это открытый платёжный стандарт на базе HTTP-кода 402 Payment Required. Агент запрашивает данные, сервер отвечает ценой, агент платит в USDC — и получает ответ. Без подписок, без API-ключей, без аккаунтов.

Манифесты и спецификации

/.well-known/x402.jsonМанифест x402 — все эндпоинты, цены, i18n /llms.txtМашиночитаемое описание для LLM и агентов /openapi.jsonOpenAPI-спецификация (включая x-payment-info)/swaggerSwagger UI — интерактивный просмотр API /mcpMCP-сервер для агентов (streamable HTTP)/.well-known/mpp.jsonMPP-манифест — Machine Payments Protocol

Вопросы? Пишите на support@payforapi.com.