MERX Payments API

The Payments API from MERX — 5 operation(s) for payments.

GitHub OpenAPI

Operations 5

POST /x402/tron/invoice TRON TRC20 payment invoice #
POST /x402/tron/watch Watch TRON address for transfers (24h) #
POST /x402/tron/receive TRON incoming TRC20 payment detection #
POST /x402/tron/send TRON TRC20 send with automatic energy #
POST /x402/tron/send/batch TRON batch TRC20 send to multiple addresses #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/merx-exchange:merx-exchange-payments-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

merx-exchange-payments-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: MERX x402 Payments API
  version: 2.0.0
  description: 'TRON payment infrastructure for AI agents. Send and receive USDT, USDC, USDD with automatic energy, monitor wallets with less than 3s detection, access real-time blockchain data. TRON x402 facilitator with full stablecoin coverage and Base USDC bridge. Three settlement schemes: exact, exact_permit, exact_gasfree (TIP-712 permit through MERX GasFreeController). First TRON entry in coinbase/x402 ecosystem registry.'
  x-guidance: Use GET /x402/tron/prices for market data. Use POST /x402/tron/estimate before sending tokens. Use POST /x402/tron/send for TRC20 transfers with automatic energy provisioning. Use POST /x402/tron/watch for persistent address monitoring. All endpoints cost $0.01 per call. Pay with USDC on Base or USDT/USDC/USDD on TRON.
servers:
- url: https://merx.exchange
tags:
- name: Payments
paths:
  /x402/tron/invoice:
    post:
      summary: TRON TRC20 payment invoice
      description: Create a TRC20 payment invoice with payment link and automatic detection.
      tags:
      - Payments
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - amount_usdt
              properties:
                amount_usdt:
                  type: string
                description:
                  type: string
                pay_to_address:
                  type: string
                expires_in_seconds:
                  type: integer
                  default: 3600
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      invoice_id:
                        type: string
                      payment_url:
                        type: string
                      pay_to_address:
                        type: string
                      qr_data:
                        type: string
        '402':
          description: Payment Required
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402: {}
      operationId: postX402TronInvoice
      x-operation-id-source: derived
  /x402/tron/watch:
    post:
      summary: Watch TRON address for transfers (24h)
      description: Create a persistent 24-hour watch on any TRON address. Fires webhook on matching TRC20 transfers. Sub-3-second detection.
      tags:
      - Payments
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - address
              - webhook_url
              properties:
                address:
                  type: string
                event_types:
                  type: array
                  items:
                    type: string
                    enum:
                    - usdt_incoming
                    - usdc_incoming
                    - usdd_incoming
                    - trc20_incoming
                token_contract:
                  type: string
                min_amount:
                  type: string
                webhook_url:
                  type: string
                  format: uri
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      watch_id:
                        type: string
                      expires_at:
                        type: string
                      status:
                        type: string
        '402':
          description: Payment Required
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402: {}
      operationId: postX402TronWatch
      x-operation-id-source: derived
  /x402/tron/receive:
    post:
      summary: TRON incoming TRC20 payment detection
      description: One-time watch for a specific payment amount. Fires webhook when payment detected (<3 seconds).
      tags:
      - Payments
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - expected_amount
              properties:
                expected_amount:
                  type: string
                token_contract:
                  type: string
                tolerance_pct:
                  type: number
                  default: 0
                timeout_seconds:
                  type: integer
                  default: 300
                webhook_url:
                  type: string
                  format: uri
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      payment_id:
                        type: string
                      watch_address:
                        type: string
                      expires_at:
                        type: string
        '402':
          description: Payment Required
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402: {}
      operationId: postX402TronReceive
      x-operation-id-source: derived
  /x402/tron/send:
    post:
      summary: TRON TRC20 send with automatic energy
      description: Send any TRC20 token. MERX estimates energy and bandwidth, purchases deficit from cheapest provider, broadcasts pre-signed TX.
      tags:
      - Payments
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - to
              - amount_usdt
              - signed_tx
              properties:
                to:
                  type: string
                amount_usdt:
                  type: string
                signed_tx:
                  type: string
                memo:
                  type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      txid:
                        type: string
                      status:
                        type: string
                      resources:
                        type: object
        '402':
          description: Payment Required
      x-payment-info:
        price:
          mode: dynamic
          currency: USD
          min: '0.001'
          max: '0.01'
        protocols:
        - x402: {}
      operationId: postX402TronSend
      x-operation-id-source: derived
  /x402/tron/send/batch:
    post:
      summary: TRON batch TRC20 send to multiple addresses
      description: Send to up to 50 TRON addresses in one call.
      tags:
      - Payments
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - transfers
              properties:
                transfers:
                  type: array
                  maxItems: 50
                  items:
                    type: object
                    required:
                    - to
                    - amount
                    - signed_tx
                    properties:
                      to:
                        type: string
                      amount:
                        type: string
                      signed_tx:
                        type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      total:
                        type: integer
                      succeeded:
                        type: integer
                      failed:
                        type: integer
                      results:
                        type: array
        '402':
          description: Payment Required
      x-payment-info:
        price:
          mode: dynamic
          currency: USD
          min: '0.001'
          max: '0.01'
        protocols:
        - x402: {}
      operationId: postX402TronSendBatch
      x-operation-id-source: derived