---
title: "文档检索（字段 / 口径 / 常见误用）"
method: GET
path: "/v1/wiki"
tags: ["free"]
---

# 文档检索（字段 / 口径 / 常见误用）

`GET /v1/wiki`

## Request

- Base URL: `https://api.ashareapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ashareapi.com/v1/wiki`
- Auth: none declared

⭐ **产品文档检索**：字段单位、口径说明、常见误用、跨市场差异 —— **当你（agent）不确定某字段含义/单位/口径时先查这里，比猜更准**。

**渐进加载（三步走，省 token）**：
| 调用 | 返回 | 大小 |
|---|---|---|
| `/v1/wiki`（不带参） | **目录**：slug + 标题 + 一句话 | 小 |
| `/v1/wiki?q=关键词` | **命中篇的摘要**（标题 + lead + 匹配片段），⚠️ 不含全文 | 中 |
| `/v1/wiki?slug=units` | **该篇全文**（正文 Markdown） | 单篇 |

⚠️ **不会一次性吐出全部文档**（全文合计 70KB+）—— 请先看目录、再取单篇，避免浪费你的上下文。
`lang`：`zh`（默认）/ `en`。
⚠️ 属**免费层**（无需 API Key）—— 但**每次调用仍计入用量与限流**。

## Query parameters

- `q` string: 关键词检索（如 '换手率单位' / 'code 格式'）；留空=返回目录
- `slug` string: 取某一篇全文（如 units / kline-fields）；留空=不用
- `lang` string: 语言：zh（默认）/ en

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ashareapi/apis/a-api.md) · [All operations](https://skmtc.dev/ashareapi/apis/a-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ashareapi/apis/a-api/revisions/fc57bdcb13d5?raw)