Add close margin position endpoint

margin_app/app/api/margin_position.py

@@ -0,0 +1,36 @@
+from typing import NoReturn
+from uuid import UUID
+
+from fastapi import APIRouter, Depends, HTTPException
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.crud.margin_position import margin_position_crud
+from app.db.sessions import get_db
+from app.schemas.margin_position import CloseMarginPositionResponse
+
+router = APIRouter()
+
+
+@router.post("/close/{position_id}", response_model=CloseMarginPositionResponse)
+async def close_margin_position(position_id: UUID) -> CloseMarginPositionResponse:
+    """
+    Close a margin position endpoint.
+
+    Args:
+        position_id (UUID): The unique identifier of the margin position to close
+
+    Returns:
+        CloseMarginPositionResponse: Object containing the position ID and its updated status
+
+    Raises:
+        HTTPException: 404 error if the position is not found
+    """
+    margin_position_crud.db = db
+    status = await margin_position_crud.close_margin_position(position_id)
+
+    if not status:
+        raise HTTPException(
+            status_code=404, detail=f"Margin position with id {position_id} not found"
+        )
+
+    return CloseMarginPositionResponse(position_id=position_id, status=status)

margin_app/app/main.py

@@ -1,7 +1,20 @@
-"""
-Main entry point for the application.
-"""
-
-from fastapi import FastAPI
-
-app = FastAPI()
+"""
+Main entry point for the application.
+
+This module initializes the FastAPI application and includes all routers.
+"""
+
+from fastapi import FastAPI
+
+from app.api.margin_position import router as margin_position_router
+
+app = FastAPI(
+    title="Margin Trading API",
+    description="API for managing margin trading positions",
+    version="1.0.0",
+)
+
+# Include routers
+app.include_router(
+    margin_position_router, prefix="/api/margin-positions", tags=["margin-positions"]
+)

margin_app/app/schemas/margin_position.py

@@ -0,0 +1,35 @@
+from enum import Enum
+from uuid import UUID
+
+from pydantic import BaseModel
+
+
+class MarginPositionStatus(str, Enum):
+    """
+    Enumeration of possible margin position statuses.
+
+    Attributes:
+        OPEN: Position is currently open
+        CLOSED: Position has been closed
+    """
+
+    OPEN = "Open"
+    CLOSED = "Closed"
+
+
+class CloseMarginPositionResponse(BaseModel):
+    """
+    Response model for closing a margin position.
+
+    Attributes:
+        position_id (UUID): The unique identifier of the margin position
+        status (MarginPositionStatus): The current status of the margin position
+    """
+
+    position_id: UUID
+    status: MarginPositionStatus
+
+    class Config:
+        """Pydantic configuration class"""
+
+        from_attributes = True