MERX - TRON Infrastructure for AI Agents

MERX

https://MERX.exchange

AI エージェント向けの TRON インフラストラクチャ。

MCP ツール 66 個。6 つのプロバイダーにまたがるエネルギー市場。USDT／USDC／USDD による決済。TRON メインネット上の x402 v2 ファシリテーター。

ドキュメント | API リファレンス | MCP サーバー

目次

• MERX とは — AI エージェント向けの TRON インフラストラクチャ
• 課題 — MERX 登場まで TRON にエージェントレイヤーがなかった理由
• プラットフォームの概要 — MCP、エージェント決済サービス、x402、GasFree、エネルギーアグリゲーター
• クイックスタート — 4 つの方法（Web、REST／SDK、Claude Code プラグイン、MCP）
• MERX の特長 — TRON 上で唯一の完全なエージェントスタック
• アーキテクチャ
• API の概要
• MCP サーバー
• SDK
• リアルタイムデータ
• 決済方法
• 定期注文とモニター
• 節約額計算ツール
• エラー処理
• セキュリティ
• メインネットでのテスト
• 代替サービスとの比較
• ドキュメント
• ライセンス

MERX とは

MERX は、TRON 上の AI エージェントとエージェント型ネットワークのためのインフラストラクチャレイヤーです。 Stripe がウェブコマースの、Cloudflare がオープンウェブのインフラストラクチャであるように、 MERX は、自律型 AI エージェントがエネルギーや帯域幅、低レベルのブロックチェーンの仕組みに 一切触れることなく、TRON 上で発見、取引、運用できるようにする、欠けていたインフラストラクチャレイヤーです。

このプラットフォームは、一貫したスタックを提供します。66 ツールの MCP サーバー、TRC-20 ステーブルコイン向けのエージェント決済サービス、x402 v2 ファシリテーター（coinbase/x402 エコシステムのレジストリに登録された唯一の TRON ファシリテーター）、MERX がメインネットにデプロイしたコントローラーを介したGasFree 送金、専用の TRON RPC ノード、A2A（Google、7 スキル）とACP（BeeAI、7 機能）のプロトコル対応、そして Anthropic Claude を利用した自然言語ポリシーエンジンです。

これらのエージェント向け機能の基盤には、稼働中の 6 つのプロバイダー（CatFee、Netts、TronSave、iTRX、PowerSun、TEM）を対象とするエネルギーアグリゲーターがあり、リソース購入を最安の供給元へ自動的に振り分けます。そのため、エージェントがsend()を呼び出すと、MERX は必要なエネルギーを見積もり、不足分だけを購入して、トランザクションをブロードキャストします。エージェントが TRX を保有したり、エネルギーについて考えたりする必要はありません。

Claude、LangChain、CrewAI、Vertex AI、AutoGen、 BeeAI のいずれかで動作するあらゆる AI エージェントは、MERX との単一の連携を通じて、TRON 上で支払いを行い、リソースを取得できます。

エージェントを MERX に接続する方法は 3 つあります。

• MCP サーバー -- AI エージェント向けの 66 個のツールです。ホスト型 SSE は https://merx.exchange/mcp/sse（インストール不要）、ローカル stdio は npx merx-mcp で利用できます。Claude、GPT、Cursor、Windsurf、および MCP 対応のあらゆるクライアントで動作します。

• Claude Code プラグイン -- Claude Code 用のワンラインインストールです。MCP サーバーを自動登録し、 6 つのスラッシュコマンドとtron-agent-engineerサブエージェントが含まれています。 Hovsteder/merx-claude-pluginを参照してください。

• REST API + SDK -- MCP を使用しないエージェント向けの、プログラムによる直接アクセスです。 JavaScript（npm のmerx-sdk v2.1）、Python（PyPI のmerx-sdk v2.1）、 または/api/v1/への生の HTTP（バージョン管理されたエンドポイント 70 以上）を利用できます。

