> ## 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/getmarketorderbyid | TRON

> TRON API method that retrieves detailed information for a specific market order by its unique order ID. Chainstack TRON reference.

TRON API method that retrieves detailed information for a specific market order by its unique order ID. This provides comprehensive details about order status, quantities, and trading pair information.

## Parameters

* `order_id` — unique identifier of the market order to query (as hexadecimal string)

## Response

* `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 (empty for TRX)
* `sell_token_quantity` — original quantity of tokens being sold
* `buy_token_id` — token ID being purchased (empty for TRX)
* `buy_token_quantity` — original 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 (ACTIVE, INACTIVE, CANCELED, etc.)
* `prev` — previous order ID in the order book (if applicable)
* `next` — next order ID in the order book (if applicable)

## Use case

The `wallet/getmarketorderbyid` method is used for:

* Checking the current status and execution progress of a specific order.
* Monitoring order fulfillment and remaining quantities.
* Building order tracking interfaces for trading applications.
* Verifying order details before attempting modifications or cancellations.
* Investigating order book structure and linked order relationships.

<Note>
  The `prev` and `next` fields help navigate the order book structure, showing how orders are linked in the matching system. Empty token IDs represent TRX in trading pairs. Order states indicate the current execution status and availability for matching.
</Note>


## OpenAPI

````yaml openapi/tron_node_api/getmarketorderbyid.json post /95e61622bf6a8af293978377718e3b77/wallet/getmarketorderbyid
openapi: 3.0.0
info:
  title: wallet/getmarketorderbyid TRON API
  version: 1.0.0
  description: Get market order details by ID
servers:
  - url: https://tron-mainnet.core.chainstack.com
security: []
paths:
  /95e61622bf6a8af293978377718e3b77/wallet/getmarketorderbyid:
    post:
      tags:
        - Market and DEX
      summary: wallet/getmarketorderbyid
      operationId: getMarketOrderById
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                order_id:
                  type: string
                  description: Unique identifier of the market order (hex string)
              required:
                - order_id
              example:
                order_id: '0x1234567890abcdef1234567890abcdef12345678'
      responses:
        '200':
          description: Market order details
          content:
            application/json:
              schema:
                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 (empty for TRX)
                  sell_token_quantity:
                    type: string
                    description: Original quantity of tokens being sold
                  buy_token_id:
                    type: string
                    description: Token ID being purchased (empty for TRX)
                  buy_token_quantity:
                    type: string
                    description: Original 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
                  prev:
                    type: string
                    description: Previous order ID in order book
                  next:
                    type: string
                    description: Next order ID in order book

````