MERX - TRON Infrastructure for AI Agents

MERX

https://MERX.exchange

面向 AI Agent 的 TRON 基础设施。

66 个 MCP 工具。覆盖 6 家服务提供商的能源市场。支持 USDT/USDC/USDD 支付。基于 TRON 主网的 x402 v2 支付协调器。

文档 | API 参考 | MCP 服务

目录

• 什么是 MERX — 面向 AI Agent 的 TRON 基础设施
• 问题所在 — MERX 出现之前，TRON 为何没有 Agent 层
• 平台概览 — MCP、Agent 支付服务、x402、GasFree、能源聚合器
• 快速开始 — 4 种方式（Web、REST/SDK、Claude Code 插件、MCP）
• MERX 的独特之处 — TRON 上唯一完整的 Agent 技术栈
• 架构
• API 概览
• MCP 服务
• SDK
• 实时数据
• 支付方式
• 定期订单与监控器
• 储蓄计算器
• 错误处理
• 安全性
• 主网测试
• 与其他方案的比较
• 文档
• 许可证

什么是 MERX

MERX 是 TRON 上 AI Agent 和 Agent 网络的基础设施层。 Stripe 是 Web 商业的基础设施，Cloudflare 是开放网络的基础设施， 而 MERX 是缺失的基础设施层，让自主 AI Agent 能够在 TRON 上发现、 交易和运行，无需接触能量、带宽或 底层区块链机制。

该平台提供一套完整的技术栈：66 个工具的 MCP 服务、用于 TRC-20 稳定币的Agent 支付 服务、x402 v2 Facilitator（coinbase/x402 生态注册表中唯一的 TRON Facilitator）、通过 MERX 部署的主网控制器实现的 GasFree 转账、专用 TRON RPC 节点、A2A（Google， 7 项技能）和 ACP（BeeAI，7 项能力）协议支持，以及由 Anthropic Claude 驱动的自然语言策略引擎。

这些 Agent 接口之下，是一个由 6 家活跃服务商（CatFee、Netts、TronSave、iTRX、PowerSun、TEM）组成的能量聚合器，可自动将资源购买路由到最便宜的来源——因此，当 Agent 调用 send() 时，MERX 会估算所需能量，仅购买差额，然后广播交易。 Agent 无需持有 TRX，也无需考虑能量。

运行于 Claude、LangChain、CrewAI、Vertex AI、AutoGen 或 BeeAI 中的任何 AI Agent，都能通过与 MERX 的一次集成，在 TRON 上发送付款并获取资源。

将 Agent 接入 MERX 的三种方式：

• MCP 服务——为 AI Agent 提供 66 个工具。托管版 SSE 地址为 https://merx.exchange/mcp/sse（零安装），也可通过 npx merx-mcp 使用本地 stdio。兼容 Claude、GPT、Cursor、Windsurf 以及任何 兼容 MCP 的客户端。

• Claude Code 插件——为 Claude Code 提供一行命令即可完成安装。自动注册 MCP 服务，附带 6 个斜杠命令和一个 tron-agent-engineer 子 Agent。 详见 Hovsteder/merx-claude-plugin。

• REST API + SDK——为未使用 MCP 的 Agent 提供直接的程序化访问。可使用 JavaScript（npm 上的 merx-sdk v2.1）、Python（PyPI 上的 merx-sdk v2.1），或通过 /api/v1/ 发送原始 HTTP 请求（70 多个带版本号的端点）。

对于人类用户，仍可通过 merx.exchange 网页平台手动交易能量、使用仪表盘、存款和 提现——但该平台主要面向 Agent 构建。

问题

AI Agent 将成为稳定币交易的主要用户，而 TRON——USDD、$86B+ USDT、USDC 的所在地，也是东南亚、非洲和拉丁美洲零售 USDT 的主导链——已经是全球最大的 USDT 原生网络。

但 TRON 没有专为 Agent 设计的基础设施：

• 没有原生支持 Agent 的支付服务。 现有 TRON 钱包面向人类用户，依赖鼠标点击和助记词备份，而不是需要通过 REST 注册地址、发送 TRC-20 代币、监控入账并创建发票的自主程序。