人間のユーザー向けには、merx.exchangeのウェブプラットフォームで、 手動のエネルギー取引、ダッシュボード、入金、出金を引き続き利用できます。ただし、このプラットフォームは主にエージェント向けに構築されています。

課題

AI エージェントは、ステーブルコインを利用する主要な取引主体になっていきます。USDD、860億ドル超の USDT、USDC を擁し、東南アジア、アフリカ、ラテンアメリカで小売向け USDT の主要チェーンである TRON は、すでに世界最大の USDT ネイティブネットワークです。

しかし、TRON にはエージェント向けに設計されたインフラがありません。

• エージェントネイティブな決済サービスがありません。 既存の TRON ウォレットは、マウスクリックやシードフレーズのバックアップを使う人間向けに構築されており、アドレスの登録、TRC-20 の送信、入金の監視、REST による請求書の作成が必要な自律型プログラム向けではありません。

• エネルギーと帯域幅が UX の行き止まりになっています。 TRON 上のスマートコントラクト呼び出しには、すべてエネルギーが必要です。エネルギーがない場合、手数料として TRX トークンが消費されます。コールドレシーバーへの USDT 送金では、1 回あたり 3～13 TRX（約 1～4 ドル）が消費されます。プロバイダーからエネルギーをレンタルすればコストは約 0.10 ドルに下がり、94％削減できますが、プロバイダーごとに価格、API、期間のプラン、障害のパターンが異なります。エージェントにその管理を期待することはできません。

• MERX 以前、TRON には x402 ファシリテーターがありませんでした。 x402 プロトコルは、Base、Solana、Stellar、Ethereum 上で、すでにエージェント間決済として 4,357 万ドルを処理しています。MERX が登場するまで、TRON は coinbase/x402 エコシステムレジストリにまったく登録されていませんでした。TRON 上でホストされている API の料金を USDT で支払いたいエージェントには、標準化された手段がありませんでした。

• 3 つのエージェントプロトコルに、TRON との連携はありません。 MCP（Anthropic）、A2A（Google）、ACP（BeeAI）は、主要な 3 つのエージェント通信プロトコルです。MERX が登場するまで、これらのいずれにも、デプロイ済みの本番品質の TRON サーバーはありませんでした。Claude、Vertex AI、BeeAI の AI エージェントは、文字どおり TRON を認識できませんでした。

MERX は、この不足しているレイヤーを構築します。AI エージェントは 1 つの API を呼び出すだけで、TRX をまったく保有せずに、世界最大の USDT ネットワーク上で USDT、USDC、USDD を受け取り、支払い、送信できます。

プラットフォーム概要

クイックスタート

ユースケースに応じて 4 つの方法があります。**AI エージェントには、方法 3 と 4 が主な利用方法です。**方法 1（ウェブ）は人間のオペレーター向け、方法 2（REST/SDK）はプログラムから直接連携する場合に適しています。

方法 1：ウェブプラットフォーム（人間向け）

merx.exchange にアクセスしてサインインし、TRX を入金します。ダッシュボードからエネルギー、エージェント 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..."
  }'

Path 3：Claude Code プラグイン（1 行でインストール）

Claude Code を使用している場合は、これが最も手軽な方法です。このプラグインはホストされた MCP サーバーを自動登録し、6 つのスラッシュコマンドを提供します。また、TRON のエージェント型決済ワークフローに特化した tron-agent-engineer サブエージェントも含まれています。

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

続いて /merx:setup を実行し、MERX API キーを設定します。利用可能なコマンドは次のとおりです。

ソース：github.com/Hovsteder/merx-claude-plugin。

Path 4：あらゆる AI エージェント向け 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）：マニフェストは https://merx.exchange/.well-known/agent-manifest.json にあります。7 つの機能と実行単位の処理に対応

アクセスレベル

MERX の特長

TRON で唯一の完全なエージェントスタック

