---
# System prepended metadata

title: 後台報表功能(bo-gateway)

---

# 後台報表功能(bo-gateway)

## 請協助處理BUG 修復
1. 對照下面topic 根 kafka 當中資訊是否有落差
2. 跟現行版本有沒有誤差，
3. 修復query 問題以及回應的格式正確性，可推版到 console 驗證
4. 來源 kafka 檢查kafka 來源 api 確認一下. api 有回啥


| 功能FIGMA |  API | DUBI資料源 | Console |Jira| 誰修| 狀況 |
| -------- |-------- | -------- | -------- |-------- |-------- |-------- |
| [期貨數據管理-平台手續費數據查詢](https://www.figma.com/design/LGh5FlFGHyuXEhVlZ1RFr9/%E3%80%90CubNet%E3%80%91%E7%AE%A1%E7%90%86%E5%BE%8C%E5%8F%B0?node-id=1793-49865&t=vVJgGzykIpZYzP9R-0) | [手續費紀錄](http://10.99.113.153:40001/project/638/interface/api/13375) | [`合約開倉kafka`](####開倉手續費) [`合約平倉kafka`](####平倉手續費) |[console](https://pre-console.top.one/zh-TW/future/trading-fee)|CNX-636: <br>1. 交易對要轉格式(BTC/USDT -> BTCUSDT)<br> 2. 合約類型查詢無效果<br>3. 無倉位單號，也無法查詢<br>4. 時間查詢無效果<br> 5. 資料排序條件(新->舊)|slighter luke|目前 take_profit_price, stop_loss_price 仍會傳空字串，之前跟小杜確認不會改 <br> 1, 2, 3, 4, 5 ok|
| [期貨數據管理-用戶期貨倉位單管理](https://www.figma.com/file/LGh5FlFGHyuXEhVlZ1RFr9/%E3%80%90CubNet%E3%80%91%E7%AE%A1%E7%90%86%E5%BE%8C%E5%8F%B0?type=design&node-id=1793-49647&mode=design&t=k2FeEQdIrb33eXIh-4) | [倉位資料清單](http://10.99.113.153:40001/project/638/interface/api/13311)   | [`后台管理仓位列表`](####Position)|[console](https://pre-console.top.one/zh-TW/future/position)|用戶期貨倉位單查詢(CNX-637):1.交易對要轉格式(BTC/USDT -> BTCUSDT) 2. 持倉方向查詢無效果 3. 開倉時間查詢無效果 4. 平倉時間查詢無效果 5. 排序條件查詢無效果  <font color='red'>杜拜api無此功能</font>|luke| 杜拜的api有無時間參數都不會理會，持倉方向是有作用的 交易對回前端統一格式BTCUSDT(無斜線)<br>1, 2 ok|
| [期貨數據管理-用戶期貨委託單查詢](https://www.figma.com/design/LGh5FlFGHyuXEhVlZ1RFr9/%E3%80%90CubNet%E3%80%91%E7%AE%A1%E7%90%86%E5%BE%8C%E5%8F%B0?node-id=1793-49647&t=58tlovDfXEkcmndD-0) | [用戶期貨委託單](http://10.99.113.153:40001/project/638/interface/api/13667)  | [`委托单kafka`](####委託單)|[console](https://pre-console.top.one/zh-TW/future/order)|用戶委託單查詢(CNX-629):1. 交易對要轉格式(BTC/USDT -> BTCUSDT)2. 沒給委託單號/交易單號3. 持倉方向查詢無效果4. 委託方向查詢無效果5. 資料排序條件(新->舊)| slighter | 1. pos_id 目前看到 2024-05-24T14:26:53Z 還有空字串資料送過來，不確定是不是會發生只有 order_id 沒有 pos_id 的狀況 2. stop_loss_type, close_type, cancel_type 會有傳 0 的狀況 (好像合理？) <br>1, 2, 3, 4, 5 ok|
| [期貨數據管理-平台期貨盈虧統計](https://www.figma.com/design/LGh5FlFGHyuXEhVlZ1RFr9/%E3%80%90CubNet%E3%80%91%E7%AE%A1%E7%90%86%E5%BE%8C%E5%8F%B0?node-id=1793-49733&t=P8nOiyyZwdKpe8uM-0) | [當日平台盈虧-每小時更新](http://10.99.113.153:40001/project/638/interface/api/13315) [平台盈虧紀錄](http://10.99.113.153:40001/project/638/interface/api/13319)  | [`資金費kafka`](###0524資金費topic差異) [`合約開倉kafka`](####開倉手續費) [`合約平倉kafka`](####平倉手續費)|[console](https://pre-console.top.one/zh-TW/future/pnl-statistics)|平台盈虧統計(CNX-632):1. 列表不應出現今日數據 | slighter |1 ok|
| [期貨數據管理-平台資金費數據查詢](https://www.figma.com/design/LGh5FlFGHyuXEhVlZ1RFr9/%E3%80%90CubNet%E3%80%91%E7%AE%A1%E7%90%86%E5%BE%8C%E5%8F%B0?node-id=1793-49792&t=GVRxKT5PtwO0bask-0) | [資金費紀錄](http://10.99.113.153:40001/project/638/interface/api/13323) | [`資金費kafka`](###0524資金費topic差異) |[console](https://pre-console.top.one/zh-TW/future/funding-fee)|平台資金費數據查詢(CNX-633):1. 交易對要轉格式(BTC/USDT -> BTCUSDT)2. 資料排序條件(新->舊) | slighter |1, 2 ok
| [期貨數據管理-平台爆倉數據查詢](https://www.figma.com/design/LGh5FlFGHyuXEhVlZ1RFr9/%E3%80%90CubNet%E3%80%91%E7%AE%A1%E7%90%86%E5%BE%8C%E5%8F%B0?node-id=1793-49792&t=GVRxKT5PtwO0bask-0) | [爆倉紀錄](http://10.99.113.153:40001/project/638/interface/api/13367) |[`后台管理仓位列表`](####Position) |[consile](https://pre-console.top.one/zh-TW/future/system/liquidation)|平台爆倉數據查詢(CNX-635):1. 交易對要轉格式(BTC/USDT -> BTCUSDT)2. 倉位單號查詢無效果3. 爆倉結餘及標記價格不應為0 4. 資料排序條件(新->舊)| Nabi |2. 帶id查詢資料格式正確，<font color ='red'>dubi api 使用 id 查詢無效果</font><br> 3. <font color ='red'>目前 dubi api 爆倉結餘資訊皆為 0 (resp 參數 liquidation_balance）</font>標記價格有數值 <br> 1, 4 ok|
| [期貨數據管理-平台手續費數據查詢](https://www.figma.com/design/LGh5FlFGHyuXEhVlZ1RFr9/%E3%80%90CubNet%E3%80%91%E7%AE%A1%E7%90%86%E5%BE%8C%E5%8F%B0?node-id=1793-49865&t=vVJgGzykIpZYzP9R-0) | [手續費紀錄](http://10.99.113.153:40001/project/638/interface/api/13375) |  [`合約開倉kafka`](####開倉手續費) [`合約平倉kafka`](####平倉手續費) |[console](https://pre-console.top.one/zh-TW/future/trading-fee)|平台手續費數據查詢(CNX-636):1. 交易對要轉格式(BTC/USDT -> BTCUSDT)2. 合約類型查詢無效果3. 無倉位單號，也無法查詢4. 時間查詢無效果5. 資料排序條件(新->舊) | slighter | 1 2 3 4 5問題已解決 |
| [平台資產管理-平台帳戶流水查詢-手續費帳戶](https://www.figma.com/design/LGh5FlFGHyuXEhVlZ1RFr9/%E3%80%90CubNet%E3%80%91%E7%AE%A1%E7%90%86%E5%BE%8C%E5%8F%B0?node-id=2618-34855&t=vVJgGzykIpZYzP9R-0) | [平台資產帳戶流水](http://10.99.113.153:40001/project/638/interface/api/13683) |  [`合約開倉kafka`](####開倉手續費) [`合約平倉kafka`](####平倉手續費)  |[console](https://pre-console.top.one/zh-TW/platform/assets/transactions)|平台帳戶流水查詢-手續費帳戶(CNX-642):1. 沒給開/平倉類型，也無法查詢2. 沒給幣種，也無法查詢3. 訂單類型查詢無效果4. 資料排序條件(新->舊) | slighter luke| 1234解決 反傭api沒有排序條件, 反擁以修正|
| [平台資產管理-平台帳戶資產明細查詢-對賭帳戶](https://www.figma.com/design/LGh5FlFGHyuXEhVlZ1RFr9/%E3%80%90CubNet%E3%80%91%E7%AE%A1%E7%90%86%E5%BE%8C%E5%8F%B0?node-id=2618-33974&t=vVJgGzykIpZYzP9R-0) | [平台資產帳戶](http://10.99.113.153:40001/project/638/interface/api/13675) | |[console](https://pre-console.top.one/zh-TW/platform/assets/account)|平台帳戶流水查詢-對賭帳戶(CNX-643):1. 資料排序條件(新->舊)2. 會有無訂單ID資料3. 訂單類型查詢無效果 | slighter |13解決 無訂單資料是杜拜那邊會沒給|
| [平台資產管理-平台帳戶流水查詢-帳戶](https://www.figma.com/design/LGh5FlFGHyuXEhVlZ1RFr9/%E3%80%90CubNet%E3%80%91%E7%AE%A1%E7%90%86%E5%BE%8C%E5%8F%B0?node-id=2618-34855&t=vVJgGzykIpZYzP9R-0) | [平台資產帳戶流水](http://10.99.113.153:40001/project/638/interface/api/13683) | [`做市预估收入列表`](####做市预估收入列表) |[consle](https://pre-console.top.one/zh-TW/platform/assets/account)|平台帳戶流水查詢-爆倉帳戶(CNX-645):1. 資料排序條件(新->舊)2. 資料回傳的時間格式錯誤，查詢也無效果3. 訂單編號查詢無效|Luke|1 2 3解決|
| [對賭資金管理-對賭帳戶管理](https://www.figma.com/design/LGh5FlFGHyuXEhVlZ1RFr9/%E3%80%90CubNet%E3%80%91%E7%AE%A1%E7%90%86%E5%BE%8C%E5%8F%B0?node-id=1793-50795&t=vVJgGzykIpZYzP9R-0) | [對賭資產查詢](http://10.99.113.153:40001/project/638/interface/api/13191) | [查询对赌账户信息API](####查询对赌账户信息)  | [`console`](https://pre-console.top.one/zh-TW/asset/pool)|1. DUBI手動轉入轉出API需增加UID request參數<font color='red'>杜拜api無此功能</font>

#### 開倉手續費 
1. topic: contract-asset-opening-report

```json
{
    "status": {
        "trace_id": "",
        "code": 102000,
        "error": {},
        "messages": ""
    },
    "data": {
        "brand": "",
        "tag": "",
        "service_name": "contract-asset",
        "action": "open-position-push",
        "event_type":2,        //1 资金费  2 开仓  3 平仓 
        "order_id": "TX13156456456",
        "user_id": "111111",
        "direction":1,                //净头寸方向  1开多   2开空
        "push_time":1712327805445000000,        //推送时间 纳秒
        "contract_code":"BTC/USDT",                // 币对
        "order_creation_time":1712327805445000000, //订单创建时间 纳秒(开仓时间)
        "amount":"20.2",                        //数量
        "mode":1,                               // 1 永续合约, 2 闪电合约,
        "leverage_ratio":20,                    //杠杆倍数   
        "opening_price":"12.343",                //开仓价
        "margin":"12.4124",                      //初始保证金
        "fee": "20.22221",      //开仓手续费
        "fee_ratio": "0.2225",    //手续费比例
        "liquidation_price":"2222",              //强平价格
        "take_profit_price":"222.3",            //止盈价格
        "stop_loss_price":"222.1",                //止损价格
        "total_amount":"2222.4",                //总额
        "position_id":"23135416af4dazsf"        //仓位id
    }
}
```

#### 平倉手續費 
1. topic: contract-asset-closing-report

```json
{
    "status": {
        "trace_id": "",
        "code": 102000,
        "error": {},
        "messages": ""
    },
    "data": {
        "brand": "",
        "tag": "",
        "service_name": "contract-asset",
        "action": "close-position-push",
        "event_type":3,        //1 资金费  2 开仓  3 平仓 
        "order_id": "TX13156456456",
        "user_id": "111111",
        "direction":1,                //净头寸方向  1开多   2开空
        "push_time":1712327805445000000,        //推送时间 纳秒
        "contract_code":"BTC/USDT",                // 币对
        "order_creation_time":1712327805445000000, //订单创建时间 纳秒
        "amount":"20.2",                        //数量
        "mode":1,                                // 1 永续合约, 2 闪电合约,
        "leverage_ratio":20,                    //杠杆倍数   
        "type":1,                               // 1手动平仓 ,2 止盈  3止损   4爆仓 5 反向爆仓        
        "fee":"0.43",                            //平仓手续费
        "fee_ratio":"0.0003",                    //手续费比例
        "closing_price":"2.214",                //平仓价格
        "real_pnl":"20.2222",                //平仓盈亏
        "closing_time":1712327805445000000,    //平仓时间,
        "take_profit_price":"222.3",            //止盈价格
        "stop_loss_price":"222.1",                //止损价格
        "total_amount":"2222.4",                //交易总额
        "position_id":"23135416af4dazsf",        //仓位id
        "margin":"20",                            //保证金
        "liquidation_balance":"0.25"               //爆仓结余, 会转入爆仓账户
    }
}
```


#### 委託單
1. topic: order-report

```json
{
 "status": {
        "trace_id": "",
        "code": 102000,
        "error": {},
        "messages": ""
    },
    "data": {
        "brand": "esc",
        "tag": "order-OrderStatusTimeout",
        "service_name": "order",
        "action": "order-change-push",  //委托单变化推送
        "id": "1315645645688888",  //订单orderid
        "user_id": "111111",
        "user_type":1,        //1-普通用户;2-模拟用户
        "price":"0.25",            //无论是市价还是限价，成交价格都会 使用该字段    
        "amount":1,                //委托数量（张数）
        "leverage":10,    //杠杆倍数
        "filled_fee":"35.2555",        //成交手续费
        "push_time":1712327805445,        //推送时间 毫秒
        "contract_code":"BTC/USDT",                // 币对
        "create_time":1712327805445, //成交时间 毫秒
        "order_type":10,//10-普通订单  31-止盈  36-止损
        "is_limit_order":1,//1-限价，2-市价
        "stop_loss_type":1,//1-委托时止盈止损单，2-持仓时开止盈止损单
        "parent_id":"1111111",//主订单id
        "side":1,//1-买，2-卖
        "offset":1,//1-开仓，2-平仓
        "hold_mode":2,//目前只有2-逐仓
        "unit":"0.001",//每张数量
        "margin":"200"，//保证金数量(不包含手续费)
        "total_amount":"1000",//总市值单位USDT
        "total_quantity":"10.2",//总数量
        "trigger_price":"111",//触发价格
        "trigger_state":"1",//触发状态（目前没用，预留状态字段）
        "liquidation_type":"0",//0-普通单,1-强平单 2-做市单
        "status":1,//1-委托中  4-已完成   6-已撤销 10-未激活  30-已过期
        "close_type":1,//1-手动平仓、2-止盈 3-止损  4-爆仓 5-做市
        "open_fee_rate":"0.0001",//开仓手续费率
        "close_fee_rate":"0.0001",//平仓手续费率
        "mode":1,//合约类型1-普通模式，2-闪电模式
        "cancel_type":1,//1-手动撤单 2-系统撤单
        "pos_id":"11111"，//仓位id
        "price_scale":4,//价格精度
        "max_profit_multiples":5,//最大盈利倍数
        "push_time":100000000,//推送时间毫秒
        "quantity_scale":5,//数量精度
        "profit_real":"1000",//已实现盈亏
        "fund_fee":"10",//资金费
        "last_price":"10000",//成交价
        "entrust_price":"10000",//委托价
        "created_time":45555555,//创建时间毫秒
        "updated_time":55555555//更新时间毫秒
    }
}
```

### API
 
#### Position
Path： /v1/contract-order/manager/position/list
Method： GET
query 參數
![截圖 2024-05-24 下午1.56.05](https://hackmd.io/_uploads/SkSW2spQR.png)

回應
```json
{
  "status": {
    "code": 102000,
    "error": null,
    "messages": "success"
  },
  "data": {
    "list": [
      {
        "id": "177992602543460352",
        "order_id": "1315645645688888",
        "user_id": "111111",
        "user_type":1,        //1-普通用户;2-模拟用户
        "price":"0.25",            //委托价格     
        "amount":1,                //委托数量（张数）
        "leverage":10,    //杠杆倍数
        "filled_fee":"35.2555",        //成交手续费
        "push_time":1712327805445,        //推送时间 毫秒
        "contract_code":"BTC-USDT",                // 币对
        "status": 1,    //1-已创建,4-已完成(成交明细只使用4状态的)
        "create_time":1712327805445, //成交时间 毫秒
        "order_type":10,//10-普通订单  31-止盈  36-止损
        "is_limit_order":1,//1-限价，2-市价
        "stop_loss_type":1,//1-委托时止盈止损单，2-持仓时开止盈止损单
        "parent_id":"1111111",//主订单id
        "side":1,//1-买，2-卖
        "offset":1,//1-开仓，2-平仓
        "unit":"0.001",//每张数量
        "margin":"200"，//保证金数量(不包含手续费)
        "total_amount":"1000",//总市值
        "total_quantity":10.2,//总数量
        "trigger_price":"111",//触发价格
        "trigger_state":"1",//触发状态
        "liquidation_type":"0",//0-普通单,1-强平单
        "status":1,//1-委托中  4-已完成   6-已撤销 10-未激活  30-已过期
        "close_type":1,//1-手动平仓、2-止盈平仓  3-止损平仓 4-爆仓 5-做市爆仓
        "open_fee_rate":"0.1",//开仓手续费率
        "close_fee_rate":"0",//平仓手续费率
        "mode":1,//1-普通模式，2-闪电模式
        "cancel_type":1,//1-撤单
        "pos_id":"11111"，//平仓仓位id
        "price_scale":4,//价格精度
        "quantity_scale":5,//数量精度
        "profit_real":"1000",//已实现盈亏
        "fund_fee":"10",//资金费
        "created_time":45555555,//创建时间毫秒
        "updated_time":55555555//更新时间毫秒
      }
    ],
    "page": {
      "total": 6,
      "index": 1,
      "size": 1
    }
  }
}
```


#### 查询对赌账户信息
Path： /v1/system/betting-account
Method： GET
接口描述：
请求参数
Query
![截圖 2024-05-24 下午3.10.40](https://hackmd.io/_uploads/HJxFanpm0.png)


resp
```json
{
    "status": {
        "code": 102000,
        "messages": "messages"
    },
    "data": {
        "id": 11,
        "account_name": "对赌账户BTC-USDT",
        "account_type": 3,
        "account_amount": 1000.54,
        "accumulated_recharge": 1000000.25,
        "contract_code": "BTC/USDT",
        "warning_amount": "800000.1",
        "total_outflow":"1000"    //累计转出
    }
}

```
#### 做市预估收入列表
topic: liquidation-revenue-estimation
```json
kafka.Message{
    Status: kafka.Status{
        Code:  int(domain.CodeOk),
        Error: struct{}{},
    },
    Data: RevenueEstimationResult,
}

type RevenueEstimationResult struct {
        ContractCode string               `json:"contract_code"` // 币对
        MarkPrice    decimal.Decimal      `json:"mark_price"`    // 标记价格
        UpList       []*RevenueEstimation `json:"up_list"`       // 列表上部分数据, 按照rate升序排序(爆空仓预估列表)
        DownList     []*RevenueEstimation `json:"down_list"`     // 列表下部分数据, 按照rate降序排序(爆多仓预估列表)
}

type RevenueEstimation struct {
        Rate   decimal.Decimal `json:"rate"`   // 价格变化百分比
        Price  decimal.Decimal `json:"price"`  // 百分比对应标记价格
        Profit decimal.Decimal `json:"profit"` // 百分比对应收益
}

{
  "status": {
    "trace_id": "",
    "code": 102000,
    "error": {},
    "messages": ""
  },
  "data": {
    "contract_code": "BTC/USDT",
    "mark_price": "65000",
    "up_list": [
      {
        "rate": "0.001",
        "price": "63675.612",
        "profit": "0"
      },
      {
        "rate": "0.002",
        "price": "63739.224",
        "profit": "0"
      },
      {
        "rate": "0.003",
        "price": "63802.836",
        "profit": "599"
      }
    ],
    "down_list": [
      {
        "rate": "-0.001",
        "price": "63548.388",
        "profit": "1598"
      },
      {
        "rate": "-0.002",
        "price": "63484.776",
        "profit": "1598"
      },
      {
        "rate": "-0.003",
        "price": "63421.164",
        "profit": "1598"
      }
    ]
  }
}
```

### 0524資金費topic差異
5/22 刪除前
```json
{
    "status": {
        "trace_id": "",
        "code": 102000,
        "error": {},
        "messages": ""
    },
    "data": {
        "brand": "",
        "tag": "",
        "service_name": "contract-asset",
        "action": "funding-fee-push",
        "event_type":1,        //1 资金费  2 开仓  3 平仓 
        "order_id": "TX13156456456",
        "user_id": "111111",
        "fund_ratio":"0.0201",        //资金费比例
        "fund_fee":"0.25",            //资金费
        "direction":1,                //    净头寸方向  1开多   2开空
        "net_position_quantity":"20.22225",    //净头寸数量
        "net_position_value":"35.2555",        //净头寸价值
        "mark_price":"34.6666",      //收取资金费率时的标记价格
        "push_time":1712327805445000000,        //推送时间 纳秒
        "contract_code":"BTC/USDT",                // 币对
        "order_creation_time":1712327805445000000, //订单创建时间 纳秒
        "position_id":"23135416af4dazsf"        //仓位id
    }
}
```
5/24 新增回來之後
```json
{
    "status": {
        "trace_id": "",
        "code": 102000, 
        "error": {},
        "messages": ""
    },
    "data": {
        "brand": "",
        "tag": "",
        "service_name": "contract-asset",
        "action": "funding-fee-push",
        "fund_ratio":"0.0201",        //资金费比例
        "fund_fee":"0.25",            //资金费  正数增加,负数减少
        "push_time":1712327805445000000,        //推送时间 纳秒
        "contract_code":"BTC/USDT",                // 币对
        "account_amount":"10"     //上账后账户余额
    }
}
```

差異 - 少了的
1. "position_id":"23135416af4dazsf"        //仓位id
2. "order_creation_time":1712327805445000000, //订单创建时间 纳秒
3. "mark_price":"34.6666",      //收取资金费率时的标记价格
4. "net_position_value":"35.2555",        //净头寸价值
5. "net_position_quantity":"20.22225",    //净头寸数量
6. "direction":1,                //    净头寸方向  1开多   2开空
7. "order_id": "TX13156456456"
8. "user_id": "111111",

上漲後餘額，要解決什麼問題，待確認一下

<font color='red'> 1. position_id 平台資金流水會用到，目前沒有會出問題</font>
<font color='red'> 2. order_creation_time 目前是時間區間條件，沒有 filter 會壞掉 (改成 push_time？)</font>
<font color='red'> 3. 上漲後餘額目前應該用不到？可能是因為原規格有異動前後餘額？</font>


## 協助確認兩件事

#### 問題一
 <font color='red'>這題先幫我確認拿到的 topic 是正確的，然後我們存到資料庫當中長怎樣</font>
![截圖 2024-05-24 下午6.30.54 (1)](https://hackmd.io/_uploads/By3qADW4C.png)
topic:user-account-assets
確認是否有收到這個 topic. 且結構為
```json
{
    "status": {
        "trace_id": "",
        "code": 102000,
        "error": {},
        "messages": ""
    },
    "data": {
        "brand": "",
        "tag": "",
        "service_name": "contract-asset",
        "action": "user-account-push", //用户账户变更推送
        "user_id":"111111",            //uid
        "frozen_amount":"1000.0001",    //入账后冻结金额
        "available_amount":"1.0",        //入账后可用金额
        "amount":"12222",                //变化金额  正数转入,负数转出
        "event_type":1,                    //0 冻结解冻金额,1 转入转出, 2 资金费 ,3 开仓 ,4 平仓, 5 追加保证金
        "state":0,                         //账号状态, 0正常  1封禁
        "user_type": 1,                    //1 用户账户 ,2模拟账户 
       "push_time":1712327805445000000,  //推送时间 纳秒
    }
}

```
目前有傳，不過 argo 上沒看到 subscriber 啟動，應該是部署問題
![截圖 2024-05-27 中午12.07.34](https://hackmd.io/_uploads/HJ9BPYZNA.png)

原本待解決問題點：
1. 無法得知 劃轉 轉入轉出
2. 無法得知 異動前/後數量 , 只能知道異動數量

杜拜說

 - 当前合约交易账户余额 = frozen_amount + available_amount
 - amount是有正负的，正代表用户交易账户加钱，负代表用户交易账户减钱，只关系event_type=1，user_type=1的情况
 - 账户变动前 = 当前合约交易账户余额 - amount（带符号）
<font color = red> => event_type != 1，user_type != 1 先這樣算，有問題在確認 </font>
 
交易賬戶流水
https://pre-console.top.one/zh-TW/users/assets/wallet-trading

看起來應該就是從這邊來 user-account-assets
他給的 type 看起來為 "event_type":1,   //0 冻结解冻金额,1 转入转出, 2 资金费 ,3 开仓 ,4 平仓, 5 追加保证金

而我們後台有這些，我找不到合約跟劃轉，想問說杜拜給的訊息是否不夠我們判斷

```golang=
	case 1: // 合約
		orderTypeFilter = []int8{0, 5}
	case 2: // 開倉
		orderTypeFilter = []int8{3}
	case 3: // 平倉
		orderTypeFilter = []int8{4}
	case 5: // 劃轉
		orderTypeFilter = []int8{1}
	case 6: // 資金費
		orderTypeFilter = []int8{2}
	
```
<font color=red> => 先依照這個轉換處理 </font>
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
 	
#### 問題二
 <font color='red'> 到 pre gateway 去創帳號，然後轉前開平倉，之後來看觀察這個topic 的種類事不是正確的 </font>
 
前台。https://pre.top.one/zh-TW

有四種方式，前台用戶賺錢或虧錢分別對應3 4
後台加減前，分別對應 1 跟 2 
目前驗證了134 ，2 因為後台無法轉出錢而無法測，根 pm 確認中

<font color='red'> * 有先請 Jack 幫忙打腳本嘗試把對賭帳號金額弄成正的來測試 2 </font>

 小工具可以跟我拿
![截圖 2024-05-24 下午6.04.40](https://hackmd.io/_uploads/BkgYCPW4R.png)

topic:system-account-assets
```json
{
    "status": {
        "trace_id": "",
        "code": 102000,
        "error": {},
        "messages": ""
    },
    "data": {
        "brand": "",
        "tag": "",
        "service_name": "contract-asset",
        "action": "system-account-push", //对赌账户变更推送
       "account_amount":"10",     //上账后账户余额
       "account_type":3,          //账户类型  固定为 3
       "account_name":"对赌账户",    //账户名称
       "accumulated_recharge":"5000",//平台累计充值
       "total_outflow":"1500",//平台累积转出
       "contract_code":"BTC/USDT",    //币对
       "warning_amount":"20",         //预警值
       "real_pnl":"2000.0001",        //盈利或亏损.全部正数
       "type":1,                       // 说明：1 `手动转入对赌账户`, 2 `手动转出对赌账户`,3 `用户盈利(对赌账户转出)`,4 `用戶亏损`(对赌账户转入)
       "user_id":"",                    //用户id
       "position_id":"",                //仓位id
       "push_time":1712327805445000000,  //推送时间 纳秒
       "admin_uid":"EEEFEFASFASEF"        //管理后台 uid (创建对赌账号时如果没传入admin_uid参数, kafka对应的就是空)
    }
}
```

#### 問題三

![kafka topic](https://hackmd.io/_uploads/ByGHEyGV0.png)

當手動轉入轉出時，已經帶入UID參數但實際收到kafka data <font color='red'>user_id</font>還是空的


========================
### 與PM 同步區域

##### Case 1
對應 excel 問題
![截圖 2024-05-24 下午6.30.54 (1)](https://hackmd.io/_uploads/By3qADW4C.png)

[交易賬戶流水頁面](https://pre-console.top.one/zh-TW/users/assets/wallet-trading)
會使用由杜拜提供的 Kafka topic:user-account-assets 獲取部分資訊，會無法明確得知
1. 劃轉 轉入轉出
2. 異動前/後數量

經由 5/27 追蹤後
已有把異動欄位整理成下列規則
1. 当前合约交易账户余额 = frozen_amount + available_amount
   amount是有正负的，正代表用户交易账户加钱，负代表用户交易账户减钱，只关系event_type=1，user_type=1的情况
2. 账户变动前 = 当前合约交易账户余额 - amount（带符号）
3. 其他 event_type != 1，user_type != 1 先按照他上面寫的做歸類，有問題再做詢問

小結： 
1. 劃轉轉入轉出，以及種類，可以依照 event_type 跟 user_type 來做分類
2. 異動前後數量，可以按照上面第一點，第二點的規則來做運算

##### Case 2
對應 excel 問題
![截圖 2024-05-24 下午6.04.40](https://hackmd.io/_uploads/BkgYCPW4R.png)

有四種方式，前台用戶賺錢或虧錢分別對應3 4
後台加減前，分別對應 1 跟 2 
目前除2外驗證均已驗證，目前看起來是ok的
原因是要扣除成本後才可以，但餘額差太多弄不回來


##### Case 3
對應 excel 問題
![unnamed](https://hackmd.io/_uploads/HkbDm2GVC.png)

實際收到
![kafka topic](https://hackmd.io/_uploads/ByGHEyGV0.png)
當手動轉入轉出時，已經帶入UID參數但實際收到kafka data <font color='red'>user_id</font>還是空的


##### Case 4
[倉位資料清單](http://10.99.113.153:40001/project/638/interface/api/13311) 
缺少 排序條件查詢無效果
========================

