MERX Payments API
The Payments API from MERX — 5 operation(s) for payments.
The Payments API from MERX — 5 operation(s) for payments.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/merx-exchange:merx-exchange-payments-api"
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.
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: 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