GET /api/v1/etf/basic

Returns basic information for ETFs including fund code, name, category, asset class, tracking index, fund company, exchange, fees, AUM, and listing date.

Request

GET /api/v1/etf/basic

Headers

Header	Value
F-API-KEY	Your API key

Query Parameters

Parameter	Type	Required	Filter	Description
code	string	No	exact	Fund code
category	string	No	exact	Category
asset_class	string	No	exact	Asset class
exchange	string	No	exact	Exchange (SH, SZ)
name	string	No	like	Fund name (fuzzy match)
fund_company	string	No	like	Fund company (fuzzy match)
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 code)
order	asc | desc	No	—	Sort direction (default asc)

Example

curl -H "F-API-KEY: fk-xxxxx" \
  "https://finance-api.xp-java.workers.dev/api/v1/etf/basic?code=510300&limit=5"

Response

{
  "code": 0,
  "message": "ok",
  "data": [
    {
      "code": "510300",
      "name": "华泰柏瑞沪深300ETF",
      "category": "宽基指数",
      "asset_class": "Equity",
      "tracking_index": "沪深300指数",
      "tracking_index_code": "000300",
      "fund_company": "华泰柏瑞",
      "exchange": "SH",
      "management_fee": 0.005,
      "custodian_fee": 0.001,
      "total_fee": 0.006,
      "aum_billion": 120.5,
      "avg_daily_amount_million": 450.2,
      "premium_pct": -0.12,
      "latest_price": 3.856,
      "latest_nav": 3.861,
      "listing_date": "2012-05-04",
      "is_connected": 1,
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-12-31T00:00:00Z"
    }
  ],
  "meta": {
    "total": 1250,
    "limit": 5,
    "offset": 0,
    "has_more": true
  }
}