diff --git a/market/v1/msg.proto b/market/v1/msg.proto
index cde663d..929d6c8 100644
--- a/market/v1/msg.proto
+++ b/market/v1/msg.proto
@@ -32,7 +32,7 @@ message MarketOrder {
 
 message MarketAssetListReq{
   base.v1.BaseQueryParam base = 1;
-  optional auth.v1.InternalIAM iam = 2;
+  optional auth.v1.InternalIAM iam = 2; // If not set, will returns only public orders which are limited by a white list
 }
 message MarketAssetList{
   repeated wallet.v1.Asset list = 1;
@@ -57,7 +57,7 @@ message MarketOrderList {
 
 message Buyer {}
 message Seller {}
-message CancleOrderReq{
+message CancelOrderReq{
   uint64 order_id = 1;
 }
 message NewMarketRes{
diff --git a/market/v1/srv.proto b/market/v1/srv.proto
index 98b4cbe..f7e7e0f 100644
--- a/market/v1/srv.proto
+++ b/market/v1/srv.proto
@@ -2,24 +2,26 @@ syntax = "proto3";
 
 package market.v1;
 
+import "auth/v1/msg.proto";
 import "base/v1/msg.proto";
 import "market/v1/msg.proto";
 
 service MarketplaceSrv {
-  rpc GetAssetList(MarketAssetListReq) returns (MarketAssetList);
-  rpc GetSellerList(OrderListFilter) returns (MarketOrderList);
-  rpc GetBuyerList(OrderListFilter) returns (MarketOrderList);
-  rpc GetAllOrderList(OrderListFilter) returns (MarketOrderList);
+  rpc GetAssetList(MarketAssetListReq) returns (MarketAssetList); //  assets that can be listed in marketplace
+  rpc GetSellerList(OrderListFilter) returns (MarketOrderList); //  list of orders by sellers
+  rpc GetBuyerList(OrderListFilter) returns (MarketOrderList); //  list of orders by buyers
+  rpc GetMarketOrderDet(auth.v1.IdReqWithIAM) returns (MarketOrder); // details of an order by id
+  rpc GetAllOrderList(OrderListFilter) returns (MarketOrderList); // list of all orders (seller and buyer combined)
 
   rpc GetMarketHistory(OrderListFilter) returns (MarketOrderList); // This is for public market
 
-  rpc Purchace(PurchaseReq) returns (PurchaseRes);
+  rpc Purchace(PurchaseReq) returns (PurchaseRes); // purchase from an order
 
-  rpc NewSellOrder(NewMarketReq) returns (NewMarketRes);
-  rpc NewBuyOrder(NewMarketReq) returns (NewMarketRes);
+  rpc NewSellOrder(NewMarketReq) returns (NewMarketRes); // insert new sell order to market
+  rpc NewBuyOrder(NewMarketReq) returns (NewMarketRes); // insert new buy order to market
 
-  rpc CancleOrder(CancleOrderReq) returns (base.v1.StatusRes);
+  rpc CancelOrder(CancelOrderReq) returns (base.v1.StatusRes); // cancel an order
 
-  rpc GetBuyHistory(OrderListFilterWithIAM) returns (MarketOrderList);
-  rpc GetSellHistory(OrderListFilterWithIAM) returns (MarketOrderList);
+  rpc GetBuyHistory(OrderListFilterWithIAM) returns (MarketOrderList); // list of order + purchase related to buying an asset
+  rpc GetSellHistory(OrderListFilterWithIAM) returns (MarketOrderList); // list of order + purchase related to selling an asset
 }