{
  "id": "sse-bond-daily",
  "domain": "www.sse.com.cn",
  "path": "/market/bonddata/overview/day/",
  "url": "https://www.sse.com.cn/market/bonddata/overview/day/",
  "title": "债券成交概况（日度）",
  "title_en": "Bond Trading Overview — Daily",
  "summary": "上交所每日债券市场成交概况。含17个债券品种的每日成交笔数、成交面额、成交金额。",
  "data_freshness": "T+1，约 16:30 CST",
  "data_scope": "2013年至今",

  "method": "GET",
  "endpoint": "https://query.sse.com.cn/commonQuery.do",
  "headers": {
    "Referer": "https://www.sse.com.cn/market/bonddata/overview/day/"
  },
  "params": {
    "sqlId": {
      "type": "string",
      "required": true,
      "value": "COMMON_SSEBOND_SCSJ_SCTJ_CJSJ_ZQLXCJTJ_CX_L",
      "description": "固定值，不可更改"
    },
    "START_DATE": {
      "type": "string",
      "format": "YYYY-MM-DD",
      "required": true,
      "description": "查询起始日期",
      "example": "2025-03-10"
    },
    "END_DATE": {
      "type": "string",
      "format": "YYYY-MM-DD",
      "required": true,
      "description": "查询截止日期（单日查询时与 START_DATE 相同）",
      "example": "2025-03-10"
    }
  },
  "returns": {
    "location": "response.result",
    "description": "JSON 数组，17行（含合计行），每行一个债券品种",
    "items": {
      "TYPE": { "type": "string", "description": "债券品种名称" },
      "TYPE_CODE": {
        "type": "string",
        "description": "品种代码",
        "value_map": {
          "10": "记账式国债", "20": "地方政府债", "30": "金融债",
          "40": "公开发行公司债券（含企业债券）", "50": "非公开发行公司债券（含企业债券）",
          "80": "可转债", "90": "可交换债", "100": "分离债",
          "110": "企业资产支持证券", "120": "信贷资产支持证券",
          "130": "三方回购", "140": "通用质押式回购", "150": "报价回购",
          "160": "协议回购", "165": "债券借贷", "170": "其他债券", "9999": "合计"
        }
      },
      "VOLUME": { "type": "integer", "description": "成交笔数（笔）" },
      "AMOUNT": { "type": "number", "description": "成交金额（万元），÷10000=亿元" },
      "AVG_PRICE": { "type": "number", "description": "加权平均成交价（元）" },
      "TRADE_DATE": { "type": "string", "description": "成交日期 YYYY-MM-DD" }
    }
  },

  "example_call": "curl \"https://query.sse.com.cn/commonQuery.do?sqlId=COMMON_SSEBOND_SCSJ_SCTJ_CJSJ_ZQLXCJTJ_CX_L&START_DATE=2025-03-10&END_DATE=2025-03-10\" -H \"Referer: https://www.sse.com.cn/market/bonddata/overview/day/\"",
  "example_response": [
    {"TYPE": "记账式国债", "TYPE_CODE": "10", "VOLUME": "20651", "AMOUNT": "1582315.62", "AVG_PRICE": "108.192", "TRADE_DATE": "2025-03-10"},
    {"TYPE": "合计", "TYPE_CODE": "9999", "VOLUME": "6694960", "AMOUNT": "236109648.86", "AVG_PRICE": "100.031", "TRADE_DATE": "2025-03-10"}
  ],

  "page_internals": {
    "date_selector": ".js_date input",
    "js_controller": "overviewDay",
    "query_trigger": "overviewDay.setOverviewDayParams()",
    "description": "页面默认显示最新交易日。日期选择器使用 laydate 组件绑定到 .js_date input。设置日期后调用 setOverviewDayParams() 会读取输入框值、更新参数、发起 AJAX 查询。"
  },

  "page_table": {
    "description": "页面上用户看到的表格结构。制作 table 类型证据时，row_anchor 和 col_anchor 必须使用这里的原始文本。",
    "headers": ["类型", "成交笔数", "成交金额(万元)", "加权平均价格"],
    "row_identifier": "类型",
    "api_to_header": {
      "TYPE": "类型",
      "VOLUME": "成交笔数",
      "AMOUNT": "成交金额(万元)",
      "AVG_PRICE": "加权平均价格"
    }
  },

  "action_steps_template": {
    "description": "在浏览器中回放到指定日期的操作步骤。将 {{date}} 替换为 YYYY-MM-DD 格式的目标日期。",
    "steps": [
      {"type": "exec_js", "code": "document.querySelector('.js_date input').value = '{{date}}'", "wait": 0},
      {"type": "exec_js", "code": "overviewDay.setOverviewDayParams()", "wait": 3000}
    ],
    "example": [
      {"type": "exec_js", "code": "document.querySelector('.js_date input').value = '2025-03-10'", "wait": 0},
      {"type": "exec_js", "code": "overviewDay.setOverviewDayParams()", "wait": 3000}
    ]
  },

  "failure_modes": [
    { "condition": "非交易日", "behavior": "返回17行全零数据", "detection": "合计行 VOLUME=0" },
    { "condition": "海外 IP", "behavior": "HTTP 403", "mitigation": "使用中国境内代理" },
    { "condition": "sqlId 失效", "recovery": "GET /xhtml/home/2021public/querySearch/search_bondData_2021.js → 搜索 overviewDayParams.sqlId" }
  ],
  "caveats": [
    "接口标注 POST 但 GET 即可",
    "成交金额单位万元，非亿元"
  ],

  "neighbors": ["sse-bond-weekly", "sse-bond-monthly", "sse-bond-yearly"],
  "confidence": 0.97,
  "verified_date": "2025-03-10",
  "last_verified": "2026-03-10"
}