查詢Maker持倉

接口信息

接口: GET /api/v1/positions

描述: 查詢持有的股票token信息

鑑權: Authorization請求頭附加JWT令牌

查詢參數

參數	類型	必填	說明
ticker	string	否	股票代碼（精確匹配或模糊搜索）
ticker_like	boolean	否	是否啟用模糊搜索，默認false
page	int	否	頁碼，默認1
page_size	int	否	每頁數量，默認20，最大100

響應參數

字段	類型	說明
total	int	總記錄數
page	int	當前頁碼
page_size	int	每頁數量
total_pages	int	總頁數
positions	array	持倉列表

持倉對象字段

字段	類型	說明
positions[].ticker	string	股票代碼
positions[].exchange	int	市場代碼枚舉下標。詳見Exchange
positions[].token_address	string	Token地址
positions[].balance	string	持倉數量
positions[].locked_balance	string	被鎖持倉數量
positions[].available_balance	string	可用持倉數量
positions[].avg_price	string	成交均價

請求示例

curl -X GET "/api/v1/positions?page=1&page_size=20&ticker_like=true&ticker=AAPL" \
     -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
     -H "Content-Type: application/json"

響應示例

{
    "code": 0,
    "data": {
        "positions": [
            {
                "ticker": "AAPL",
                "exchange": 0,
                "token_address": "0xc48eec40...",
                "balance": "6",
                "locked_balance": "0",
                "available_balance": "6",
                "avg_price": "256598079145728583333"
            },
            {
                "ticker": "AMZN",
                "exchange": 0,
                "token_address": "0xfd5d300742...",
                "balance": "12",
                "locked_balance": "0",
                "available_balance": "12",
                "avg_price": "233225286432160750000"
            }
        ],
        "total": 2,
        "page": 1,
        "page_size": 20,
        "total_pages": 1
    }
}