• 能量和带宽让用户体验陷入僵局。 在 TRON 上，每次智能合约调用都需要能量。能量不足时，TRX 代币会被烧毁用作手续费——向冷钱包接收方转账一次 USDT 会烧掉 3-13 TRX（约 $1-4）。向服务商租用能量可将成本降至约 $0.10，降低 94%，但各服务商的价格、API、时长档位和故障模式都不同。不能指望 Agent 管理这些事项。

• 在 MERX 之前，TRON 上没有 x402 促进器。 x402 协议已在 Base、Solana、Stellar 和 Ethereum 上处理了 $43.57M 的 Agent 间支付。在 MERX 出现之前，TRON 完全未被纳入 coinbase/x402 生态注册表。想要用 USDT 支付托管在 TRON 上的 API 的 Agent，没有标准化的方式可用。

• 三种 Agent 协议，TRON 集成数为零。 MCP（Anthropic）、A2A（Google）和 ACP（BeeAI）是三种主要的 Agent 通信协议。在 MERX 出现之前，它们都没有已部署、达到生产级别的 TRON 服务。Claude、Vertex AI 或 BeeAI 中的 AI Agent 根本无法访问 TRON。

MERX 构建了缺失的基础层。AI Agent 调用一个 API，无需持有任何 TRX，即可在全球最大的 USDT 网络上使用 USDT、USDC 或 USDD 收款、付款、发送和接收。

平台概览

快速开始

根据使用场景，有四种接入方式。**对于 AI Agent，方式 3 和 4 是主要入口。**方式 1（网页）面向人工操作人员；方式 2（REST/SDK）面向直接的程序化集成。

方式 1：Web 平台（面向用户）

访问 merx.exchange。登录。存入 TRX。通过控制面板管理能量、Agent API 密钥和余额。无需编写代码。

方式 2：REST API / SDK（程序化接入）

安装 JavaScript SDK：

npm install merx-sdk

在应用程序中使用（将 merx_sk_your_key 替换为从 merx.exchange 获取的 API 密钥）：

import { MerxClient } from 'merx-sdk'

const merx = new MerxClient({ apiKey: 'merx_sk_your_key' })

// Get current prices from all providers
const prices = await merx.prices.list()
console.log(prices[0])
// { provider: "netts", price_sun: 22, available: 100000000 }

// Buy energy at best price
const order = await merx.orders.create({
  resource_type: 'ENERGY',
  amount: 65000,
  duration_sec: 300,
  target_address: 'TYourAddress...',
})
console.log(order.status)   // "FILLED"
console.log(order.cost_trx) // 1.4311

Python：

from merx import MerxClient

merx = MerxClient(api_key="merx_sk_your_key")

prices = merx.prices.list()
order = merx.orders.create(
    resource_type="ENERGY",
    amount=65000,
    duration_sec=300,
    target_address="TYourAddress..."
)

curl（无需 SDK）：

# Public -- no auth required
curl https://merx.exchange/api/v1/prices

# Authenticated
curl -X POST https://merx.exchange/api/v1/orders \
  -H "Authorization: Bearer merx_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "resource_type": "ENERGY",
    "amount": 65000,
    "duration_sec": 300,
    "target_address": "TYourAddress..."
  }'

路径 3：Claude Code 插件（一行安装）

如果你使用 Claude Code，这是最快的方式。该插件会自动注册托管的 MCP 服务， 提供 6 个斜杠命令，并包含一个 tron-agent-engineer 子 Agent，专门处理 TRON 上的 Agent 式支付工作流。

/plugin marketplace add Hovsteder/merx-claude-plugin
/plugin install merx@merx

然后运行 /merx:setup 配置你的 MERX API 密钥。可用命令：

来源：github.com/Hovsteder/merx-claude-plugin。

路径 4：适用于任何 AI Agent 的 MCP（Claude、Cursor、Windsurf、自定义客户端）

托管版（零安装）——适用于 Claude.ai、Cursor、Windsurf 和任何兼容 SSE 的 MCP 客户端：

{
  "mcpServers": {
    "merx": {
      "url": "https://merx.exchange/mcp/sse"
    }
  }
}

可立即使用 22 个只读工具：价格、估算、市场分析、链上查询、地址查询。无需 API 密钥。

要启用交易工具，请在任意对话中调用 set_api_key：

