Skip to main content
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": "1000006",
  "buy_token_id": "1000001",
  "offset": 0,
  "limit": 20,
  "visible": true
}'
{
  "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 — TRC10 token ID being sold, as a numeric string (for example, “1000006”).
  • buy_token_id — TRC10 token ID being purchased, as a numeric string.
  • offset — (optional) starting position for pagination (default: 0)
  • limit — (optional) maximum number of orders to return (default: 20, max: 100)
  • visible — (optional) when true, some nodes accept the request more reliably.

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.

curl example

Shell
curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getmarketorderlistbypair' \
  --header 'Content-Type: application/json' \
  --data '{
    "sell_token_id": "1000006",
    "buy_token_id": "1000001",
    "offset": 0,
    "limit": 20,
    "visible": true
  }'

Body

application/json
sell_token_id
string
required

TRC10 token ID being sold, as a numeric string (for example, '1000006').

buy_token_id
string
required

TRC10 token ID being purchased, as a numeric string.

offset
number

Starting position for pagination (default: 0)

limit
number

Maximum number of orders to return (default: 20, max: 100)

visible
boolean
default:true

Optional. Some node builds require visible: true for this endpoint.

Response

200 - application/json

Market orders for trading pair

orders
object[]