---
title: "OrdersByOrderer returns orders made by an orderer."
method: GET
path: "/crescent/liquidity/v1beta1/orders/{orderer}"
tags: ["Query"]
---

# OrdersByOrderer returns orders made by an orderer.

`GET /crescent/liquidity/v1beta1/orders/{orderer}`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/docs/crescent/liquidity/v1beta1/orders/:orderer/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `orderer` string, required

## Query parameters

- `pair_id` string, uint64
- `pagination.key` string, byte
- `pagination.offset` string, uint64
- `pagination.limit` string, uint64
- `pagination.count_total` boolean
- `pagination.reverse` boolean

## Response `200`

A successful response.

- object: QueryOrdersResponse is response type for the Query/Orders RPC method.
  - `orders` object[]
    - `type` 'ORDER_TYPE_UNSPECIFIED' | 'ORDER_TYPE_LIMIT' | 'ORDER_TYPE_MARKET' | 'ORDER_TYPE_MM': OrderType enumerates order types. - ORDER_TYPE_UNSPECIFIED: ORDER_TYPE_UNSPECIFIED specifies unknown order type. - ORDER_TYPE_LIMIT: ORDER_TYPE_LIMIT specifies limit order type. - ORDER_TYPE_MARKET: ORDER_TYPE_MARKET specifies market order type. - ORDER_TYPE_MM: ORDER_TYPE_MM specifies MM(market making) order type.
    - `id` string, uint64
    - `pair_id` string, uint64
    - `msg_height` string, int64
    - `orderer` string
    - `direction` 'ORDER_DIRECTION_UNSPECIFIED' | 'ORDER_DIRECTION_BUY' | 'ORDER_DIRECTION_SELL': OrderDirection enumerates order directions. - ORDER_DIRECTION_UNSPECIFIED: ORDER_DIRECTION_UNSPECIFIED specifies unknown order direction - ORDER_DIRECTION_BUY: ORDER_DIRECTION_BUY specifies buy(swap quote coin to base coin) order direction - ORDER_DIRECTION_SELL: ORDER_DIRECTION_SELL specifies sell(swap base coin to quote coin) order direction
    - `offer_coin` object: Coin defines a token with a denomination and an amount. NOTE: The amount field is an Int which implements the custom method signatures required by gogoproto.
      - `denom` string
      - `amount` string
    - `remaining_offer_coin` object: Coin defines a token with a denomination and an amount. NOTE: The amount field is an Int which implements the custom method signatures required by gogoproto.
      - `denom` string
      - `amount` string
    - `received_coin` object: Coin defines a token with a denomination and an amount. NOTE: The amount field is an Int which implements the custom method signatures required by gogoproto.
      - `denom` string
      - `amount` string
    - `price` string
    - `amount` string
    - `open_amount` string
    - `batch_id` string, uint64
    - `expire_at` string, date-time
    - `status` 'ORDER_STATUS_UNSPECIFIED' | 'ORDER_STATUS_NOT_EXECUTED' | 'ORDER_STATUS_NOT_MATCHED' | 'ORDER_STATUS_PARTIALLY_MATCHED' | 'ORDER_STATUS_COMPLETED' | 'ORDER_STATUS_CANCELED' | 'ORDER_STATUS_EXPIRED': OrderStatus enumerates order statuses. - ORDER_STATUS_UNSPECIFIED: ORDER_STATUS_UNSPECIFIED specifies unknown order status - ORDER_STATUS_NOT_EXECUTED: ORDER_STATUS_NOT_EXECUTED indicates the order has not been executed yet - ORDER_STATUS_NOT_MATCHED: ORDER_STATUS_NOT_MATCHED indicates the order has been executed but has no match - ORDER_STATUS_PARTIALLY_MATCHED: ORDER_STATUS_PARTIALLY_MATCHED indicates the order has been partially matched - ORDER_STATUS_COMPLETED: ORDER_STATUS_COMPLETED indicates the order has been fully matched and completed - ORDER_STATUS_CANCELED: ORDER_STATUS_CANCELED indicates the order has been canceled - ORDER_STATUS_EXPIRED: ORDER_STATUS_EXPIRED indicates the order has been expired
  - `pagination` object: PageResponse is to be embedded in gRPC response messages where the corresponding request message has used PageRequest. message SomeResponse { repeated Bar results = 1; PageResponse page = 2; }
    - `next_key` string, byte
    - `total` string, uint64

## Other responses

- `default`: An unexpected error response

## Changes

- **2022-03-17** `050a36bde231`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/changes/crescent/liquidity/v1beta1/orders/:orderer/get.md)

---

[API](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs.md) - [All operations](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/revisions/ddf5133cea9d?raw)