TRC20 Gateway

OpenAPI 3.1 · Machine contract

A proper reading surface for the raw specification.

Use this page to understand the contract, then import the unchanged YAML into your own generator, validator, Postman workspace, or CI pipeline.

EnvironmentTRON Nile
Media typeapplication/json
AuthenticationmTLS + Ed25519

Transport identity

Gateway-issued mTLS certificate

Authenticates the Merchant workload at the dedicated API hostname.

Request identity

Merchant-owned Ed25519 key

Signs exact HTTP request bytes. It cannot control any TRON wallet.

Merchant operations

GET/v1/capabilities

Confirm network, asset, decimals, order TTL, and approval behavior.

POST/v1/orders

Create a deposit order and receive a one-time USDT-TRC20 address.

GET/v1/orders/{order_ref}

Recover the authoritative state of a Merchant deposit order.

POST/v1/withdrawals

Submit an asynchronous withdrawal intent for policy evaluation.

GET/v1/withdrawals/{withdrawal_ref}

Recover status, transition outcome, and transaction ID when available.

POSTMerchant webhook

Verify Gateway-signed deposit, sweep, expiry, and withdrawal event occurrences.

Source contract

Inspect the exact YAML.

Download raw file
Loading OpenAPI contract…