set_api_key("merx_sk_your_key")
-> All 34 authenticated tools unlocked for this session.

要启用写入工具（发送 TRX、兑换代币），请调用 set_private_key：

set_private_key("your_64_char_hex_key")
-> Address derived automatically. All 66 tools available.
-> Key never leaves your machine.

本地版（stdio）——通过环境变量设置密钥，获得完整功能：

npm install -g merx

{
  "mcpServers": {
    "merx": {
      "command": "npx merx-mcp",
      "env": {
        "MERX_API_KEY": "merx_sk_your_key",
        "TRON_PRIVATE_KEY": "your_private_key"
      }
    }
  }
}

从第一条消息开始即可使用全部 66 个工具。

其他协议支持

MERX 还为非 MCP 编排器提供 A2A 和 ACP——使用相同的后端，但采用不同的发现方式：

• A2A（LangChain、CrewAI、Vertex AI、AutoGen、Mastra）：Agent Card 位于 https://merx.exchange/.well-known/agent.json——7 项技能，SSE 流式传输
• ACP（BeeAI）：Manifest 位于 https://merx.exchange/.well-known/agent-manifest.json——7 项能力，基于运行的执行方式

访问级别

MERX 的独特之处

TRON 上唯一完整的 Agent 技术栈

MERX 是 TRON 上唯一将三种主流 Agent 协议全部作为生产级服务运行的项目：MCP（Anthropic）、A2A（Google，7 项技能）和 ACP（BeeAI，7 项能力）。TronLink 发布了一个核心 MCP 库（@tronlink/tronlink-mcp-core v0.1.0，2026 年 3 月），但它明确只是一个构建模块，而非托管服务。MERX 是 coinbase/x402 生态系统合作伙伴注册表中唯一的 TRON 项目。

收款时间不到 3 秒的 Agent 支付服务

agent.merx.exchange 采用非托管模式：Agent 注册自己的 TRON 地址，MERX 绝不持有私钥或控制资金。ZMQ 事件监听器会实时匹配收到的 TRC-20 转账（USDT、USDC、USDD，以及任何其他代币），并在链上确认后约 3 秒内分发 Webhook。watch() 可提供持续 24/7 的地址监控，并支持按代币筛选。invoice() 可创建包含支付链接的付款请求，并自动检测付款。batch() 可通过一次调用发送最多 50 笔转账。

x402 v2 facilitator，全面支持 TRON 稳定币

x402.merx.exchange 实现了标准的 /verify、/settle 和 /supported 端点，因此任何 x402 客户端（包括 Coinbase CDP 参考实现）都能开箱即用地互操作。三种结算方案已在 TRON 主网上线：exact（直接 TRC-20 转账）、 exact_permit 和 exact_gasfree（通过 MERX 自有的 GasFreeController 合约执行 TIP-712 PermitTransfer）。USDT、USDC 和 USDD 均已在主网上完成结算，并经过 txid 验证且在链上收取了佣金。在 15 个已知的 x402 facilitator 中，MERX 是唯一一家支持完整 TRON 稳定币集的服务。

GasFree 零 TRX 转账

MERX 部署的 GasFreeController 合约 TKjJ1r5XYqnLZmLakcP3knis7Lh6gm3qtR 于 2026-04-08 在主网上线，并完成了三笔经过验证的主网 permitTransfer 结算（USDT、USDC、USDD）。Agent 可以从持有零 TRX 的钱包发送稳定币——控制器从每个用户的 GasFree 子账户中提取金额和手续费，执行器则支付广播 Gas。在 TRON 上为 Agent 带来最大阻碍的用户体验问题，就此解决。

资源感知型交易

每项写入操作（TRC-20 转账、代币兑换、合约调用）都会自动 估算所需的能量和带宽，从 6 家提供商中以最佳市场价格购买缺额， 等待委托到账后再执行。Agent 不会无谓消耗 TRX。主网测试 结果显示：与消耗 TRX 相比，使用自动资源的 USDT 转账最多可节省 94% 的费用。

精确能量模拟

在为代币兑换和合约调用购买能量之前，MERX 会使用真实参数通过 triggerConstantContract 模拟确切的交易。不使用硬编码估算值——购买的能量数量精确无误。对于 SunSwap V2 兑换， 模拟返回了 223,354 能量；链上交易实际使用的能量也正好是 223,354。

