okx_loan_ratios
Calculate OKX cryptocurrency loan ratios between borrowed quote currency and borrowed base currency to monitor borrowing patterns and market sentiment across different time periods.
Instructions
获取OKX加密货币借入计价货币与借入交易货币的累计数额比值
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| period | No | 时间粒度，仅支持: [5m/1H/1D] 注意大小写，仅分钟为小写m | 1h |
| symbol | No | 币种，格式: BTC 或 ETH | BTC |
Implementation Reference
- mcp_aktools/__init__.py:410-434 (handler)The complete implementation of the okx_loan_ratios tool, including decorator for registration, input schema via Field, and handler logic that fetches loan ratios from OKX API, processes into DataFrame, and returns CSV.@mcp.tool( title="获取加密货币杠杆多空比", description="获取OKX加密货币借入计价货币与借入交易货币的累计数额比值", ) 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:414-417 (schema)Pydantic Field definitions for input parameters: symbol (currency like BTC) and period (time granularity).def okx_loan_ratios( 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 registers the tool with title and description.@mcp.tool( title="获取加密货币杠杆多空比", description="获取OKX加密货币借入计价货币与借入交易货币的累计数额比值", )