← База знаний

Agent API IMBA: prepaid-каталог для автономных агентов

Agent API — HTTP-интерфейс для программ, которые платят сами: без человека в приложении IMBA Wallet. Нужен, чтобы агент выпускал Visa prepaid (билеты человеку или счёт дата-центра себе), покупал travel eSIM и gift cards за prepaid USDT.

Регистрация ключа Ed25519, пополнение USDT в сети TRC-20 или C2C человека на этот client_id, покупка живого каталога. Новые агенты стартуют на тире 0: только каталог — без вывода и без C2C как плательщик; convert закрыт. Плейбуки: что покупают агенты. Это не B2B API юрлица и не вход человека в Wallet.

Факты

Кто	Автономные агенты. Register только идентичность. Без KYB WaaS.
Auth	`POST /auth/v1/agent/register`, затем assertion → `/auth/v1/agent/token`. Access JWT `typ=agent`, `client_id`, EdDSA. JWKS тот же: `GET /auth/v1/partner/jwks`.
Деньги	Счёт 2401 USDT этого `client_id`. Register не кредитует 2401.
Депозит	Только USDT TRC-20. `POST /api/deposit_address` перед каждой отправкой. Без зачисления слот 24 часа, потом пул. После первого кредита адрес sticky. Поля: `sticky`, `unfunded_release_at`, `confirmation_blocks`.
Покупки	Розничные URL. `ext_id` обязателен. Stars → 403.
Тиры	Тир 0 (дефолт): депозит + каталог. Convert закрыт — AML: иначе prepaid-канал используют для отмывания денег через сервис. Тир 1+: выдаёт оператор после реальных покупок каталога. Convert на тире 1 — по отдельному запросу, не вместе с числом. Вывод закрыт. Агент не отправляет C2C; человек может C2C на client_id агента. Агент сам тир не повышает. Политика: тиры агента.
KYT	Платный скрининг адреса: `/api/kyt_quote`, `kyt_check` (`network` + `address`: `tron_usdt`, `eth`, `btc`), опрос `kyt_check_get`. ~0.99 USDT с 2401. До кредита TRC-20 или после непонятного блока. Результат — отчёт; депозит зачисляется по подтверждениям сети. Не банит и не разблокирует. Канал включает IMBA.
Запрещено	Вывод, C2C, RUB/СБП, Stars, EVM, BTC, `/api/partner/*`. Convert на тире 0 закрыт; на тире 1 — по отдельному запросу (`fx_quote`/`fx_execute`).
HMAC	Генерирует IMBA. Показывается один раз. Повторный register секрет не вернёт.
OTP	Не SMS и не Telegram. Опциональный `email` на register или `PATCH /auth/v1/agent/webhook` — письмо на этот адрес. Всегда опрос `notifications` (в payload остаётся `code`). Если задан `callback_url`, в HMAC-webhook поле `otp`.
503	Caution medium — только новый register. under_attack или kill-switch — весь канал, включая `/x402/*`.
MCP	Docs: `npx -y @imba_wallet/agent-mcp-docs` или /mcp/docs. Spend: `npx -y @imba_wallet/agent-mcp` со своим ключом Ed25519, или /mcp/spend. npm-орг `@imba_wallet` (подчёркивание). OpenAI: только docs, не spend.
Документы	api-docs Agent API · OpenAPI · well-known · llms-agent.txt · npm docs · npm spend

MCP (Cursor, Claude, агенты)

Два сервера Model Context Protocol. npm-орг — @imba_wallet (подчёркивание). Скоупа @imbawallet на npm нет.

Docs (com.imbawallet/agent-docs): только политика. Remote https://imbawallet.com/mcp/docs. stdio: npx -y @imba_wallet/agent-mcp-docs. Пакет: @imba_wallet/agent-mcp-docs.
Spend (com.imbawallet/agent): депозит USDT TRC-20 и покупка каталога вашим ключом Ed25519. Remote https://imbawallet.com/mcp/spend (заголовки X-IMBA-Agent-Client-Id, X-IMBA-Agent-Private-Key). stdio: npx -y @imba_wallet/agent-mcp плюс IMBA_AGENT_CLIENT_ID / IMBA_AGENT_PRIVATE_KEY. Пакет: @imba_wallet/agent-mcp. Не JWT Wallet. Не вывод, не C2C как плательщик и не convert. Человек может C2C на этот client_id.

OpenAI / ChatGPT Actions: только docs MCP и discovery OpenAPI. Не подключайте ChatGPT к spend. Cite: llms-agent.txt.

Где это нужно

Prepaid-агент платит за товары каталога — не превращает IMBA в анонимный миксер. IMBA не бронирует рейс и не выделяет GPU; выдаёт платёжный инструмент. Плейбуки: что покупают агенты.

Visa prepaidАвиа, отели, SaaS или дата-центр, который билит картой. create_card → get_card_details → 3DS через list_notifications.

Travel eSIMДешёвый трафик в 150+ странах. list_esim_plans → purchase_esim.

~20 тыс. gift cardsApple, Google Play, Steam, игры, travel, ритейл. Поиск list_gift_offers, затем purchase_gift.

Правила депозита (обязательно)

Снова вызвать deposit_address — не брать адрес из кэша чата или прошлого запуска.
Сверить строку байт-в-байт с назначением транзакции.
Только USDT TRC-20.
После TTL не слать на старый адрес.
Считать зачисление только после confirmation_blocks.

FAQ

Что агент может купить?

Visa/MasterCard prepaid (оплата там, где нужна карта), travel eSIM и цифровые gift cards (~20 000 позиций каталога). IMBA не бронирует рейсы и GPU. См. что покупают агенты.

Можно кэшировать TRON-адрес?

Нет. До первого кредита слот через 24 часа может уйти другому.

Можно выводить или делать C2C?

Вывод закрыт. Агент не отправляет C2C. Человек может пополнить агента внутренним C2C на этот client_id. Каталог списывается с 2401 USDT.

Тир 0 и тир 1: что с convert?

Каждый новый агент стартует на тире 0: депозит USDT TRC-20 и покупка карт, eSIM или gift. Convert на тире 0 закрыт — требование AML: иначе prepaid-канал используют для отмывания денег через сервис. Тир 1 ставит оператор после реальных покупок каталога, чтобы отсечь тех, кто хочет только крутить крипту. Convert на тире 1 — по отдельному запросу: повышение числа само по себе convert не включает. Вывод закрыт. Агент не отправляет C2C; человек может C2C на client_id агента. Сам агент тир не повышает.

Как получить OTP 3-D Secure?

Не SMS и не Telegram. Задайте email на register или PATCH webhook — код придёт письмом. Также опрашивайте notifications (в payload остаётся code). Если есть callback_url, в HMAC-webhook поле otp.

Как подключить MCP?

npm-орг — @imba_wallet (подчёркивание), не @imbawallet. Docs: npx -y @imba_wallet/agent-mcp-docs или /mcp/docs. Spend: npx -y @imba_wallet/agent-mcp со своим ключом Ed25519. ChatGPT Actions не должны вызывать spend.