自然语言策略引擎

“在我的钱包中保留 500,000 能量。价格低于 55 SUN 时买入。 每周最多花费 200 TRX。”

策略引擎（由 Anthropic Claude Sonnet 4 提供支持）会解析此 指令，生成包含触发条件、预算上限和有效期的结构化常设订单，向用户预览订单，并在一次确认后创建所有订单。可通过 MCP、A2A 技能和 REST 端点使用。 没有自己的 Anthropic 集成、常设订单基础设施和实时提供商价格数据源，其他竞争者都无法复制此功能。

多提供商能量路由（位于 Agent 接入界面下层）

所有 6 家活跃的能量提供商均已整合（CatFee、Netts、TronSave、iTRX、 PowerSun、TEM）。订单会自动路由至价格最低的来源。如果某家提供商 发生故障或容量耗尽，下一家价格最低的提供商就会完成订单。 价格涵盖所有可用时长档位的能量和带宽。

常设订单与委托监控

存储在 PostgreSQL 中的服务端全天候自动化。触发类型：price_below、 price_above、schedule（cron）、balance_below、delegation_expiry。 重启后仍会保留。客户端离线时也能运行。支持自动续期，并可配置最高价格。

完整 MCP 协议

唯一使用全部三种 MCP 原语的 TRON MCP 服务：工具（66）、提示词 （30）和资源（21——14 个静态资源 + 7 个模板）。支持两种传输模式： 托管 SSE（无需安装）和本地 stdio（完整密钥管理）。支持三个协议版本：2024-11-05、2025-03-26、2025-06-18。

架构

平台概览

graph TB
    User[User / Application / AI Agent]
    Platform[MERX Platform<br>merx.exchange]
    PM[Price Monitor<br>polls every 30s]
    OE[Order Executor<br>routes to cheapest]
    DV[Delegation Verifier<br>confirms on-chain]
    TR[Treasury<br>balance management]
    RPC[TronGrid / GetBlock<br>TRON RPC]
    Providers[Energy Providers<br>all connected]
    TRON[TRON Blockchain]

    User -->|Web / API / SDK / MCP| Platform
    Platform --> PM
    Platform --> OE
    Platform --> DV
    Platform --> TR
    PM -->|Price polling| Providers
    OE -->|Order routing<br>cheapest first| Providers
    DV -->|Verify delegations| RPC
    RPC --> TRON
    Providers -->|Delegate energy<br>+ bandwidth| TRON

    style User fill:#1a1a2e,stroke:#B8963E,color:#F5F0E8
    style Platform fill:#0C0B09,stroke:#B8963E,color:#F5F0E8
    style TRON fill:#141310,stroke:#B8963E,color:#F5F0E8

User / Application / AI Agent
    |
    | Web / REST API / SDK / MCP
    v
+----------------------------------+
|         MERX Platform            |
|         merx.exchange            |
|                                  |
|  +------------+ +-------------+  |
|  |   Price    | |   Order     |  |
|  |  Monitor   | |  Executor   |  |
|  | (every 30s)| | (cheapest)  |  |
|  +------------+ +-------------+  |
|  +------------+ +-------------+  |
|  | Delegation | |  Treasury   |  |
|  |  Verifier  | |  Manager    |  |
|  +------------+ +-------------+  |
+----------------------------------+
    |                    |
    v                    v
TronGrid / GetBlock   Energy Providers
(TRON RPC)            (all connected)
    |                    |
    v                    v
+----------------------------------+
|        TRON Blockchain           |
+----------------------------------+

关键架构原则： 所有流量都经过 MERX 平台。用户 无需 TronGrid API 密钥。MERX 在服务端管理所有 RPC 基础设施、缓存和 故障转移。唯一保留在客户端执行的操作是：使用私钥为交易签名。私钥永远不会离开客户端进程。

资源感知型交易流程

此时序图展示了一笔真实的 USDT 转账及自动资源优化。 数据来自生产环境测试。

