GET /api/v1/etf/pcf

Returns Portfolio Composition File (PCF) data for ETFs, including creation/redemption basket components.

Request

GET /api/v1/etf/pcf

Headers

Header	Value
F-API-KEY	Your API key

Query Parameters

Parameter	Type	Required	Filter	Description
fund_code	string	No	exact	Fund code
trade_date	string	No	exact	Trade date (YYYY-MM-DD)
component_code	string	No	exact	Component code
source_type	string	No	exact	Source type
date_from	string	No	range	Start date
date_to	string	No	range	End date
limit	integer	No	—	Max rows per page (default 100, max 1000)
offset	integer	No	—	Rows to skip (default 0)
sort	string	No	—	Sort field (default trade_date)
order	asc | desc	No	—	Sort direction (default desc)

Example

curl -H "F-API-KEY: fk-xxxxx" \
  "https://finance-api.xp-java.workers.dev/api/v1/etf/pcf?fund_code=510300&trade_date=2024-01-02"

Response

{
  "code": 0,
  "message": "ok",
  "data": [
    {
      "fund_code": "510300",
      "trade_date": "2024-01-02",
      "effective_date": "2024-01-02",
      "component_code": "600519",
      "component_name": "贵州茅台",
      "qty_per_creation_unit": 1200,
      "market_value": 1850000,
      "weight": 5.23,
      "cash_substitution": 0,
      "substitution_flag": 1,
      "source_url": "https://...",
      "source_type": "exchange",
      "parsed_at": "2024-01-02T06:00:00Z",
      "data_quality": "high",
      "updated_at": "2024-01-02T06:00:00Z"
    }
  ],
  "meta": {
    "total": 300,
    "limit": 100,
    "offset": 0,
    "has_more": true
  }
}