ИИ-агенты: ресурсы 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) · Всё одним файлом (тексты для агентов — на английском)
Как это работает
- Найти:
GET https://api.awesomefee.com/v1/search?q=<что нужно>— бесплатно; в ответе записи каталога (id,method,url,parameters,price,payment: free | x402 | pass, примерcurl); безq— весь каталог. - Вызвать адрес клиентом x402 v2 (
@x402/fetch,@x402/axios, Pythonx402). - На 402 клиент оплачивает условия в USDC со своего кошелька агента и повторяет запрос.
- Получить результат.
Что продаём
| Эндпоинт | Что получает агент | Оплата |
|---|---|---|
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/events | x402 |
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 rps | 7 для 0,5, иначе 30 |
| События адресов | ev-s · ev-m · ev-l (3 · 15 · 60) | 10 · 100 · 1 000 адресов; 200 000 · 2M · 10M событий | 30 |
| Proxy | proxy-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.