Skip to main content
POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
exchangecreate
Create a new exchange trading pair
curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/exchangecreate \
  --header 'Content-Type: application/json' \
  --data '{
  "owner_address": "TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH",
  "first_token_id": "1000001",
  "first_token_balance": 1000000000000,
  "second_token_id": "_",
  "second_token_balance": 5000000000,
  "visible": true
}'
{
  "txID": "f7d5c2e8a1b9f3d4c5e6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "owner_address": "TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH",
            "first_token_id": "1000001",
            "first_token_balance": "1000000000000",
            "second_token_id": "_",
            "second_token_balance": "5000000000"
          },
          "type_url": "type.googleapis.com/protocol.ExchangeCreateContract"
        },
        "type": "ExchangeCreateContract"
      }
    ],
    "ref_block_bytes": "ab90",
    "ref_block_hash": "f5d4c3b2a1",
    "expiration": 1672531260000,
    "timestamp": 1672531200000
  },
  "raw_data_hex": "0a02ab901220f5d4c3b2a140e0b8e2f6e30f5a68081112620a32747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e45786368616e6765437265617465436f6e747261637412280a154c7971797a56474c5631737266b7dd4afc8eagg61534522083131306b30303131"
}
TRON API method that creates a new trading pair on the TRON decentralized exchange with initial liquidity provision.
Get you own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

  • owner_address — the address that will own and control the exchange pair (base58 with visible: true, or hex with visible: false).
  • first_token_id — TRC10 token ID of the first token in the trading pair.
  • first_token_balance — initial amount for the first token as an integer (token base units).
  • second_token_id — TRC10 token ID of the second token; use _ to denote TRX.
  • second_token_balance — initial amount for the second token as an integer (if TRX, specify in sun).
  • permission_id — optional permission ID for multi‑signature accounts.

Response

Returns a transaction object containing:
  • txID — unique transaction identifier
  • raw_data — raw transaction data including contract details
  • raw_data_hex — hexadecimal representation of raw transaction data

Use case

The wallet/exchangecreate method is used for:
  • Creating new trading pairs on the TRON decentralized exchange
  • Establishing initial liquidity pools for token pairs
  • Launching new markets for custom tokens
  • Setting up automated market maker (AMM) pools with initial pricing

curl example

Shell
curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/exchangecreate' \
  --header 'Content-Type: application/json' \
  --data '{
  "owner_address": "TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH",
  "first_token_id": "1000001",
  "first_token_balance": 1000000000000,
  "second_token_id": "_",
  "second_token_balance": 5000000000,
  "visible": true
}'
  • balances must be integers (do not quote numbers). When the second token is TRX (denoted by _), provide second_token_balance in sun (1 TRX = 1,000,000 sun).
  • use _ for TRX or a TRC10 token ID string for both sides to create TRC10–TRC10 pairs.
  • the call builds an unsigned transaction; you must sign and broadcast it. On mainnet, additional on‑chain validations apply (token existence, ownership, pair uniqueness, sufficient balances).

Body

application/json
owner_address
string
required

The address that will own and control the exchange pair

first_token_id
string
required

Token ID of the first token in the trading pair

first_token_balance
integer
required

Initial balance to provide for the first token (integer amount in the token's base units)

second_token_id
string
required

Token ID of the second token in the trading pair. Use '_' to denote TRX.

second_token_balance
integer
required

Initial balance to provide for the second token (integer amount; if TRX, specify in sun)

permission_id
integer

Optional permission ID for multi-signature accounts

visible
boolean
default:false

Whether to return human-readable addresses

Response

Successful response with transaction details

txID
string

Unique transaction identifier

raw_data
object

Raw transaction data including contract details

raw_data_hex
string

Hexadecimal representation of raw transaction data