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

# 批量查询标的元数据

`POST /v1/instruments`

使用 POST 方法批量查询，支持更多标的（最多 1000 个）。

## Request body

- InstrumentsRequest — 批量查询标的请求体 (POST)
  - `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)