Skip to main content
Fund Data API

Portfolio look-through

/v1/fund-portfolio-xrayInstitutional

Pass fund codes and weights and the whole basket is looked through to the stock level: each stock's combined weight, which funds contributed it, and what share of NAV is covered. Institutional and above.

Answers: This basket of funds — what stocks does it actually hold, and how much of each?

Request parameters

ParameterRequiredTypeDefaultDescription
codes✅string—Fund codes, comma separated, e.g. 110022,009265
weights✅string—Weights aligned one-to-one with codes, comma separated, e.g. 0.6,0.4 (60,40 also accepted)

Response fields

FieldTypeDescription
funds[]arrayFunds used in the calculation: code / weight
report_periodstringReporting period
coveragestringCoverage scope, top10
stock_countintNumber of stocks after look-through
covered_weight_pctnumberHow much fund NAV the look-through covers (%)
stocks[]arrayPer-stock detail, see below
stocks[].code / namestringStock code / name
stocks[].xray_weight_pctnumberThis stock's combined weight in your whole portfolio (%)
stocks[].fund_countintHow many of the funds hold it
stocks[].via[]arraySource breakdown: code / weight / nav_ratio / contrib_pct (how much that fund contributed)

Real response sample

Captured live using 110022. List fields are shortened for readability (the real response is longer); elapsed_ms is from that one call — the first request usually takes 1–3 seconds.

{
  "ok": true,
  "endpoint": "fund-portfolio-xray",
  "tier": "institutional",
  "elapsed_ms": 13271,
  "data": {
    "funds": [
      {
        "code": "110022",
        "weight": 0.6
      },
      {
        "code": "009265",
        "weight": 0.4
      }
    ],
    "report_period": [
      "2026年3季度"
    ],
    "coverage": "top10",
    "stock_count": 14,
    "covered_weight_pct": 68.602,
    "stocks": [
      {
        "code": "600519",
        "name": "贵州茅台",
        "xray_weight_pct": 9.904,
        "via": [
          {
            "code": "110022",
            "weight": 0.6,
            "nav_ratio": "9.96%",
            "contrib_pct": 5.976
          },
          {
            "code": "009265",
            "weight": 0.4,
            "nav_ratio": "9.82%",
            "contrib_pct": 3.928
          }
        ],
        "fund_count": 2
      },
      {
        "code": "000333",
        "name": "美的集团",
        "xray_weight_pct": 8.048,
        "via": [
          {
            "code": "110022",
            "weight": 0.6,
            "nav_ratio": "9.48%",
            "contrib_pct": 5.688
          },
          {
            "code": "009265",
            "weight": 0.4,
            "nav_ratio": "5.90%",
            "contrib_pct": 2.36
          }
        ],
        "fund_count": 2
      },
      {
        "code": "600809",
        "name": "山西汾酒",
        "xray_weight_pct": 7.004,
        "via": [
          {
            "code": "110022",
            "weight": 0.6,
            "nav_ratio": "8.62%",
            "contrib_pct": 5.172
          },
          {
            "code": "009265",
            "weight": 0.4,
            "nav_ratio": "4.58%",
            "contrib_pct": 1.832
          }
        ],
        "fund_count": 2
      }
    ],
    "method": "fund_weight * nav_ratio,基于季报前 10 大重仓股",
    "note": "⚠️ 这是**计算值**,不是数据源的原始数据。`covered_weight_pct` 只覆盖前 10 大重仓股,⛔ 不等于组合总仓位;季报之外的持仓(第 11 名及以后)不在计算范围内。"
  }
}

Example call

curl "https://api.fundapi.cn/v1/fund-portfolio-xray?code=110022" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "User-Agent: your-app"

Notes

`covered_weight_pct` below 100 is normal

Only the top 10 holdings are looked through, so the remainder of the portfolio is not included. The sample portfolio covers 68.6%. Never normalise to 100%.

`xray_weight_pct` is already portfolio-level

It equals fund weight × that stock's share of the fund NAV, summed across funds. Use the number as-is; do not multiply by the weight again.