sequenceDiagram
    participant C as Client
    participant M as MERX
    participant P as Providers
    participant T as TRON

    C->>M: POST /orders or transfer_trc20(USDT, 100, TAddr)
    M->>M: POST /estimate (trc20_transfer)
    Note over M: energy: 7,896 / bandwidth: 345
    M->>M: GET /chain/resources/TSender
    Note over M: energy: 0 / bandwidth: 0 / free BW: 600
    Note over M: Energy deficit: 7,896 (round up to 65,000 min)<br>Bandwidth: 345 < 1,500 min order, skip
    M->>P: Route order: ENERGY, 65,000, 300s
    P-->>M: FILLED at 22 SUN (1.43 TRX)
    Note over M: Poll every 2s until delegation arrives
    M->>T: Verify delegation on sender address
    T-->>M: energy: 65,050 available
    Note over M: Sign TX (client-side if MCP, server-side if API)
    M->>T: Broadcast signed TX
    T-->>M: TX confirmed
    M-->>C: USDT sent. Cost: 1.43 TRX.<br>Burn alternative: 3.66 TRX. Savings: 87.6%

Client                  MERX                    Providers               TRON
  |                       |                       |                      |
  | order / transfer      |                       |                      |
  |---------------------->|                       |                      |
  |                       | estimate energy+BW    |                      |
  |                       | energy: 7,896         |                      |
  |                       | bandwidth: 345        |                      |
  |                       |                       |                      |
  |                       | check sender resources|                      |
  |                       | energy: 0, BW: 0      |                      |
  |                       |                       |                      |
  |                       | [deficit: 7,896 -> round up to 65,000]      |
  |                       | [BW: 345 < 1,500 min -> skip, burn ~0.3 TRX]|
  |                       |                       |                      |
  |                       | route to cheapest     |                      |
  |                       |---------------------->|                      |
  |                       |   FILLED 22 SUN       |                      |
  |                       |   1.43 TRX            |                      |
  |                       |<----------------------|                      |
  |                       |                       |                      |
  |                       | [poll until delegation arrives]              |
  |                       |                       |                      |
  |                       | verify delegation     |--------------------->|
  |                       |   energy: 65,050      |<---------------------|
  |                       |                       |                      |
  |                       | [sign + broadcast]    |                      |
  |                       |---------------------->|--------------------->|
  |                       |                       |   TX confirmed       |
  |                       |<----------------------|<---------------------|
  |                       |                       |                      |
  |   USDT sent           |                       |                      |
  |   Cost: 1.43 TRX      |                       |                      |
  |   Burn alt: 3.66 TRX  |                       |                      |
  |   Savings: 87.6%      |                       |                      |
  |<----------------------|                       |                      |

资源购买规则

API 概览

基础 URL：https://merx.exchange/api/v1

所有端点均带版本号。错误遵循标准格式： { "error": { "code": "...", "message": "...", "details": { ... } } }。 POST /orders 和 POST /withdraw 支持 Idempotency-Key 标头。

公共端点（无需身份验证）

需要身份验证的端点（需要 API 密钥）

x402 端点（无需注册）

完整 API 参考：merx.exchange/docs/api

MCP 服务

MERX 为 AI Agent 提供完整的 MCP（Model Context Protocol）服务。包含 18 个类别的 66 个工具、30 个预置提示词，以及 21 个实时数据资源。

**注意：**下方的工具目录表最后一次全面审核时包含 52 个工具。 后续新增的 12 个工具（Agent 付款服务、兑换模块、高级定期订单）记录在 merx.exchange/docs/tools/mcp-server。 规范数量为 64，由实时 MCP 服务提供。

工具类别

提示词（30）

预置对话模板，可在 Claude Desktop 的提示词选择器中使用，也可通过任意 MCP 客户端中的 prompts/get 获取。

资源（21）

14 个静态资源 + 7 个 URI 模板。可将其作为上下文附加到对话中，或订阅以获取实时更新。

URI 模板：

对话示例

查询价格并购买能源：

User: What is the cheapest energy right now?
Agent: [calls get_prices] Cheapest energy is 22 SUN from Netts (5-minute
       delegation). For 65,000 energy, that is 1.43 TRX.
User: Buy it for TLyqz...
Agent: [calls create_order] Done. 65,050 energy delegated via Netts.
       Cost: 1.43 TRX. TX: 27ab0019... (verified on-chain).