MERX は、本番環境対応のサービスとして 3 つの主要なエージェントプロトコルすべて（MCP（Anthropic）、A2A（Google、7 つのスキル）、ACP（BeeAI、7 つの機能））を稼働させている唯一の TRON プロジェクトです。TronLink はコア MCP ライブラリ（@tronlink/tronlink-mcp-core v0.1.0、2026 年 3 月）を公開しましたが、これはホスト型サービスではなく、明確に構成要素として提供されています。MERX は、coinbase/x402 エコシステムパートナーレジストリに掲載されている唯一の TRON プロジェクトです。

3 秒未満で受信できるエージェント決済サービス

agent.merx.exchange は非カストディアルです。エージェントは独自の TRON アドレスを登録し、MERX が秘密鍵を保管したり、資金を管理したりすることはありません。ZMQ イベントリスナーが、TRC-20 送金（USDT、USDC、USDD、およびその他のあらゆるトークン）をリアルタイムで照合し、オンチェーンでの確認後約 3 秒以内に Webhook を送信します。watch() は、トークンごとのフィルタリング機能を備えた、24 時間 365 日の継続的なアドレス監視を提供します。invoice() は、決済リンクと自動検知機能を備えた決済リクエストを作成します。batch() は、1 回の呼び出しで最大 50 件の送金を実行します。

TRON のステーブルコインを完全にサポートする x402 v2 ファシリテーター

x402.merx.exchange は標準の /verify、/settle、/supported エンドポイントを実装しているため、あらゆる x402 クライアント（Coinbase CDP のリファレンス実装を含む）とそのまま連携できます。TRON メインネットでは、3 種類の決済スキームが稼働しています。exact（TRC-20 の直接送金）、exact_permit、exact_gasfree（MERX 独自の GasFreeController コントラクトを通じた TIP-712 PermitTransfer）です。USDT、USDC、USDD はいずれも、検証済みの txid とオンチェーンの手数料徴収を伴ってメインネットで決済されました。既知の x402 ファシリテーター 15 社のうち、TRON のステーブルコインをすべてサポートしているのは MERX だけです。

GasFree による TRX 不要の送金

MERX がデプロイした GasFreeController コントラクト TKjJ1r5XYqnLZmLakcP3knis7Lh6gm3qtR は、検証済みのメインネット permitTransfer 決済 3 件（USDT、USDC、USDD）とともに、2026-04-08 にメインネットで稼働を開始しました。エージェントは TRX をまったく保有していないウォレットからステーブルコインを送金できます。コントローラーがユーザーごとの GasFree サブアカウントから価値と手数料を引き出し、実行者がブロードキャストに必要なガス代を支払います。TRON 上のエージェントにとって最大の UX の障壁を取り除きました。

リソースを考慮したトランザクション

すべての書き込み操作（TRC-20 の送金、トークンのスワップ、コントラクト呼び出し）で、必要なエナジーと帯域幅を自動的に見積もり、6 社のプロバイダーから最良の市場価格で不足分を購入し、委任がオンチェーンに反映されるのを待ってから実行します。エージェントが TRX を不必要に消費することはありません。メインネットでのテストでは、リソースの自動確保により、USDT の送金でバーンと比較して最大 94% 節約できます。

正確なエナジーシミュレーション

スワップやコントラクト呼び出しのエナジーを購入する前に、MERX は実際のパラメーターを使い、triggerConstantContract でトランザクションを正確にシミュレーションします。ハードコードされた見積もりではなく、正確なエナジー量を購入します。SunSwap V2 のスワップでは、シミュレーションで 223,354 エナジーが返され、オンチェーンのトランザクションでもまったく同じ 223,354 が使用されました。

自然言語ポリシーエンジン

「ウォレットに 500,000 エナジーを維持してください。価格が 55 SUN を下回ったら購入してください。 週あたりの上限は 200 TRX です。」

