API REST de MERX: 46 endpoints para comercio de energia en TRON

The MERX REST API provides 46 endpoints that cover the complete lifecycle of TRON energy and bandwidth trading - from tiempo real descubrimiento de precios across eight providers to ejecucion de ordenes, account management, en cadena queries, and automated orden permanentes. This article walks through the API architecture, authentication model, endpoint groups, limite de velocidads, manejo de errores, and practical code examples in curl, JavaScript, and Python.

Why a Unified API Matters

The TRON mercado de energia is fragmented across multiple providers, each with its own API format, authentication scheme, and pricing model. A developer who wants el mejor precio on a USDT transfer has to integrate with every provider individually, handle respaldo logic, and monitor prices continuously.

MERX consolidates all of that into a single REST API. One clave de API, one authentication header, one formato de error, one set of SDKs. The platform polls all connected providers every 30 seconds, routes orders to the cheapest available source, and verifies delegations en cadena.

The API is versioned at /api/v1/ and will maintain retrocompatibilidad. All endpoints return JSON in a consistent envelope format.

Authentication

MERX uses clave de API authentication. Every authenticated request must include the X-API-Key header.

clave de APIs are created in the MERX dashboard at merx.exchange or programmatically via the /api/v1/keys endpoint. Each key has a permission set that controls what operations it can perform.

curl -H "X-API-Key: sk_live_your_key_here" \
  https://merx.exchange/api/v1/balance

Keys follow the format sk_live_ followed by 64 hex characters. The raw key is shown exactly once at creation time. MERX stores only the bcrypt hash, so lost keys cannot be recovered - they must be revoked and replaced.

Key Permissions

When creating an clave de API, you assign one or more permissions:

This allows you to create read-only keys for monitoring dashboards and restricted keys for automated trading systems.

Response Envelope

Every response follows the same structure:

{
  "data": { ... }
}

On error:

{
  "error": {
    "code": "INSUFFICIENT_FUNDS",
    "message": "Account balance too low for the requested operation",
    "details": { "required": 150000000, "available": 42000000 }
  }
}

Error codes are machine-readable strings. The details field is optional and provides context for debugging.

Endpoint Groups

The 46 endpoints are organized into nine groups. Aqui esta the complete map.

Prices (6 endpoints)

These endpoints are public - no clave de API required.

Orders (3 endpoints)

Account (7 endpoints)

API Keys (3 endpoints)

Authentication (2 endpoints)

Estimation (2 endpoints)

Webhooks (3 endpoints)

Standing Orders and Monitors (7 endpoints)

Chain Proxy (10 endpoints)

These endpoints proxy TRON network queries through MERX, eliminating the need for clients to call TronGrid directly.

x402 Pay-Per-Use (3 endpoints)

Key Endpoints in Detail

GET /api/v1/prices

Returns current pricing from all active providers. No authentication required. This is the endpoint you call to see the full market at a glance.

curl https://merx.exchange/api/v1/prices

Response (abbreviated):

{
  "data": [
    {
      "provider": "sohu",
      "is_market": false,
      "energy_prices": [
        { "duration_sec": 3600, "price_sun": 24 },
        { "duration_sec": 86400, "price_sun": 30 }
      ],
      "bandwidth_prices": [],
      "available_energy": 5000000,
      "available_bandwidth": 0,
      "fetched_at": 1743292800
    }
  ]
}

Each provider entry includes the price tiers (by duration), available capacity, and the timestamp of the last successful poll.

POST /api/v1/orders

Creates an energy or bandwidth order. The platform matches the order against available providers and routes to the cheapest one that can fulfill it.

curl -X POST https://merx.exchange/api/v1/orders \
  -H "X-API-Key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-request-id-123" \
  -d '{
    "resource_type": "ENERGY",
    "order_type": "MARKET",
    "amount": 65000,
    "target_address": "TJYpFDq5cVnRJey8Xt8HfaRtNkqFTZwBb",
    "duration_sec": 3600
  }'

Response:

{
  "data": {
    "id": "ord_a1b2c3d4",
    "status": "PENDING",
    "created_at": "2026-03-30T12:00:00.000Z"
  }
}

The Idempotency-Key header prevents duplicate orders if the same request is retried. If the key has been seen before, the API returns the original order instead of creating a new one.

Order types:

• MARKET - execute immediately at best available price
• LIMIT - execute only if price is at or below max_price_sun
• PERIODIC - recurring order on a schedule
• BROADCAST - broadcast a pre-signed delegation transaction

GET /api/v1/orders/:id

