jcdata 0.1.0__tar.gz

jcdata-0.1.0/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: jcdata
+Version: 0.1.0
+Summary: JCDATA
+Author: JCDATA
+License: Proprietary
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24
+Requires-Dist: pandas>=1.3
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+
+# jcdata
+
+连接 JCDATA 数据服务，详情可查看官网：[https://jicequant.com/](https://jicequant.com/)
+
+用户注册后即可在个人中心使用一定额度的数据服务
+
+## 安装
+
+```bash
+pip install jcdata
+```
+
+## 配置
+
+访问令牌任选一种方式提供：
+
+```python
+import jcdata
+
+jcdata.login(token="你的访问令牌")
+```
+
+或设置环境变量后直接 `jcdata.login()`：
+
+```bash
+export JCDATA_TOKEN="你的访问令牌"
+```
+
+也可安装后编辑包内 **`jcdata/config.py`** 中的 `TOKEN`，再执行 `jcdata.login()`。
+
+## 使用
+
+```python
+import jcdata
+
+jcdata.login(token="你的访问令牌")
+print(jcdata.whoami())
+
+df = jcdata.get_market_data("600000.SH", "2025-01-01", "2025-01-31")
+```
+
+## 主要接口
+
+- **行情**：`get_market_data`
+- **基础信息**：`get_instrument`、`get_price_limits`、`get_adj_factor`、`get_turn_rate`、`get_trading_status`
+- **期货/转债**：`get_settlement`、`get_conv_bond_terms`、`get_future_contract`
+- **股票因子**：`get_valuation`、`get_market_value`、`get_finance`
+- **其它**：`get_trade_dates`、`get_index_constituents`、`get_option_bars`、`get_option_info`、`get_sectors`（板块快照，`ts` 为库内占位）
+
+代码格式为 Wind 风格，如 `600000.SH`。

jcdata-0.1.0/README.md

@@ -0,0 +1,50 @@
+# jcdata
+
+连接 JCDATA 数据服务，详情可查看官网：[https://jicequant.com/](https://jicequant.com/)
+
+用户注册后即可在个人中心使用一定额度的数据服务
+
+## 安装
+
+```bash
+pip install jcdata
+```
+
+## 配置
+
+访问令牌任选一种方式提供：
+
+```python
+import jcdata
+
+jcdata.login(token="你的访问令牌")
+```
+
+或设置环境变量后直接 `jcdata.login()`：
+
+```bash
+export JCDATA_TOKEN="你的访问令牌"
+```
+
+也可安装后编辑包内 **`jcdata/config.py`** 中的 `TOKEN`，再执行 `jcdata.login()`。
+
+## 使用
+
+```python
+import jcdata
+
+jcdata.login(token="你的访问令牌")
+print(jcdata.whoami())
+
+df = jcdata.get_market_data("600000.SH", "2025-01-01", "2025-01-31")
+```
+
+## 主要接口
+
+- **行情**：`get_market_data`
+- **基础信息**：`get_instrument`、`get_price_limits`、`get_adj_factor`、`get_turn_rate`、`get_trading_status`
+- **期货/转债**：`get_settlement`、`get_conv_bond_terms`、`get_future_contract`
+- **股票因子**：`get_valuation`、`get_market_value`、`get_finance`
+- **其它**：`get_trade_dates`、`get_index_constituents`、`get_option_bars`、`get_option_info`、`get_sectors`（板块快照，`ts` 为库内占位）
+
+代码格式为 Wind 风格，如 `600000.SH`。

jcdata-0.1.0/__init__.py

@@ -0,0 +1,63 @@
+# -*- coding: utf-8 -*-
+"""
+JCDATA 客户端：连接数据服务后取历史行情与因子数据。
+
+使用前调用 ``jcdata.login(token=...)``（或设置环境变量 ``JCDATA_TOKEN``）::
+
+    import jcdata
+
+    jcdata.login(token="你的访问令牌")
+    df = jcdata.get_market_data("600000.SH", "2025-01-01", "2025-01-31")
+"""
+from __future__ import annotations
+
+from jcdata._http import current_user, login, whoami
+from jcdata.errors import CellQuotaExceededError, ErrorCode, RowQuotaExceededError
+from jcdata.data import (
+    get_adj_factor,
+    get_conv_bond_terms,
+    get_finance,
+    get_future_contract,
+    get_index_constituents,
+    get_instrument,
+    get_market_data,
+    get_market_value,
+    get_option_bars,
+    get_option_info,
+    get_price_limits,
+    get_sectors,
+    get_settlement,
+    get_trade_dates,
+    get_trading_status,
+    get_turn_rate,
+    get_valuation,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "__version__",
+    "login",
+    "whoami",
+    "current_user",
+    "ErrorCode",
+    "CellQuotaExceededError",
+    "RowQuotaExceededError",
+    "get_market_data",
+    "get_instrument",
+    "get_price_limits",
+    "get_adj_factor",
+    "get_turn_rate",
+    "get_trading_status",
+    "get_settlement",
+    "get_conv_bond_terms",
+    "get_future_contract",
+    "get_valuation",
+    "get_market_value",
+    "get_finance",
+    "get_trade_dates",
+    "get_index_constituents",
+    "get_option_bars",
+    "get_option_info",
+    "get_sectors",
+]

jcdata-0.1.0/_http.py

@@ -0,0 +1,187 @@
+# -*- coding: utf-8 -*-
+"""内部 HTTP 传输（不对外导出）。"""
+from __future__ import annotations
+
+import os
+from typing import Any
+
+import httpx
+import pandas as pd
+
+from jcdata import config
+from jcdata.errors import CellQuotaExceededError, ErrorCode
+
+_client: httpx.Client | None = None
+_user_name: str | None = None
+_authenticated: bool = False
+
+
+def _build_base_url(url: str, port: int | None = None) -> str:
+    """构建完整的 base_url，支持端口配置。"""
+    url = url.rstrip("/")
+    if port is not None:
+        if "://" in url:
+            protocol, rest = url.split("://", 1)
+            host = rest.split(":")[0].split("/")[0]
+            return f"{protocol}://{host}:{port}"
+        else:
+            host = url.split(":")[0].split("/")[0]
+            return f"{host}:{port}"
+    return url
+
+
+def _resolve_token(token: str | None) -> str:
+    """解析访问令牌，优先级：参数 > 环境变量 > config.py。"""
+    key = token if token is not None else os.environ.get("JCDATA_TOKEN") or config.TOKEN
+    key = str(key or "").strip()
+    if not key:
+        raise ValueError(
+            "请设置访问令牌：login(token=...)、环境变量 JCDATA_TOKEN，或 jcdata/config.py 中的 TOKEN"
+        )
+    return key
+
+
+def _resolve_base_url(base_url: str | None) -> str:
+    """解析服务地址，优先级：参数 > 环境变量 > config.py。"""
+    return (base_url or os.environ.get("JCDATA_BASE_URL") or config.BASE_URL).strip()
+
+
+def _resolve_port(port: int | None) -> int | None:
+    """解析端口，优先级：参数 > 环境变量 > config.py。"""
+    if port is not None:
+        return port
+    env_port = os.environ.get("JCDATA_PORT")
+    if env_port:
+        try:
+            return int(env_port)
+        except ValueError:
+            pass
+    return config.PORT
+
+
+def _resolve_timeout(timeout_sec: float | None) -> float:
+    """解析超时时间，优先级：参数 > config.py。"""
+    return timeout_sec if timeout_sec is not None else config.TIMEOUT_SEC
+
+
+def _resolve_verify(verify: bool | None) -> bool:
+    """解析是否验证令牌，优先级：参数 > config.py。"""
+    return verify if verify is not None else config.VERIFY_ON_LOGIN
+
+
+def login(
+    base_url: str | None = None,
+    *,
+    token: str | None = None,
+    port: int | None = None,
+    timeout_sec: float | None = None,
+    verify: bool | None = None,
+) -> None:
+    """
+    连接数据服务。
+
+    参数:
+        base_url: API 服务地址，默认使用 config.BASE_URL
+        token: 访问令牌，优先级：参数 > 环境变量 JCDATA_TOKEN > config.TOKEN
+        port: API 服务端口，优先级：参数 > 环境变量 JCDATA_PORT > config.PORT
+        timeout_sec: 请求超时时间（秒），默认使用 config.TIMEOUT_SEC
+        verify: 是否验证令牌有效性，默认使用 config.VERIFY_ON_LOGIN
+
+    示例:
+        >>> jcdata.login(token="your_token")
+        >>> jcdata.login(base_url="http://localhost", port=8000, token="your_token")
+    """
+    global _client, _user_name, _authenticated
+
+    url = _resolve_base_url(base_url)
+    key = _resolve_token(token)
+    resolved_port = _resolve_port(port)
+    to = _resolve_timeout(timeout_sec)
+    do_verify = _resolve_verify(verify)
+
+    headers = {
+        "Authorization": f"Bearer {key}",
+        "X-Api-Key": key,
+    }
+
+    if _client is not None:
+        _client.close()
+    
+    final_url = _build_base_url(url, resolved_port)
+    _client = httpx.Client(base_url=final_url, timeout=to, headers=headers)
+
+    _user_name = None
+    _authenticated = False
+    if do_verify:
+        _user_name, _authenticated = _whoami_request()
+        if not _authenticated:
+            raise PermissionError("令牌校验未通过，请检查访问令牌")
+
+
+def whoami() -> str | None:
+    """当前登录用户名；未登录或未鉴权时返回 None。"""
+    global _user_name, _authenticated
+    if _client is None:
+        return None
+    _user_name, _authenticated = _whoami_request()
+    return _user_name if _authenticated else None
+
+
+def current_user() -> str | None:
+    """最近一次 login 成功后的用户名。"""
+    return _user_name
+
+
+def _whoami_request() -> tuple[str | None, bool]:
+    r = _client.get("/api/v1/auth/whoami")  # type: ignore[union-attr]
+    if r.status_code == 401:
+        raise PermissionError("缺少令牌，请先 jcdata.login(token=...)")
+    if r.status_code == 403:
+        raise PermissionError("令牌无效或已过期")
+    r.raise_for_status()
+    body = r.json()
+    return body.get("user_name"), bool(body.get("authenticated"))
+
+
+def _client_or_raise() -> httpx.Client:
+    if _client is None:
+        raise RuntimeError("请先调用 jcdata.login()")
+    return _client
+
+
+def _parse_error_detail(r: httpx.Response) -> dict | str | None:
+    try:
+        body = r.json()
+    except Exception:
+        return None
+    detail = body.get("detail")
+    return detail if isinstance(detail, (dict, str)) else None
+
+
+def _raise_for_detail(status_code: int, detail: dict | str | None) -> None:
+    if isinstance(detail, dict) and detail.get("code") == ErrorCode.TOKEN_CELL_QUOTA_EXCEEDED:
+        raise CellQuotaExceededError(
+            str(detail.get("message") or "本周非空单元格配额已用尽"),
+            code=str(detail.get("code") or ErrorCode.TOKEN_CELL_QUOTA_EXCEEDED),
+            cell_quota=detail.get("cell_quota"),
+            cell_quota_remaining=detail.get("cell_quota_remaining"),
+        )
+    if status_code == 401:
+        raise PermissionError("未授权，请先 jcdata.login()")
+    if status_code == 403:
+        raise PermissionError("无权访问")
+    if status_code == 429 and isinstance(detail, dict):
+        raise PermissionError(str(detail.get("message") or "请求过于频繁"))
+
+
+def fetch(path: str, params: dict[str, Any]) -> pd.DataFrame:
+    """请求取数接口，返回 DataFrame。"""
+    r = _client_or_raise().get(
+        path,
+        params={k: v for k, v in params.items() if v is not None},
+    )
+    detail = _parse_error_detail(r)
+    if r.status_code in (401, 403, 429):
+        _raise_for_detail(r.status_code, detail)
+    r.raise_for_status()
+    return pd.DataFrame(r.json().get("rows") or [])

jcdata-0.1.0/config.py

@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*-
+"""
+jcdata 客户端配置。
+"""
+
+from __future__ import annotations
+
+# ==================== 服务端配置 ====================
+
+# 数据服务方发放的访问令牌
+TOKEN = ""
+
+# API 服务地址
+BASE_URL = "https://api.jicequant.com"
+
+# API 服务端口
+PORT = None
+
+# 客户端请求超时时间（秒）
+TIMEOUT_SEC = 60.0
+
+# ==================== 客户端行为配置 ====================
+
+# 是否在 login 时验证令牌有效性
+VERIFY_ON_LOGIN = True
+
+# 默认单次查询行数限制（防止误操作拉取过多数据）
+DEFAULT_ROW_LIMIT = 100000

jcdata-0.1.0/data.py

@@ -0,0 +1,352 @@
+# -*- coding: utf-8 -*-
+"""取数接口：login 后调用，返回 pandas.DataFrame。"""
+from __future__ import annotations
+
+from typing import Literal
+
+import pandas as pd
+
+from jcdata._http import fetch
+
+_DATA = "/api/v1/data"
+
+
+def _symbols(symbol: str | list[str]) -> str:
+    return symbol if isinstance(symbol, str) else ",".join(symbol)
+
+
+def _fields(fields: str | list[str] | None) -> str | None:
+    if fields is None:
+        return None
+    return fields if isinstance(fields, str) else ",".join(fields)
+
+
+def _symbol_query(
+    path: str,
+    symbol: str | list[str],
+    start_date: str,
+    end_date: str,
+    *,
+    asset_type: str | None = None,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    return fetch(
+        f"{_DATA}{path}",
+        {
+            "symbol": _symbols(symbol),
+            "start_date": start_date,
+            "end_date": end_date,
+            "asset_type": asset_type,
+            "fields": _fields(fields),
+            "row_limit": row_limit,
+        },
+    )
+
+
+def get_market_data(
+    symbol: str | list[str],
+    start_date: str,
+    end_date: str,
+    *,
+    asset_type: str | None = None,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+    dividend_type: str | None = None,
+    adjust_date: str | None = None,
+) -> pd.DataFrame:
+    """
+    日 K 线（开高低收量额）。代码示例：``600000.SH``。
+
+    ``dividend_type``：``none``/不复权、``front``/前复权、``back``/后复权、``point``/定点复权。
+    库内为未复权价；股票/ETF/可转债用 ``adj_factor`` 换算 OHLC，期货/期权始终不复权。
+    定点复权须传 ``adjust_date``；前复权默认以 ``end_date`` 为基准日。
+    """
+    return fetch(
+        f"{_DATA}/bars",
+        {
+            "symbol": _symbols(symbol),
+            "start_date": start_date,
+            "end_date": end_date,
+            "asset_type": asset_type,
+            "fields": _fields(fields),
+            "row_limit": row_limit,
+            "dividend_type": dividend_type,
+            "adjust_date": adjust_date,
+        },
+    )
+
+
+def get_instrument(
+    symbol: str | list[str],
+    start_date: str,
+    end_date: str,
+    *,
+    asset_type: str | None = None,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """证券档案：名称、板块、上市日等。"""
+    return _symbol_query(
+        "/instrument", symbol, start_date, end_date,
+        asset_type=asset_type, fields=fields, row_limit=row_limit,
+    )
+
+
+def get_price_limits(
+    symbol: str | list[str],
+    start_date: str,
+    end_date: str,
+    *,
+    asset_type: str | None = None,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """涨跌停价格。"""
+    return _symbol_query(
+        "/price_limits", symbol, start_date, end_date,
+        asset_type=asset_type, fields=fields, row_limit=row_limit,
+    )
+
+
+def get_adj_factor(
+    symbol: str | list[str],
+    start_date: str,
+    end_date: str,
+    *,
+    asset_type: str | None = None,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """复权因子。"""
+    return _symbol_query(
+        "/adj_factor", symbol, start_date, end_date,
+        asset_type=asset_type, fields=fields, row_limit=row_limit,
+    )
+
+
+def get_turn_rate(
+    symbol: str | list[str],
+    start_date: str,
+    end_date: str,
+    *,
+    asset_type: str | None = None,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """日换手率。"""
+    return _symbol_query(
+        "/turn_rate", symbol, start_date, end_date,
+        asset_type=asset_type, fields=fields, row_limit=row_limit,
+    )
+
+
+def get_trading_status(
+    symbol: str | list[str],
+    start_date: str,
+    end_date: str,
+    *,
+    asset_type: str | None = None,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """停牌、ST 等交易状态。"""
+    return _symbol_query(
+        "/trading_status", symbol, start_date, end_date,
+        asset_type=asset_type, fields=fields, row_limit=row_limit,
+    )
+
+
+def get_settlement(
+    symbol: str | list[str],
+    start_date: str,
+    end_date: str,
+    *,
+    asset_type: str | None = None,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """结算价、持仓（仅可转债、期货）。"""
+    return _symbol_query(
+        "/settlement", symbol, start_date, end_date,
+        asset_type=asset_type, fields=fields, row_limit=row_limit,
+    )
+
+
+def get_conv_bond_terms(
+    symbol: str | list[str],
+    start_date: str,
+    end_date: str,
+    *,
+    asset_type: str | None = None,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """可转债条款（仅可转债）。"""
+    return _symbol_query(
+        "/conv_bond_terms", symbol, start_date, end_date,
+        asset_type=asset_type, fields=fields, row_limit=row_limit,
+    )
+
+
+def get_future_contract(
+    symbol: str | list[str],
+    start_date: str,
+    end_date: str,
+    *,
+    asset_type: str | None = None,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """期货合约参数（仅期货）。"""
+    return _symbol_query(
+        "/future_contract", symbol, start_date, end_date,
+        asset_type=asset_type, fields=fields, row_limit=row_limit,
+    )
+
+
+def get_valuation(
+    symbol: str | list[str],
+    start_date: str,
+    end_date: str,
+    *,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """股票日度估值（市盈率、市净率等）。"""
+    return _symbol_query("/valuation", symbol, start_date, end_date, fields=fields, row_limit=row_limit)
+
+
+def get_market_value(
+    symbol: str | list[str],
+    start_date: str,
+    end_date: str,
+    *,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """股票日度市值。"""
+    return _symbol_query("/market_value", symbol, start_date, end_date, fields=fields, row_limit=row_limit)
+
+
+def get_finance(
+    symbol: str | list[str],
+    start_date: str,
+    end_date: str,
+    *,
+    kind: Literal["prime", "deriv"] = "prime",
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """股票财务指标；``kind`` 为 ``prime``（主要）或 ``deriv``（衍生）。"""
+    return fetch(
+        f"{_DATA}/finance",
+        {
+            "symbol": _symbols(symbol),
+            "start_date": start_date,
+            "end_date": end_date,
+            "kind": kind,
+            "fields": _fields(fields),
+            "row_limit": row_limit,
+        },
+    )
+
+
+def get_trade_dates(
+    start_date: str,
+    end_date: str,
+    *,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """A 股交易日历。"""
+    return fetch(
+        f"{_DATA}/trade_dates",
+        {
+            "start_date": start_date,
+            "end_date": end_date,
+            "fields": _fields(fields),
+            "row_limit": row_limit,
+        },
+    )
+
+
+def get_index_constituents(
+    index_code: str,
+    start_date: str = "1990-01-01",
+    end_date: str = "2099-12-31",
+    *,
+    trade_date: str | None = None,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """指数成分股及纳入/剔除日期。"""
+    return fetch(
+        f"{_DATA}/index_constituents",
+        {
+            "index_code": index_code,
+            "start_date": start_date,
+            "end_date": end_date,
+            "trade_date": trade_date,
+            "fields": _fields(fields),
+            "row_limit": row_limit,
+        },
+    )
+
+
+def get_option_bars(
+    symbol: str | list[str],
+    start_date: str,
+    end_date: str,
+    *,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """期权日 K。"""
+    return _symbol_query("/option_bars", symbol, start_date, end_date, fields=fields, row_limit=row_limit)
+
+
+def get_option_info(
+    underlying: str | list[str] | None = None,
+    symbol: str | list[str] | None = None,
+    start_date: str = "1990-01-01",
+    end_date: str = "2099-12-31",
+    *,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """期权合约信息；``underlying`` 与 ``symbol`` 只能传其一。"""
+    params: dict = {
+        "start_date": start_date,
+        "end_date": end_date,
+        "fields": _fields(fields),
+        "row_limit": row_limit,
+    }
+    if underlying is not None:
+        params["underlying"] = _symbols(underlying)
+    if symbol is not None:
+        params["symbol"] = _symbols(symbol)
+    return fetch(f"{_DATA}/option_info", params)
+
+
+def get_sectors(
+    start_date: str,
+    end_date: str,
+    *,
+    symbol: str | list[str] | None = None,
+    sector_name: str | None = None,
+    fields: str | list[str] | None = None,
+    row_limit: int | None = None,
+) -> pd.DataFrame:
+    """板块与成分股关系（快照；库内 ``ts`` 为写入占位，服务端按最新采集日返回）。"""
+    return fetch(
+        f"{_DATA}/sectors",
+        {
+            "start_date": start_date,
+            "end_date": end_date,
+            "symbol": _symbols(symbol) if symbol is not None else None,
+            "sector_name": sector_name,
+            "fields": _fields(fields),
+            "row_limit": row_limit,
+        },
+    )

jcdata-0.1.0/errors.py

@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*-
+
+class ErrorCode:
+    TOKEN_INVALID = "E1001"
+    TOKEN_CELL_QUOTA_EXCEEDED = "E1002"
+    RATE_LIMIT_EXCEEDED = "E1003"
+    TOKEN_MISSING = "E1004"
+
+
+class CellQuotaExceededError(PermissionError):
+    """本周非空单元格配额已用尽。"""
+
+    def __init__(
+        self,
+        message: str = "本周非空单元格配额已用尽",
+        *,
+        code: str = ErrorCode.TOKEN_CELL_QUOTA_EXCEEDED,
+        cell_quota: int | None = None,
+        cell_quota_remaining: int | None = None,
+    ) -> None:
+        super().__init__(message)
+        self.code = code
+        self.cell_quota = cell_quota
+        self.cell_quota_remaining = cell_quota_remaining
+
+
+# 兼容旧名
+RowQuotaExceededError = CellQuotaExceededError

jcdata-0.1.0/jcdata.egg-info/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: jcdata
+Version: 0.1.0
+Summary: JCDATA
+Author: JCDATA
+License: Proprietary
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24
+Requires-Dist: pandas>=1.3
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+
+# jcdata
+
+连接 JCDATA 数据服务，详情可查看官网：[https://jicequant.com/](https://jicequant.com/)
+
+用户注册后即可在个人中心使用一定额度的数据服务
+
+## 安装
+
+```bash
+pip install jcdata
+```
+
+## 配置
+
+访问令牌任选一种方式提供：
+
+```python
+import jcdata
+
+jcdata.login(token="你的访问令牌")
+```
+
+或设置环境变量后直接 `jcdata.login()`：
+
+```bash
+export JCDATA_TOKEN="你的访问令牌"
+```
+
+也可安装后编辑包内 **`jcdata/config.py`** 中的 `TOKEN`，再执行 `jcdata.login()`。
+
+## 使用
+
+```python
+import jcdata
+
+jcdata.login(token="你的访问令牌")
+print(jcdata.whoami())
+
+df = jcdata.get_market_data("600000.SH", "2025-01-01", "2025-01-31")
+```
+
+## 主要接口
+
+- **行情**：`get_market_data`
+- **基础信息**：`get_instrument`、`get_price_limits`、`get_adj_factor`、`get_turn_rate`、`get_trading_status`
+- **期货/转债**：`get_settlement`、`get_conv_bond_terms`、`get_future_contract`
+- **股票因子**：`get_valuation`、`get_market_value`、`get_finance`
+- **其它**：`get_trade_dates`、`get_index_constituents`、`get_option_bars`、`get_option_info`、`get_sectors`（板块快照，`ts` 为库内占位）
+
+代码格式为 Wind 风格，如 `600000.SH`。

jcdata-0.1.0/jcdata.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+README.md
+__init__.py
+_http.py
+config.py
+data.py
+errors.py
+pyproject.toml
+./__init__.py
+./_http.py
+./config.py
+./data.py
+./errors.py
+jcdata.egg-info/PKG-INFO
+jcdata.egg-info/SOURCES.txt
+jcdata.egg-info/dependency_links.txt
+jcdata.egg-info/requires.txt
+jcdata.egg-info/top_level.txt

jcdata-0.1.0/jcdata.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

jcdata-0.1.0/jcdata.egg-info/requires.txt

@@ -0,0 +1,5 @@
+httpx>=0.24
+pandas>=1.3
+
+[dev]
+pytest>=7

jcdata-0.1.0/jcdata.egg-info/top_level.txt

@@ -0,0 +1 @@
+jcdata

jcdata-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "jcdata"
+version = "0.1.0"
+description = "JCDATA"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "Proprietary" }
+authors = [{ name = "JCDATA" }]
+dependencies = [
+    "httpx>=0.24",
+    "pandas>=1.3",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7"]
+
+[tool.setuptools]
+package-dir = { "jcdata" = "." }
+packages = ["jcdata"]

jcdata-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+