Anthropic Claude Sonnet 4 を活用したポリシーエンジンは、この指示を解析し、トリガー、予算上限、有効期限を含む構造化された定期注文を生成して、ユーザーにプレビューを提示し、1 回の確認で作成します。MCP、A2A スキル、REST エンドポイントから利用できます。独自の Anthropic 連携、定期注文インフラストラクチャ、リアルタイムのプロバイダー価格フィードがなければ、競合他社はこれを再現できません。

マルチプロバイダーのエナジールーティング（エージェント向けインターフェースの背後）

稼働中のエナジープロバイダー 6 社（CatFee、Netts、TronSave、iTRX、PowerSun、TEM）をすべて集約しています。注文は最も安価なソースに自動で振り分けられます。プロバイダーが停止した場合や容量不足になった場合は、次に安価なプロバイダーが注文を処理します。価格には、利用可能なすべての期間区分におけるエナジーと帯域幅の両方が含まれます。

定期注文と委任モニター

PostgreSQL に保存されるサーバー側の 24 時間 365 日の自動化です。トリガーの種類は、price_below、price_above、schedule（cron）、balance_below、delegation_expiry です。再起動後も保持されます。クライアントがオフラインでも動作します。上限価格を設定できる自動更新機能を備えています。

MCP プロトコルの完全サポート

MCP の 3 つのプリミティブすべてを使用する唯一の TRON MCP サーバーです。ツール（66）、プロンプト（30）、リソース（21 — 静的 14 件 + テンプレート 7 件）。2 種類のトランスポートモードに対応しています。ホステッド SSE（インストール不要）とローカル stdio（完全な鍵管理）です。3 つのプロトコルバージョンに対応しています。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エージェント向けに、フル機能のMCP（Model Context Protocol）サーバーを提供しています。18カテゴリにわたる66個のツール、組み込み済みプロンプト30個、ライブデータリソース21個を備えています。

注：以下のツールカタログ表は、52個のツールを対象にした監査が最後に実施されました。 新しいツール12個（エージェント決済サービス、スワップモジュール、高度な定期注文）については、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 を参照してください。

価格インテリジェンス

リソースの見積もり

リソース取引

アカウント管理

エージェント向け便利ツール

オンチェーン照会

トークン操作

スマートコントラクト

ネットワークユーティリティ

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 リクエストには、Webhook シークレットを使用して計算された HMAC-SHA256 署名を含む X-Merx-Signature ヘッダーが含まれます。処理の前にこの署名を検証してください。配信に失敗した場合は、指数バックオフで再試行されます。

支払い方法

MERX は、エネルギーと帯域幅の支払い方法を3種類サポートしています。

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. エージェントのウォレットからの自己入金

エージェントは 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 で支払うと、エネルギーの委任を直接受け取れます。1回の API 呼び出し、または create_paid_order による1回のツール呼び出しで処理が完了します。

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時間365日の自動化機能です。再起動後も保持されます。クライアントがオフラインでも動作します。

トリガーの種類：

アクションの種類：

例：

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 です。エネルギーの価格は1単位あたりの SUN で設定されます。USDT の送金には約65,000エネルギー単位が必要です。1単位あたり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文字の16進数キーのみです。

API キーの取り扱い

• API キーは、取引操作のために MERX API を認証します。
• キーは環境変数（MERX_API_KEY）またはセッション内の set_api_key ツールで設定できます。
• create_account ツールを使用すれば、会話から離れることなくアカウントを作成し、API キーを取得できます。

MERX でできること／できないこと

メインネットでのテスト

すべての機能を TRON メインネット上の本番環境でテストしました。これらはシミュレーションではありません。すべての TX ハッシュは TronScan で検証できます。

検証済みトランザクション

メインネットテストでの主な調査結果

代替手段との比較

一般公開されている情報に基づく事実の比較です。

MERX はリソースの経済性、トランザクションの最適化、一般的なブロックチェーン操作をカバーします。他のサーバーは 1 つの領域に特化しています。

Documentation

License

MIT. See LICENSE.