Returns the order with its fill details - which providers fulfilled the order, at what price, and the en cadena transaction IDs.

curl -H "X-API-Key: sk_live_your_key_here" \
  https://merx.exchange/api/v1/orders/ord_a1b2c3d4

{
  "data": {
    "id": "ord_a1b2c3d4",
    "resource_type": "ENERGY",
    "order_type": "MARKET",
    "status": "FILLED",
    "amount": 65000,
    "target_address": "TJYpFDq5cVnRJey8Xt8HfaRtNkqFTZwBb",
    "duration_sec": 3600,
    "total_cost_sun": 1560000,
    "fills": [
      {
        "provider": "sohu",
        "amount": 65000,
        "price_sun": 24,
        "cost_sun": 1560000,
        "delegation_tx": "abc123def456...",
        "verified": true,
        "tronscan_url": "https://tronscan.org/#/transaction/abc123def456..."
      }
    ]
  }
}

POST /api/v1/estimate

Estimates the energy and bandwidth required for a TRON operation, then compares the rental cost against the TRX costo de quema.

curl -X POST https://merx.exchange/api/v1/estimate \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "trc20_transfer",
    "to_address": "TJYpFDq5cVnRJey8Xt8HfaRtNkqFTZwBb",
    "amount": "1000000"
  }'

{
  "data": {
    "energy_required": 65000,
    "bandwidth_required": 345,
    "rental_cost": {
      "energy": {
        "best_price_sun": 24,
        "best_provider": "sohu",
        "cost_trx": "1.560"
      }
    },
    "total_rental_trx": "1.905",
    "total_burn_trx": "27.645",
    "savings_percent": 93.1
  }
}

This endpoint is useful for showing users exactly how much they save by renting energy through MERX versus burning TRX.

Rate Limits

Rate limits are applied per IP address using sliding windows.

When a limite de velocidad is exceeded, the API returns HTTP 429 with the standard formato de error:

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded"
  }
}

Rate limit headers (RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset) are included in all responses following the IETF draft standard.

Error Codes

Quick Start with SDKs

While the REST API can be called directly with any HTTP client, MERX provides official SDKs for JavaScript and Python that handle authentication, error parsing, and type safety.

JavaScript / TypeScript

npm install merx-sdk

import { MerxClient } from 'merx-sdk'

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

// Get all prices
const prices = await merx.prices.list()

// Create an order
const order = await merx.orders.create({
  resource_type: 'ENERGY',
  amount: 65000,
  target_address: 'TJYpFDq5cVnRJey8Xt8HfaRtNkqFTZwBb',
  duration_sec: 3600,
})

// Check order status
const details = await merx.orders.get(order.id)

Python

pip install merx-sdk

from merx import MerxClient

client = MerxClient(api_key="sk_live_your_key_here")

# Get all prices
prices = client.prices.list()

# Create an order
order = client.orders.create(
    resource_type="ENERGY",
    amount=65000,
    target_address="TJYpFDq5cVnRJey8Xt8HfaRtNkqFTZwBb",
    duration_sec=3600,
)

# Check order status
details = client.orders.get(order.id)

WebSocket for Real-Time Data

Ademas to the REST API, MERX provides a WebSocket endpoint at wss://merx.exchange/ws for tiempo real actualizacion de precioss. Price changes are pushed to connected clients as they happen, with updates arriving every 30 seconds per provider.

The WebSocket connection supports provider filtering - subscribe only to the providers you care about, and ignore the rest.

Standing Orders

Standing orders automate energy purchases based on triggers. You can set a price threshold, a schedule, or a balance condition, and the platform executes orders automatically within your specified budget.

Trigger types include price_below, price_above, schedule, balance_below, and provider_available. Action types include buy_resource, ensure_resources, deposit_trx, and notify_only.

This makes MERX suitable for fully automated infrastructure management - set your rules once, and the platform handles execution.

What Comes Next

The MERX API is designed for developers and businesses that need reliable, cost-effective access to TRON network resources. Whether you are building a procesador de pagos, a DeFi application, or an exchange, the API provides the building blocks to manage energy and bandwidth programmatically.

Full API documentation is available at merx.exchange/docs. The JavaScript SDK is on GitHub and npm. The Python SDK is on PyPI.

Enlaces:

• Plataforma: merx.exchange
• Documentacion: merx.exchange/docs
• SDK de JavaScript: github.com/Hovsteder/merx-sdk-js | npm
• SDK de Python: pypi.org/project/merx-sdk
• Servidor MCP: github.com/Hovsteder/merx-mcp | npm