okx_loan_ratios
Calculate cumulative loan ratios for OKX cryptocurrency borrowing to assess market leverage positions and borrowing activity across different time periods.
Instructions
获取OKX加密货币借入计价货币与借入交易货币的累计数额比值
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | No | 币种，格式: BTC 或 ETH | BTC |
| period | No | 时间粒度，仅支持: [5m/1H/1D] 注意大小写，仅分钟为小写m | 1h |
Implementation Reference
- mcp_aktools/__init__.py:414-434 (handler)The main handler function that implements the okx_loan_ratios tool. It fetches loan ratio data from OKX API, processes it into a pandas DataFrame with columns for time and ratio, and returns it as a CSV string.def okx_loan_ratios( symbol: str = Field("BTC", description="币种，格式: BTC 或 ETH"), period: str = Field("1h", description="时间粒度，仅支持: [5m/1H/1D] 注意大小写，仅分钟为小写m"), ): res = requests.get( f"{OKX_BASE_URL}/api/v5/rubik/stat/margin/loan-ratio", params={ "ccy": symbol, "period": period, }, timeout=20, ) data = res.json() or {} dfs = pd.DataFrame(data.get("data", [])) if dfs.empty: return pd.DataFrame() dfs.columns = ["时间", "多空比"] dfs["时间"] = pd.to_datetime(dfs["时间"], errors="coerce", unit="ms") dfs["多空比"] = pd.to_numeric(dfs["多空比"], errors="coerce") return dfs.to_csv(index=False, float_format="%.2f").strip()
- mcp_aktools/__init__.py:415-416 (schema)Pydantic Field definitions providing input schema validation and descriptions for the tool parameters: symbol (currency) and period (time granularity).symbol: str = Field("BTC", description="币种，格式: BTC 或 ETH"), period: str = Field("1h", description="时间粒度，仅支持: [5m/1H/1D] 注意大小写，仅分钟为小写m"),
- mcp_aktools/__init__.py:410-413 (registration)The @mcp.tool decorator that registers the okx_loan_ratios function as an MCP tool with its title and description.@mcp.tool( title="获取加密货币杠杆多空比", description="获取OKX加密货币借入计价货币与借入交易货币的累计数额比值", )