Перейти к содержимому
AwesomeFee
en Кабинет

ИИ-агенты: ресурсы TRON по x402

Энергия, отправка транзакций и доступ к ноде для агентов с оплатой USDC в Base за вызов. Без регистрации и ключей.

Агент, которому нужно перевести USDT или вызвать контракт в TRON, получает ресурс у AwesomeFee за один HTTP-обмен и платит USDC в сети Base по протоколу x402 (версия 2). Без регистрации, ключа API и баланса у нас. Плательщик подписывает разрешение на перевод USDC (EIP-3009) и не платит газ; отправителю в TRON не нужен TRX.

API: https://api.awesomefee.com · OpenAPI · llms.txt для агентов · Навык (SKILL.md) · Всё одним файлом (тексты для агентов — на английском)

Как это работает

  1. Найти: GET https://api.awesomefee.com/v1/search?q=<что нужно> — бесплатно; в ответе записи каталога (id, method, url, parameters, price, payment: free | x402 | pass, пример curl); без q — весь каталог.
  2. Вызвать адрес клиентом x402 v2 (@x402/fetch, @x402/axios, Python x402).
  3. На 402 клиент оплачивает условия в USDC со своего кошелька агента и повторяет запрос.
  4. Получить результат.

Что продаём

ЭндпоинтЧто получает агентОплата
GET /v1/search?q=адрес продукта под задачу, метод, входные данные и цена — начинать отсюдабесплатно
GET /x402/v1/quoteцена энергии или отправки (с burn_equivalent), тарифы пропусковбесплатно
POST /x402/v1/tron/estimateэнергия и полоса транзакции, что уже есть у отправителя, чего не хватает, ценабесплатно
GET /x402/v1/address/{address}расход и сожжённый TRX адреса за 7 днейбесплатно
POST /x402/v1/tron/sendотправка с энергией: агент присылает подписанную транзакцию, мы делегируем отправителю недостающую энергию, отправляем транзакцию без изменений и отвечаем txid и блокомx402
POST /x402/v1/tron/energyэнергия на любой адрес на 1000 блоков (~50 мин)x402
POST /x402/v1/proxy/passпропуск авансом: отправка через наш Proxy (/proxy/wallet/broadcasttransaction), энергия перед каждой транзакцией привязанных отправителей по цене для агентовx402
POST /x402/v1/rpc/passпропуск авансом на чтение полной ноды TRON по /rpc (TronWeb fullHost + TRON-PRO-API-KEY), вся историяx402
POST /x402/v1/events/subпропуск авансом на события адресов TRON: переводы, делегации, расход ресурсов; вебхук или WebSocket по /v1/eventsx402
GET /x402/v1/passостаток пропуска (Authorization: Bearer <токен>)бесплатно
GET /x402/v1/payments/{id}состояние оплаченного заказа и возвратабесплатно

tier — имя тарифа или его цена в USDC. Ответ: pass_id, token (tlp_…, сохраните), tier, unit, added_credits, expires_at, limits, rpc_url или events_url, balance_url. Повторная покупка с токеном в Authorization: Bearer пополняет пропуск. Всё, что продаём: GET /x402/v1.

Цены

  • Цена для агентов — распродажная: в USDC по живому курсу TRX/USD, известна до оплаты (GET /x402/v1/quote).
  • В каждой котировке есть burn_equivalent_sun и burn_equivalent_usd — сколько отправитель сжёг бы без нас (100 SUN за единицу энергии; перевод USDT — около 64 285 энергии, на адрес без USDT — около 130 285).
  • Котировка, оценка транзакции, анализ адреса, остаток пропуска и состояние заказа — бесплатно.
  • Чтение ноды: кредиты за вызов (1 за обычный, 2–10 за тяжёлый); события: 1 кредит за доставленное событие.

Тарифы пропусков

ПропускТариф (имя или USDC)Что входитДней
Чтение нодыrpc-trial · rpc-s · rpc-m · rpc-l · rpc-xl (0,5 · 9 · 35 · 120 · 300)50 000 · 1M · 5M · 20M · 60M кредитов; 5 · 10 · 25 · 50 · 100 rps7 для 0,5, иначе 30
События адресовev-s · ev-m · ev-l (3 · 15 · 60)10 · 100 · 1 000 адресов; 200 000 · 2M · 10M событий30
Proxyproxy-5 · proxy-20 · proxy-100 (5 · 20 · 100)кредиты в USDC; энергия на каждую транзакцию до 5 привязанных отправителей по цене для агентов30

Цикл оплаты

агент → POST https://api.awesomefee.com/x402/v1/tron/send   {"signed_tx": {…}}
      ← 402  PAYMENT-REQUIRED: base64 {"x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453",
                                       "amount":"<USDC, 6 знаков>","asset":"<USDC>","payTo":"0x…", …}]}
агент подписывает одну запись "accepts" своим кошельком (EIP-3009, без газа)
агент → POST https://api.awesomefee.com/x402/v1/tron/send   {"signed_tx": {…}}  + PAYMENT-SIGNATURE: base64 PaymentPayload
      ← 200  {"status":"confirmed","txid":"…","block":…,"result":"SUCCESS","energy_used":64285,"energy_burned_sun":0}
             (202 {"status":"pending","status_url":"…/x402/v1/payments/xp_…"} — оплачено, ещё выполняется)
             PAYMENT-RESPONSE: base64 {"success":true,"transaction":"0x…","network":"eip155:8453","payer":"0x…"}

Это делает любой клиент x402 v2: @x402/fetch, @x402/axios, Python x402. Примеры: curl (с подписчиком), @x402/fetch, @x402/axios, Python.

Отказы и возвраты

  • Проверяется до 402, ничего не списывается: просроченная транзакция, вызов, который откатится, тип вне списка (TRX, TRC-20 и вызовы контрактов, TRC-10), неактивированный отправитель, больше 300 000 энергии, нехватка собственной полосы отправителя (полосу пока не продаём), нет ёмкости, лимит частоты.
  • Оплачено, но не выполнено по нашей вине — USDC автоматически возвращается плательщику.
  • Выполнено, но транзакция агента откатилась в сети — возврата нет: ресурс израсходован.
  • Повтор с той же оплатой возвращает тот же ответ.

Как агенты нас находят

  • MCP-сервер: https://api.awesomefee.com/mcp — один инструмент search и эти описания как ресурсы, см. MCP-сервер.
  • https://api.awesomefee.com/.well-known/x402 — манифест x402; https://api.awesomefee.com/.well-known/ai-catalog.json и https://api.awesomefee.com/mcp/server-card — обнаружение MCP.