POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
marketbuyasset
wallet/marketbuyasset
curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/marketbuyasset \
  --header 'Content-Type: application/json' \
  --data '{
  "owner_address": "41b487cdb2d8dc7b2a8e5e7e7b4e3e8b8b8b8b8b",
  "sell_token_id": "",
  "sell_token_quantity": "100000000",
  "buy_token_id": "1002000",
  "buy_token_quantity": "1000000"
}'
{
  "visible": true,
  "txID": "<string>",
  "raw_data": {
    "contract": [
      "<any>"
    ],
    "ref_block_bytes": "<string>",
    "ref_block_hash": "<string>",
    "expiration": 123,
    "timestamp": 123
  },
  "raw_data_hex": "<string>"
}
TRON API method that creates a transaction to place a buy order on the TRON DEX marketplace. This allows users to offer to purchase tokens at a specified price, creating demand in the order book.
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 — hexadecimal address of the account placing the buy order
  • sell_token_id — token ID being offered (use empty string for TRX)
  • sell_token_quantity — quantity of tokens to offer in exchange
  • buy_token_id — token ID desired to purchase (use empty string for TRX)
  • buy_token_quantity — quantity of tokens desired to purchase

Response

  • visible — boolean indicating whether addresses are in visible format
  • txID — unique transaction ID for the buy order transaction
  • raw_data — raw transaction data containing:
    • contract — array with market buy order contract details
    • ref_block_bytes — reference block bytes for transaction validation
    • ref_block_hash — hash of the reference block
    • expiration — transaction expiration timestamp
    • timestamp — transaction creation timestamp
  • raw_data_hex — complete transaction data encoded in hexadecimal format

Use case

The wallet/marketbuyasset method is used for:
  • Creating buy orders to acquire tokens at desired prices.
  • Providing demand liquidity to the TRON DEX marketplace.
  • Implementing automated token acquisition strategies.
  • Building custom trading bots and arbitrage systems.
  • Enabling decentralized token exchange without centralized intermediaries.
The buy order will lock the offered tokens until the order is filled or canceled. The exchange rate is determined by the ratio between sell_token_quantity and buy_token_quantity. Use empty strings for token IDs when referring to TRX in the trading pair.

Body

application/json
owner_address
string
required

Account address placing the buy order

sell_token_id
string
required

Token ID being offered (empty string for TRX)

sell_token_quantity
string
required

Quantity of tokens to offer in exchange

buy_token_id
string
required

Token ID desired to purchase (empty string for TRX)

buy_token_quantity
string
required

Quantity of tokens desired to purchase

Response

200 - application/json

Market buy order transaction

visible
boolean

Whether addresses are in visible format

txID
string

Transaction ID for buy order

raw_data
object
raw_data_hex
string

Raw transaction data in hex format