考虑资源用量的 USDT 转账：

User: Send 100 USDT to TAddr.
Agent: [calls transfer_trc20] MERX estimated 7,896 energy needed,
       bought 65,000 at 22 SUN, waited for delegation, signed and
       broadcast. USDT sent. Cost: 1.43 TRX instead of 3.66 TRX.
       Savings: 87.6%.

市场分析：

User: Is now a good time to buy energy?
Agent: [calls analyze_prices] Energy is at 22 SUN -- the 1st percentile
       of the last 7 days. 64% below the weekly average of 62 SUN.
       Trend: falling. Recommendation: good time to buy.

完整工具参考

全部 66 个工具及其身份验证要求。输入架构和输出示例请参阅 docs/TOOLS.md。

价格洞察

资源估算

资源交易

账户管理

Agent 便捷工具

链上查询

代币操作

智能合约

网络实用工具

DEX 兑换

入门

支付

意图执行

定期订单和监控器

会话管理

SDK

JavaScript / TypeScript

npm install merx-sdk

import { MerxClient } from 'merx-sdk'

const merx = new MerxClient({ apiKey: 'merx_sk_your_key' })

// 4 modules: prices, orders, balance, webhooks
const prices   = await merx.prices.list()
const best     = await merx.prices.best({ resource: 'ENERGY' })
const order    = await merx.orders.create({ ... })
const status   = await merx.orders.get(order.id)
const balance  = await merx.balance.get()
const webhooks = await merx.webhooks.list()

Python

pip install merx-sdk

from merx import MerxClient

merx = MerxClient(api_key="merx_sk_your_key")

# Same 4 modules, snake_case
prices  = merx.prices.list()
best    = merx.prices.best(resource="ENERGY")
order   = merx.orders.create(resource_type="ENERGY", amount=65000, ...)
status  = merx.orders.get(order.id)
balance = merx.balance.get()

REST API

无需 SDK。所有端点都接受 JSON 并返回 JSON。

# Get prices (public, no auth)
curl https://merx.exchange/api/v1/prices

# Get best price for energy
curl https://merx.exchange/api/v1/prices/best?resource=ENERGY

# Create order (authenticated)
curl -X POST https://merx.exchange/api/v1/orders \
  -H "Authorization: Bearer merx_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"resource_type":"ENERGY","amount":65000,"duration_sec":300,"target_address":"TAddr..."}'

# Check balance
curl https://merx.exchange/api/v1/balance \
  -H "Authorization: Bearer merx_sk_your_key"

实时数据

WebSocket

连接到 wss://merx.exchange/ws，获取实时价格更新。

const ws = new WebSocket('wss://merx.exchange/ws')

ws.onopen = () => {
  // Subscribe to all energy price updates
  ws.send(JSON.stringify({ type: 'subscribe', channel: 'prices', resource: 'ENERGY' }))
}

ws.onmessage = (event) => {
  const data = JSON.parse(event.data)
  // { provider: "netts", resource: "ENERGY", price_sun: 22, available: 100000000, ... }
}

Webhook

注册 Webhook 端点，以接收账户事件的 HTTP POST 通知。

curl -X POST https://merx.exchange/api/v1/webhooks \
  -H "Authorization: Bearer merx_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://your-app.com/webhook","events":["order.filled","deposit.received"]}'

**安全性：**每个 Webhook 请求都包含 X-Merx-Signature 标头，其中包含使用你的 Webhook 密钥计算的 HMAC-SHA256 签名。处理请求前，请验证此签名。发送失败时会采用指数退避策略重试。

支付方式

MERX 支持三种支付能量和带宽的方式。

1. 预充值 MERX 余额

通过 merx.exchange 上的控制面板或 API，将 TRX 存入你的 MERX 账户。直接使用余额进行交易。最适合大批量用户和团队。

# Check balance
curl https://merx.exchange/api/v1/balance \
  -H "Authorization: Bearer merx_sk_your_key"

# Response
# { "available_trx": 45.20, "locked_trx": 1.43, "total_trx": 46.63 }

2. 从 Agent 钱包自行存款

