order_get_list
Retrieve a list of orders for your trading account to monitor and manage positions on the Finam platform.
Instructions
Получение списка заявок для аккаунта
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| orders | Yes | Заявки |
Implementation Reference
- src/servers/order.py:11-14 (handler)The core handler function `get_list` for retrieving orders list. Tool name becomes `order_get_list` due to mounting with `prefix='order'`.
@order_mcp.tool(tags={"order"}) async def get_list() -> OrdersResponse: """Получение списка заявок для аккаунта""" return await get_finam_client().get_orders() - src/main.py:15-15 (registration)Registers the order_mcp tools with prefix 'order', transforming `get_list` to `order_get_list`.
finam_mcp.mount(order_mcp, prefix="order") - src/tradeapi/order/models.py:121-124 (schema)Pydantic schema for the tool's response: list of OrderState objects.
class OrdersResponse(BaseModel): """Список торговых заявок""" orders: list[OrderState] = Field(..., description="Заявки") - src/tradeapi/order/orders.py:14-25 (helper)Client-side implementation of fetching orders, called via get_finam_client().get_orders().
async def get_orders(self, account_id: str) -> OrdersResponse: """Получение списка заявок для аккаунта""" response, ok = await self._exec_request( self.RequestMethod.GET, self._url.format(account_id=account_id), ) if not ok: err = ErrorModel(**response) raise FinamTradeApiError(f"code={err.code} | message={err.message} | details={err.details}") return OrdersResponse(**response) - src/servers/utils.py:6-8 (helper)Utility function to retrieve the shared FinamClient instance from MCP context.
def get_finam_client() -> FinamClient: return get_context().get_state("finam_client")