Документация
Протокол 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 с |
Глобальный веб-поиск Глобальный веб-поиск (Tavily через x402): живые результаты по любому запросу, готовые для контекста агента. | /v1/web-search | $0.02 | ~2 с |
Страница → Markdown Извлечение чистого текста со страницы (trafilatura): URL на входе, Markdown на выходе. | /v1/ru-page | $0.01 | ~2 с |
Досье по теме Поиск по рунету + сборка топ-страниц в один структурированный Markdown-отчёт одним платежом. | /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 с |
Крипто-тикеры Крипто-тикеры Bybit (public API): цена, изменение и объём по паре — оплата через x402. | /v1/ticker | $0.01 | latency.~0.3 с |
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Манифесты и спецификации
Вопросы? Пишите на support@payforapi.com.