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

# Get finalized market order

> Look up one order by market address and order ID.

<ParamField path="marketAddress" type="string" required>
  Market contract address. Order IDs are unique within a market, not globally.
</ParamField>

<ParamField query="oid" type="string" required>
  Unsigned decimal uint64 order ID. Leading zeros are normalized.
  Missing, empty, malformed or repeated values return 400.
</ParamField>

Returns one finalized order in `data`, whether open, filled or cancelled.
An unknown market/order pair returns 404. This is not an open-order snapshot
or a WebSocket replay baseline; `feedEpoch` is null.

| Field in `data` | Meaning |
| - | - |
| `orderId` | Decimal order ID string |
| `marketAddress` | Market contract address |
| `makerId` | Decimal owner user ID string |
| `symbol` | Market symbol |
| `isBuy` | Whether the order is a bid |
| `isCancelled` | Whether it was cancelled |
| `clientOrderId` | Creation correlation ID, or null; not unique |
| `price` | Integer string in market price precision |
| `remainingSize` | Integer string in market size precision |
| `minSizeAfterBlock` | Reduce-after-block height string, or null |

A cancelled order can retain positive `remainingSize`. A fully filled order
can have `isCancelled: false`.


## OpenAPI

````yaml api/data-source/openapi.yaml GET /api/v1/markets/{marketAddress}/orders
openapi: 3.1.0
info:
  title: Kuru Data Source API
  version: 1.0.0
servers:
  - url: https://api.mainnet.kuru.io
    description: Monad mainnet (default)
  - url: https://api.testnet.kuru.io
    description: Monad testnet
security: []
paths:
  /api/v1/markets/{marketAddress}/orders:
    get:
      summary: Get a finalized order by market and order ID
      operationId: getMarketOrder
      parameters:
        - name: marketAddress
          in: path
          required: true
          schema:
            type: string
        - name: oid
          in: query
          required: true
          description: >-
            Unsigned decimal uint64 order ID. Includes open, filled and
            cancelled orders. Leading zeros are normalized.
          schema:
            type: string
            pattern: ^[0-9]+$
      responses:
        '200':
          description: Single order in data, including makerId; feedEpoch is null.
        '400':
          description: Missing, repeated or invalid query parameter or market address
        '404':
          description: No order with this market and order ID

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.