涨跌分布

统计各涨跌幅区间的股票数量分布,直观判断多空力量对比与市场情绪冷热。盘后复盘时,分布形态比单看指数涨跌更有信息量。

说明:套餐用户请把 apiKey 替换为 apiToken 调用接口。

接口地址: api.cxdy.vip/api/zdfb

返回格式: JSON

请求方式: GET

请求示例: https://api.cxdy.vip/api/zdfb?apiKey=你的apiKey

请求参数说明:

🔑 鉴权凭证(二选一,以查询参数方式随请求传入):
apiKey — 单接口购买用户的密钥,购买后在会员中心获取;
apiToken — 套餐用户的访问令牌,在会员中心生成。

返回参数说明:

名称 类型 说明
code int 状态码,200 表示请求成功
msg string 提示信息,成功时为 success
data object 业务数据,结构见下方
data.trade_date string 交易日期(Ymd 格式)
data.distribution array 涨跌分布数据
data.stats object 统计汇总数据

返回示例:

{
  "code": 200,
  "msg": "success",
  "data": {
    "trade_date": "20260716",
    "distribution": [
      {
        "range": "-10.0~-6.0",
        "count": 381,
        "percentage": 3.95
      },
      {
        "range": "-6.0~-2.0",
        "count": 2209,
        "percentage": 22.88
      },
      {
        "range": "-2.0~0.0",
        "count": 3163,
        "percentage": 32.77
      },
      {
        "range": "\u003C-10.0",
        "count": 63,
        "percentage": 0.65
      },
      {
        "range": "0.0~2.0",
        "count": 2918,
        "percentage": 30.23
      },
      {
        "range": "2.0~4.0",
        "count": 639,
        "percentage": 6.62
      },
      {
        "range": "4.0~6.0",
        "count": 143,
        "percentage": 1.48
      },
      {
        "range": "6.0~8.0",
        "count": 48,
        "percentage": 0.5
      },
      {
        "range": "8.0~10.0",
        "count": 39,
        "percentage": 0.4
      },
      {
        "range": "≥10.0",
        "count": 50,
        "percentage": 0.52
      }
    ],
    "stats": {
      "total": 9653,
      "max_count": 3163,
      "max_range": "-2.0~0.0"
    }
  }
}

错误码格式说明:

名称 类型 说明
200 int 请求成功
203 int 请求过于频繁(触发限流),请稍后再试
400 int 请求参数错误:缺少必填参数或参数格式不正确
401 int 鉴权失败:apiKey 无效、API Token 无效或已过期、付费接口未传有效凭证
403 int 拒绝访问:接口已到期请续费,或账号/IP 因违规调用被临时封禁
404 int 接口不存在或已下架;或来源 IP 不在该接口的 IP 白名单内
429 int 调用超限:免费/套餐/单接口用户的当日调用次数已达上限
500 int 服务器错误:上游数据源暂时不可用,请稍后重试

代码示例:

curl 请求示例(apiKey,单接口购买用户):
curl "https://api.cxdy.vip/api/zdfb?apiKey=你的apiKey"

curl 请求示例(apiToken,套餐用户):
curl "https://api.cxdy.vip/api/zdfb?apiToken=你的apiToken"

PHP 请求示例:
<?php
// 套餐用户请将 apiKey=你的apiKey 换成 apiToken=你的apiToken
$ch = curl_init('https://api.cxdy.vip/api/zdfb?apiKey=你的apiKey');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Python 请求示例:
import requests

url = "https://api.cxdy.vip/api/zdfb"
params = {"apiKey": "你的apiKey"} # 套餐用户将 apiKey 换成 apiToken
response = requests.get(url, params=params)
print(response.json())

请求参数设置:

参数名称 参数值
{
  "code": 200,
  "msg": "success",
  "data": {
    "trade_date": "20260716",
    "distribution": [
      {
        "range": "-10.0~-6.0",
        "count": 381,
        "percentage": 3.95
      },
      {
        "range": "-6.0~-2.0",
        "count": 2209,
        "percentage": 22.88
      },
      {
        "range": "-2.0~0.0",
        "count": 3163,
        "percentage": 32.77
      },
      {
        "range": "\u003C-10.0",
        "count": 63,
        "percentage": 0.65
      },
      {
        "range": "0.0~2.0",
        "count": 2918,
        "percentage": 30.23
      },
      {
        "range": "2.0~4.0",
        "count": 639,
        "percentage": 6.62
      },
      {
        "range": "4.0~6.0",
        "count": 143,
        "percentage": 1.48
      },
      {
        "range": "6.0~8.0",
        "count": 48,
        "percentage": 0.5
      },
      {
        "range": "8.0~10.0",
        "count": 39,
        "percentage": 0.4
      },
      {
        "range": "≥10.0",
        "count": 50,
        "percentage": 0.52
      }
    ],
    "stats": {
      "total": 9653,
      "max_count": 3163,
      "max_range": "-2.0~0.0"
    }
  }
}