POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
getmarketorderlistbypair
wallet/getmarketorderlistbypair
curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getmarketorderlistbypair \
  --header 'Content-Type: application/json' \
  --data '{
  "sell_token_id": "",
  "buy_token_id": "1002000",
  "offset": 0,
  "limit": 20
}'
{
  "orders": [
    {
      "order_id": "<string>",
      "owner_address": "<string>",
      "create_time": 123,
      "sell_token_id": "<string>",
      "sell_token_quantity": "<string>",
      "buy_token_id": "<string>",
      "buy_token_quantity": "<string>",
      "sell_token_quantity_remain": "<string>",
      "buy_token_quantity_remain": "<string>",
      "state": "<string>"
    }
  ]
}
TRON API method that retrieves all active market orders for a specific trading pair on the TRON DEX. This provides order book information showing current buy and sell orders available for matching.
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

  • sell_token_id — token ID being sold (use empty string for TRX)
  • buy_token_id — token ID being purchased (use empty string for TRX)
  • offset — (optional) starting position for pagination (default: 0)
  • limit — (optional) maximum number of orders to return (default: 20, max: 100)

Response

  • orders — array of market order objects, each containing:
    • order_id — unique identifier for the market order
    • owner_address — hexadecimal address of the order creator
    • create_time — timestamp when the order was created
    • sell_token_id — token ID being sold
    • sell_token_quantity — quantity of tokens being sold
    • buy_token_id — token ID being purchased
    • buy_token_quantity — quantity of tokens being purchased
    • sell_token_quantity_remain — remaining quantity available for sale
    • buy_token_quantity_remain — remaining quantity to be purchased
    • state — current order status (typically ACTIVE for this query)

Use case

The wallet/getmarketorderlistbypair method is used for:
  • Building order book displays for trading interfaces.
  • Analyzing market depth and liquidity for specific trading pairs.
  • Finding matching orders for automated trading strategies.
  • Monitoring market activity and order placement patterns.
  • Implementing market making and arbitrage detection systems.
This method only returns active orders that are available for matching. The order book shows the current state of supply and demand for the specified trading pair. Use empty string for token IDs when referring to TRX in the pair.

Body

application/json

Response

200 - application/json

Market orders for trading pair

The response is of type object.