---
title: "查询标的元数据"
method: GET
path: "/v1/instruments"
tags: ["标的"]
---

# 查询标的元数据

`GET /v1/instruments`

根据标的代码获取元数据，包括名称、交易所、类型等信息。
使用 GET 方法时通过 URL 参数传递标的代码。

## Query parameters

- `symbols` string, required

## Response `200`

查询成功

- InstrumentsResponse — 标的元数据响应
  - `data` Instrument[], required — 标的元数据列表
    - `code` string, required — 交易所内代码 (如 "600000", "AAPL")
    - `exchange` string, required — 交易所代码 (如 "SH", "SZ", "US")
    - `ext` union — 市场特定元数据扩展 `type` 标签值与 [`MarketType`] 一一对应。
      - object — 中国 A 股扩展
        - `float_shares` number, double, nullable — 流通股本（股）
        - `limit_down` number, double, nullable — 跌停价（每交易日更新）
        - `limit_up` number, double, nullable — 涨停价（每交易日更新）
        - `listing_date` string, nullable — 上市日期
        - `name_en` string, nullable — 英文名
        - `tick_size` number, double, nullable — 最小变动价位
        - `total_shares` number, double, nullable — 总股本（股）
        - `type` 'cn_equity', required
      - object — 美国股票扩展
        - `float_shares` number, double, nullable — 流通股本（股）
        - `total_shares` number, double, nullable — 总股本（股）
        - `type` 'us_equity', required
      - object — 香港股票扩展
        - `float_shares` number, double, nullable — 流通股本（股）
        - `lot_size` integer, nullable — 每手股数
        - `total_shares` number, double, nullable — 总股本（股）
        - `type` 'hk_equity', required
    - `name` string, nullable — 标的名称
    - `region` string, required — 所属地区 (CN, US, HK)
    - `symbol` string, required — 标的代码 (如 "600000.SH", "AAPL.US")
    - `type` 'stock' | 'etf' | 'index' | 'bond' | 'fund' | 'options' | 'other' — 标的类型

## Other responses

- `400` — 参数错误
- `401` — 认证失败

---

[API](https://skmtc.dev/tickflow/apis/tickflow-api.md) · [All operations](https://skmtc.dev/tickflow/apis/tickflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tickflow/tickflow-api/revisions/13831df8eba1/schema)