> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# wallet/getmarketorderlistbypair | TRON

> TRON API method that retrieves all active market orders for a specific trading pair on the TRON DEX. Use it on TRON via Chainstack.

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.

## 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 Shell theme={"system"}
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
  }'
```


## OpenAPI

````yaml openapi/tron_node_api/getmarketorderlistbypair.json post /95e61622bf6a8af293978377718e3b77/wallet/getmarketorderlistbypair
openapi: 3.0.0
info:
  title: wallet/getmarketorderlistbypair TRON API
  version: 1.0.0
  description: List market orders by trading pair
servers:
  - url: https://tron-mainnet.core.chainstack.com
security: []
paths:
  /95e61622bf6a8af293978377718e3b77/wallet/getmarketorderlistbypair:
    post:
      tags:
        - Market and DEX
      summary: wallet/getmarketorderlistbypair
      operationId: getMarketOrderListByPair
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                sell_token_id:
                  type: string
                  description: >-
                    TRC10 token ID being sold, as a numeric string (for example,
                    '1000006').
                buy_token_id:
                  type: string
                  description: TRC10 token ID being purchased, as a numeric string.
                offset:
                  type: number
                  description: 'Starting position for pagination (default: 0)'
                limit:
                  type: number
                  description: 'Maximum number of orders to return (default: 20, max: 100)'
                visible:
                  type: boolean
                  description: >-
                    Optional. Some node builds require `visible: true` for this
                    endpoint.
                  default: true
              required:
                - sell_token_id
                - buy_token_id
              example:
                sell_token_id: '1000006'
                buy_token_id: '1000001'
                offset: 0
                limit: 20
                visible: true
      responses:
        '200':
          description: Market orders for trading pair
          content:
            application/json:
              schema:
                type: object
                properties:
                  orders:
                    type: array
                    items:
                      type: object
                      properties:
                        order_id:
                          type: string
                          description: Unique identifier for the market order
                        owner_address:
                          type: string
                          description: Order creator address
                        create_time:
                          type: number
                          description: Order creation timestamp
                        sell_token_id:
                          type: string
                          description: Token ID being sold
                        sell_token_quantity:
                          type: string
                          description: Quantity of tokens being sold
                        buy_token_id:
                          type: string
                          description: Token ID being purchased
                        buy_token_quantity:
                          type: string
                          description: Quantity of tokens being purchased
                        sell_token_quantity_remain:
                          type: string
                          description: Remaining quantity for sale
                        buy_token_quantity_remain:
                          type: string
                          description: Remaining quantity to purchase
                        state:
                          type: string
                          description: Order status

````