數字貨幣關聯期貨
GET/api/v1.0/quote/{symbol}/crypto/related-future查詢指定數字貨幣（如 CC.BTC / CC.ETH）關聯的 CME / 港交所期貨合約列表。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
symbol | string | 路徑 | 是 | 數字貨幣標的代碼（路徑參數），例: CC.BTC / CC.ETH |
page_size | int | 查詢 | 否 | 返回條數，默認 50，最大 200 |
請求示例
bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/crypto/related-future?page_size=1' \
-H 'Authorization: Bearer <AccessToken>' | jq響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
data.items | object[] | |
data.items[].code | string | 標的代碼 |
data.items[].name | string | 標的名稱 |
data.items[].price | number | 最新價 |
data.items[].change_rate | number | 漲跌幅（百分數，原始值放大 10^9，1.2% 為 12000000） |
data.items[].ytd_change_rate | number | 年初至今漲跌幅（百分數） |
data.items[].volume | string | 成交量 |
data.items[].turnover | string | 成交額 |
data.items[].market_cap | string | 總市值（僅正股返回） |
data.items[].assets_size | string | 資產管理規模 AUM（僅 ETF 返回） |
錯誤碼
| ret_code | error.code | 說明 |
|---|---|---|
| 0 | — | 成功 |
| -3 | invalid_parameter | 參數缺失或不在允許範圍內 |
| -7 | invalid_symbol | 標的不存在 |
| -8 | unsupported | 市場或品類不支持 |
| -9 | permission_denied | 沒有對應權限 |
| -10 | no_data | 沒有可返回的數據 |
| -11 | rate_limited | 調用過於頻繁 |
響應示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"items": [
{
"code": "example",
"name": "example",
"price": "example",
"change_rate": "example",
"ytd_change_rate": "example",
"volume": "example"
}
]
}
}