quantsonar-com

quantsonar-com ETF API

The ETF API from quantsonar-com — 7 operation(s) for etf.

GitHub OpenAPI

Operations 7

GET /v1/etf/basic ETF 基础信息 #
GET /v1/etf/daily ETF 日线行情 #
GET /v1/etf/adj-factor ETF 复权因子 #
GET /v1/etf/nav ETF 净值 #
GET /v1/etf/portfolio ETF 持仓明细 #
GET /v1/etf/share-size ETF 份额与规模 #
GET /v1/etf/tracking-indices ETF 跟踪指数基础信息 #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/quantsonar-com/openapi/quantsonar-com-etf-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/quantsonar-com:quantsonar-com-etf-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

quantsonar-com-etf-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: QuantSonar Agent Data ETF API
  description: Agent-native financial data and tools. Authenticate with X-API-Key.
  version: v1
servers:
- url: https://quantsonar.com
tags:
- name: ETF
paths:
  /v1/etf/basic:
    get:
      tags:
      - ETF
      summary: ETF 基础信息
      operationId: handler_v1_etf_basic_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: symbol
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 代码原样匹配（ETF/板块/外汇/港股等）
          title: Symbol
          example: 510300.SH
        description: 代码原样匹配（ETF/板块/外汇/港股等）
      - name: exchange
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 交易所：SSE 上交所 / SZSE 深交所
          title: Exchange
          example: SSE
        description: 交易所：SSE 上交所 / SZSE 深交所
      - name: list_status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 上市状态：L 上市 / D 退市 / P 暂停上市
          title: List Status
        description: 上市状态：L 上市 / D 退市 / P 暂停上市
      - name: etf_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: ETF 类型，如境内、QDII
          title: Etf Type
        description: ETF 类型，如境内、QDII
      - name: index_code
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 跟踪指数代码（带后缀）
          title: Index Code
        description: 跟踪指数代码（带后缀）
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    symbol:
                      description: ETF代码
                    csname:
                      description: ETF中文简称
                    extname:
                      description: ETF扩位简称
                    cname:
                      description: 基金中文全称
                    index_code:
                      description: 跟踪指数代码
                    index_name:
                      description: 跟踪指数名称
                    setup_date:
                      description: 设立日期
                    list_date:
                      description: 上市日期
                    list_status:
                      description: L上市/D退市/P待上市
                    exchange:
                      description: SH/SZ
                    mgr_name:
                      description: 基金管理人
                    custod_name:
                      description: 基金托管人
                    mgt_fee:
                      description: 管理费率
                    etf_type:
                      description: 境内/QDII等类型
                  additionalProperties: true
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      description: ''
      x-quantsonar-minimum-plan: free
      x-quantsonar-response-fields:
      - symbol
      - csname
      - extname
      - cname
      - index_code
      - index_name
      - setup_date
      - list_date
      - list_status
      - exchange
      - mgr_name
      - custod_name
      - mgt_fee
      - etf_type
  /v1/etf/daily:
    get:
      tags:
      - ETF
      summary: ETF 日线行情
      operationId: handler_v1_etf_daily_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: symbol
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 代码原样匹配（ETF/板块/外汇/港股等）
          title: Symbol
          example: 510300.SH
        description: 代码原样匹配（ETF/板块/外汇/港股等）
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 起始日期 YYYYMMDD
          title: Start Date
          example: '20260101'
        description: 起始日期 YYYYMMDD
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 结束日期 YYYYMMDD
          title: End Date
          example: '20261231'
        description: 结束日期 YYYYMMDD
      - name: trade_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 单个交易日 YYYYMMDD（与 start/end 二选一）
          title: Trade Date
          example: '20260710'
        description: 单个交易日 YYYYMMDD（与 start/end 二选一）
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    symbol:
                      description: ETF代码
                    trade_date:
                      description: 交易日期
                    pre_close:
                      description: 昨收价
                    open:
                      description: 开盘价
                    high:
                      description: 最高价
                    low:
                      description: 最低价
                    close:
                      description: 收盘价
                    change:
                      description: 涨跌额
                    pct_chg:
                      description: 涨跌幅（%）
                    vol:
                      description: 成交量(手)
                    amount:
                      description: 成交额(千元)
                  additionalProperties: true
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      description: ''
      x-quantsonar-minimum-plan: free
      x-quantsonar-response-fields:
      - symbol
      - trade_date
      - pre_close
      - open
      - high
      - low
      - close
      - change
      - pct_chg
      - vol
      - amount
  /v1/etf/adj-factor:
    get:
      tags:
      - ETF
      summary: ETF 复权因子
      operationId: handler_v1_etf_adj_factor_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: symbol
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 代码原样匹配（ETF/板块/外汇/港股等）
          title: Symbol
          example: 510300.SH
        description: 代码原样匹配（ETF/板块/外汇/港股等）
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 起始日期 YYYYMMDD
          title: Start Date
          example: '20260101'
        description: 起始日期 YYYYMMDD
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 结束日期 YYYYMMDD
          title: End Date
          example: '20261231'
        description: 结束日期 YYYYMMDD
      - name: trade_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 单个交易日 YYYYMMDD（与 start/end 二选一）
          title: Trade Date
          example: '20260710'
        description: 单个交易日 YYYYMMDD（与 start/end 二选一）
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    symbol:
                      description: ETF代码
                    trade_date:
                      description: 交易日期
                    adj_factor:
                      description: 复权因子
                  additionalProperties: true
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      description: ''
      x-quantsonar-minimum-plan: free
      x-quantsonar-response-fields:
      - symbol
      - trade_date
      - adj_factor
  /v1/etf/nav:
    get:
      tags:
      - ETF
      summary: ETF 净值
      operationId: handler_v1_etf_nav_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: symbol
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 代码原样匹配（ETF/板块/外汇/港股等）
          title: Symbol
          example: 510300.SH
        description: 代码原样匹配（ETF/板块/外汇/港股等）
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 起始日期 YYYYMMDD
          title: Start Date
          example: '20260101'
        description: 起始日期 YYYYMMDD
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 结束日期 YYYYMMDD
          title: End Date
          example: '20261231'
        description: 结束日期 YYYYMMDD
      - name: ann_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 公告日期 YYYYMMDD
          title: Ann Date
          example: '20260710'
        description: 公告日期 YYYYMMDD
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    symbol:
                      description: ETF代码
                    ann_date:
                      description: 公告日期
                    nav_date:
                      description: 净值日期
                    unit_nav:
                      description: 单位净值
                    accum_nav:
                      description: 累计净值
                    accum_div:
                      description: 累计分红
                    net_asset:
                      description: 资产净值
                    total_netasset:
                      description: 合计资产净值
                    adj_nav:
                      description: 复权单位净值
                    update_flag:
                      description: 更新标志
                  additionalProperties: true
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      description: ''
      x-quantsonar-minimum-plan: pro
      x-quantsonar-response-fields:
      - symbol
      - ann_date
      - nav_date
      - unit_nav
      - accum_nav
      - accum_div
      - net_asset
      - total_netasset
      - adj_nav
      - update_flag
  /v1/etf/portfolio:
    get:
      tags:
      - ETF
      summary: ETF 持仓明细
      operationId: handler_v1_etf_portfolio_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: symbol
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 代码原样匹配（ETF/板块/外汇/港股等）
          title: Symbol
          example: 510300.SH
        description: 代码原样匹配（ETF/板块/外汇/港股等）
      - name: con_symbol
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 成分证券代码（带后缀），如 000001.SZ
          title: Con Symbol
          example: 600519.SH
        description: 成分证券代码（带后缀），如 000001.SZ
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 起始日期 YYYYMMDD
          title: Start Date
          example: '20260101'
        description: 起始日期 YYYYMMDD
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 结束日期 YYYYMMDD
          title: End Date
          example: '20261231'
        description: 结束日期 YYYYMMDD
      - name: ann_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 公告日期 YYYYMMDD
          title: Ann Date
          example: '20260710'
        description: 公告日期 YYYYMMDD
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    symbol:
                      description: ETF代码
                    ann_date:
                      description: 公告日期
                    end_date:
                      description: 报告期
                    con_symbol:
                      description: 持仓证券代码
                    mkv:
                      description: 持仓市值(元)
                    amount:
                      description: 持仓数量(股)
                    stk_mkv_ratio:
                      description: 占股票市值比
                    stk_float_ratio:
                      description: 占流通股本比例
                  additionalProperties: true
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      description: ''
      x-quantsonar-minimum-plan: pro
      x-quantsonar-response-fields:
      - symbol
      - ann_date
      - end_date
      - con_symbol
      - mkv
      - amount
      - stk_mkv_ratio
      - stk_float_ratio
  /v1/etf/share-size:
    get:
      tags:
      - ETF
      summary: ETF 份额与规模
      operationId: handler_v1_etf_share_size_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: symbol
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 代码原样匹配（ETF/板块/外汇/港股等）
          title: Symbol
          example: 510300.SH
        description: 代码原样匹配（ETF/板块/外汇/港股等）
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 起始日期 YYYYMMDD
          title: Start Date
          example: '20260101'
        description: 起始日期 YYYYMMDD
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 结束日期 YYYYMMDD
          title: End Date
          example: '20261231'
        description: 结束日期 YYYYMMDD
      - name: trade_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 单个交易日 YYYYMMDD（与 start/end 二选一）
          title: Trade Date
          example: '20260710'
        description: 单个交易日 YYYYMMDD（与 start/end 二选一）
      - name: exchange
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 交易所：SSE 上交所 / SZSE 深交所
          title: Exchange
          example: SSE
        description: 交易所：SSE 上交所 / SZSE 深交所
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    trade_date:
                      description: 交易日期
                    symbol:
                      description: ETF代码
                    etf_name:
                      description: 基金名称
                    total_share:
                      description: 总份额(万份)
                    total_size:
                      description: 总规模(万元)
                    nav:
                      description: 份额净值
                    close:
                      description: 收盘价
                    exchange:
                      description: SSE/SZSE/BSE
                  additionalProperties: true
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      description: ''
      x-quantsonar-minimum-plan: pro
      x-quantsonar-response-fields:
      - trade_date
      - symbol
      - etf_name
      - total_share
      - total_size
      - nav
      - close
      - exchange
  /v1/etf/tracking-indices:
    get:
      tags:
      - ETF
      summary: ETF 跟踪指数基础信息
      operationId: handler_v1_etf_tracking_indices_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: symbol
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 代码原样匹配（ETF/板块/外汇/港股等）
          title: Symbol
          example: 000300.SH
        description: 代码原样匹配（ETF/板块/外汇/港股等）
      - name: start_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 起始日期 YYYYMMDD
          title: Start Date
          example: '20260101'
        description: 起始日期 YYYYMMDD
      - name: end_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 结束日期 YYYYMMDD
          title: End Date
          example: '20261231'
        description: 结束日期 YYYYMMDD
      - name: pub_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 发布日期 YYYYMMDD
          title: Pub Date
          example: '20260710'
        description: 发布日期 YYYYMMDD
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    symbol:
                      description: 指数代码
                    indx_name:
                      description: 指数全称
                    indx_csname:
                      description: 指数简称
                    pub_party_name:
                      description: 发布机构
                    pub_date:
                      description: 发布日期
                    base_date:
                      description: 基日
                    bp:
                      description: 基点
                    adj_circle:
                      description: 成分调整周期
                  additionalProperties: true
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      description: ''
      x-quantsonar-minimum-plan: pro
      x-quantsonar-response-fields:
      - symbol
      - indx_name
      - indx_csname
      - pub_party_name
      - pub_date
      - base_date
      - bp
      - adj_circle
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
x-agent-interfaces:
  mcp: https://quantsonar.com/mcp/
  mcp_manifest: https://quantsonar.com/server.json
  capabilities: https://quantsonar.com/capabilities
  llms: https://quantsonar.com/llms.txt