Agent 使用 deposit_trx 工具或 API，从自己的钱包向 MERX 存入 TRX。该工具会生成带有正确备注的 TRX 转账，在本地签名并广播。余额会在 1-2 分钟内入账。

deposit_trx(amount: 10)
-> TX: 4bc60854f828...8ddcd509
-> 10 TRX deposited. Will be credited to your MERX balance shortly.

3. x402 按次付费

无需账户，也无需预存款。创建发票，使用任意钱包支付 TRX，即可直接获得能量委托。通过一次 API 调用，或通过 create_paid_order 工具调用，即可完成整个流程。

create_paid_order(amount: 65000, duration_sec: 300,
  resource_type: "ENERGY", target_address: "THT49...")
-> Invoice: inv_f41ffc2f...
-> Payment TX: 53236a5a...
-> Cost: 1.43 TRX
-> Status: PENDING -> FILLED
-> 65,050 energy delegated to THT49...

详细流程图请参阅 docs/PAYMENT-METHODS.md。

定期订单与监控

定期订单

存储在 PostgreSQL 中的服务器端 24/7 自动化功能。服务重启后仍会保留。客户端离线时也能运行。

触发类型：

操作类型：

示例：

create_standing_order(
  trigger: { type: "price_below", resource: "ENERGY", threshold_sun: 20 },
  action: { type: "buy_resource", amount: 65000, duration_sec: 300 },
  target_address: "TLyqz...",
  max_executions: 10,
  budget_trx: 15
)

-> Standing Order: so_a1b2c3d4
-> Status: ACTIVE
-> Trigger: ENERGY price < 20 SUN
-> Action: Buy 65,000 energy (5m)
-> Budget: 15 TRX (10 executions max)

委托监控器

监控任意地址上的委托和资源。在到期前发出提醒。支持自动续期，并可配置最高价格。

示例：

create_monitor(
  type: "delegation_expiry",
  address: "TLyqz...",
  resource: "ENERGY",
  alert_before_sec: 300,
  auto_renew: true,
  max_price_sun: 30
)

-> Monitor: mon_e5f6g7h8
-> Status: ACTIVE
-> Type: delegation_expiry
-> Alert: 5 minutes before expiry
-> Auto-renew: Yes (max 30 SUN)

节省成本计算器

能量是 TRON 上成本较高的资源。以下数据展示了消耗 TRX（没有能量）和通过 MERX 租用能量的成本差异。

成本对比

以上数据假设下单时选择可用的最低价服务提供商。实际消耗成本会因接收方地址状态而异（即该地址之前是否持有过该代币）。

工作原理

1 TRX = 1,000,000 SUN。能量以每单位 SUN 计价。一次 USDT 转账约需 65,000 个能量单位。按每单位 22 SUN 计算，费用为 65,000 x 22 = 1,430,000 SUN = 1.43 TRX。若没有能量，网络会根据接收方账户状态，从发送方扣除 3-13 TRX。

错误处理

API、SDK 和 MCP 中的所有错误都遵循标准格式：

{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "MERX balance too low. Need 1.43 TRX, have 0.50 TRX.",
    "details": {
      "required_trx": 1.43,
      "available_trx": 0.50
    }
  }
}

常见错误代码

安全

私钥处理

• 通过环境变量（TRON_PRIVATE_KEY）或会话中的 set_private_key 工具设置私钥。
• 密钥不会离开客户端进程。所有交易均在本地签名。
• MERX API 不会接收私钥。
• set_private_key 工具会自动推导 TRON 地址——用户只需提供 64 个字符的十六进制密钥。

API 密钥处理

• API 密钥用于向 MERX API 验证身份，以进行交易操作。
• 可通过环境变量（MERX_API_KEY）或会话中的 set_api_key 工具设置密钥。
• 使用 create_account 工具即可在对话中创建账户并获取 API 密钥，无需离开对话。

MERX 能做什么，不能做什么

在主网上测试

每项能力都已在 TRON 主网上经过生产环境测试。这些都不是模拟测试—— 每个 TX 哈希都可在 TronScan 上验证。

已验证的交易

主网测试的主要发现

与替代方案的比较

基于公开可用信息进行的客观比较。

MERX 涵盖资源经济、交易优化和通用区块链操作。其他服务则专注于单一领域。

Documentation

License

MIT. See LICENSE.