STATIC API DOCUMENT

证券行业法律法规语义检索接口 API 文档

按自然语言query做证券行业相关法条级语义检索,可按时效性、一级效力级别和实施日期范围过滤。返回结果在extra.fatiao,每条主要是法条内容及所属法规信息,不是整部法规全文列表;如需法规详情需再用法规 ID 调详情接口。

接口详情页 分类:证券合规 MCP Tool:yuandian_law_vector_zq_search

接口概览

接口名称证券行业法律法规语义检索接口
接口描述按自然语言query做证券行业相关法条级语义检索,可按时效性、一级效力级别和实施日期范围过滤。返回结果在extra.fatiao,每条主要是法条内容及所属法规信息,不是整部法规全文列表;如需法规详情需再用法规 ID 调详情接口。
接口分类证券合规
调用地址https://open.chineselaw.com/open/law_vector_zq_search
请求方式POST

请求参数

3. 请求参数(Body)

3.1 字段说明

字段名 类型 是否必填 说明
query string 待检索问题 / 查询文本
rewrite_flag boolean 是否对查询做改写,默认为true
fatiao_filter object 法律法规检索过滤条件,详细内容见字段说明
return_num int 返回法律法规数量(默认为45,最大不超过检索回的法律法规总数)

3.1.1 fatiao_filter字段说明

以下字段均为可选字段

字段名 类型 是否必填 说明
sxx string[] 时效性,见下表「时效性类别」
effect1 string[] 一级效力级别,见下表「一级效力级别类别」
law_start string 过滤实施日期在此时间之后,含当前日期,YYYY-MM-DD
law_end string 过滤实施日期在此时间之前,含当前日期,YYYY-MM-DD

3.1.2 时效性类别(sxx

时效性类别
现行有效
失效
已被修改
部分失效
尚未生效

3.1.3 一级效力级别类别(effect1

一级效力级别类别
宪法
法律
司法解释
行政法规
监察法规
部门规章
党内法规
军事法规规章
立法机关工作文件
行政机关工作文件
行业/团体规范
地方性法规
自治条例和单行条例
地方司法文件
地方政府规章
地方规范性文件
地方律协规定

响应参数

4. 返回信息

- 返回类型:JSON 字符串

- 成功/失败判断:看 msgcode(HTTP 401为鉴权失败

- code说明

code 说明
201 接口调用成功
401 鉴权失败

4.1 通用返回结构

字段名 类型 说明
msg string 返回状态说明
code int 非 200/201 均为异常情形
extra object 检索到的数据结果,只需要取fatiao字段值,其他字段值为其他数据源结果(为空list)

4.2 **extra对象的fatiao**字段,包含

字段名 类型 说明
ftid string 法条id
fgid string 法规id
fgtitle string[] 法规名称
num string 法条条目
content string 内容
type string 内容类型(1-法条、2-法规、3-题注)
sxx string 时效性
effect1 string 一级效力级别
effect2 string 二级效力级别
dy string 地域
location string 地域含市
start int 实施日期
end int 失效日期
score float 相似度评分

错误码

错误码说明
401鉴权失败

调用示例

CURL

curl --location --request POST 'https://open.chineselaw.com/open/law_vector_zq_search' \
--header 'X-API-Key: 你的api_key' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'Accept: application/json' \
--data-raw '{"query":"内幕交易","rewrite_flag":false,"fatiao_filter":{"effect1":["法律"],"sxx":["现行有效"]},"return_num":2}'

JAVA

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

class CaseVectorSearchExample {

    static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "https://open.chineselaw.com/open/law_vector_zq_search";
        String body = "{\"query\":\"内幕交易\",\"rewrite_flag\":false,\"fatiao_filter\":"
                + "{\"effect1\":[\"法律\"],"
                + "\"sxx\":[\"现行有效\"]},\"return_num\":2}";

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .timeout(Duration.ofSeconds(60))
                .header("X-API-Key", apiKey)
                .header("Content-Type", "application/json; charset=utf-8")
                .header("Accept", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(body))
                .build();

        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

PYTHON

import requests

url = "https://open.chineselaw.com/open/law_vector_zq_search"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
}
payload = {
    "query": "内幕交易",
    "rewrite_flag": False,
    "fatiao_filter": {
        "effect1": ["法律"],
        "sxx": ["现行有效"],
    },
    "return_num": 2,
}

response = requests.post(url, json=payload, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

JAVASCRIPT

const API_KEY = "你的api_key";
const url = "https://open.chineselaw.com/open/law_vector_zq_search";

const res = await fetch(url, {
  method: "POST",
  headers: {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
  },
  body: JSON.stringify({
    query: "内幕交易",
    rewrite_flag: false,
    fatiao_filter: {
      effect1: ["法律"],
      sxx: ["现行有效"],
    },
    return_num: 2,
  }),
});

if (!res.ok) throw new Error(`HTTP NULL`);
console.log(await res.json());

MCP Tool 名称

MCP Serveryuandian-securities(证券合规 Server)
Streamable HTTP 入口https://open.chineselaw.com/mcp/securities/stream
MCP Toolyuandian_law_vector_zq_search

响应示例

{
    "msg": "成功(返回结构化数据)",
    "code": 201,
    "answer": "",
    "extra": {
        "fatiao": [
            {
                "url": "https://ydzk.chineselaw.com/zxt/statuteDetail/detailPage/f74ea8ee4b09a918a3dea5c7d151514b?text=14",
                "ftid": "f74ea8ee4b09a918a3dea5c7d151514b_14",
                "fgid": "f74ea8ee4b09a918a3dea5c7d151514b",
                "fgtitle": "中华人民共和国期货和衍生品法",
                "num": "第十四条",
                "content": " 本法所称内幕信息,是指可能对期货交易或者衍生品交易的交易价格产生重大影响的尚未公开的信息。 \n期货交易的内幕信息包括: \n(一)国务院期货监督管理机构以及其他相关部门正在制定或者尚未发布的对期货交易价格可能产生重大影响的政策、信息或者数据; \n(二)期货交易场所、期货结算机构作出的可能对期货交易价格产生重大影响的决定; \n(三)期货交易场所会员、交易者的资金和交易动向; \n(四)相关市场中的重大异常交易信息; \n(五)国务院期货监督管理机构规定的对期货交易价格有重大影响的其他信息。",
                "sxx": "现行有效",
                "effect1": "法律",
                "tag": [
                    "证券行业法规"
                ],
                "effect2": "法律",
                "location": "中央",
                "start": 20220801,
                "end": 99999999,
                "dy": "中央",
                "score": 1.1926545599999998,
                "type": 1
            },
            {
                "url": "https://ydzk.chineselaw.com/zxt/statuteDetail/detailPage/f60152fce037dbb27c49045cb502bde7?text=52",
                "ftid": "f60152fce037dbb27c49045cb502bde7_52",
                "fgid": "f60152fce037dbb27c49045cb502bde7",
                "fgtitle": "中华人民共和国证券法(2019修订)",
                "num": "第五十二条",
                "content": " 证券交易活动中,涉及发行人的经营、财务或者对该发行人证券的市场价格有重大影响的尚未公开的信息,为内幕信息。 \n本法第八十条第二款、第八十一条第二款所列重大事件属于内幕信息。",
                "sxx": "现行有效",
                "effect1": "法律",
                "tag": [
                    "财税##金融证券法规##证券法规",
                    "财税##金融证券法规",
                    "财税##其他法律法规##其他法律",
                    "企业法##证券、债券",
                    "财税##金融证券法规##证券法规##证监会",
                    "财税##其他法律法规",
                    "财税",
                    "企业法",
                    "证券行业法规",
                    "上市公司法",
                    "上市公司法##上市公司"
                ],
                "effect2": "法律",
                "location": "中央",
                "start": 20200301,
                "end": 99999999,
                "dy": "中央",
                "score": 1.1910819,
                "type": 1
            }
        ]
    },
    "messageId": "",
    "style": "",
    "request_id": ""
}

完整文档

1. 基本信息

- 接口名称:证券行业法律法规语义检索接口

- 接口用途:按自然语言query做证券行业相关法条级语义检索,可按时效性、一级效力级别和实施日期范围过滤。返回结果在extra.fatiao,每条主要是法条内容及所属法规信息,不是整部法规全文列表;如需法规详情需再用法规 ID 调详情接口。

2. 请求信息

- HTTP Method:POST

- URLhttps://open.chineselaw.com/open/law_vector_zq_search

- Content-Typeapplication/json; charset=utf-8

- X-API-Key:你的api_key

- 请求体:JSON

3. 请求参数(Body)

3.1 字段说明

字段名 类型 是否必填 说明
query string 待检索问题 / 查询文本
rewrite_flag boolean 是否对查询做改写,默认为true
fatiao_filter object 法律法规检索过滤条件,详细内容见字段说明
return_num int 返回法律法规数量(默认为45,最大不超过检索回的法律法规总数)

3.1.1 fatiao_filter字段说明

> 以下字段均为可选字段

字段名 类型 是否必填 说明
sxx string[] 时效性,见下表「时效性类别」
effect1 string[] 一级效力级别,见下表「一级效力级别类别」
law_start string 法条生效起始日期,YYYY-MM-DD
law_end string 法条生效结束日期,YYYY-MM-DD

3.1.2 时效性类别(sxx

时效性类别
现行有效
失效
已被修改
部分失效
尚未生效

3.1.3 一级效力级别类别(effect1

一级效力级别类别
宪法
法律
司法解释
行政法规
监察法规
部门规章
党内法规
军事法规规章
立法机关工作文件
行政机关工作文件
行业/团体规范
地方性法规
自治条例和单行条例
地方司法文件
地方政府规章
地方规范性文件
地方律协规定

4. 返回信息

- 返回类型:JSON 字符串

- 成功/失败判断:看 msgcode(HTTP 401为鉴权失败

- code说明

code 说明
201 接口调用成功
401 鉴权失败

4.1 通用返回结构

字段名 类型 说明
msg string 返回状态说明
code int 非 200/201 均为异常情形
extra object 检索到的数据结果,只需要取fatiao字段值,其他字段值为其他数据源结果(为空list)

4.2 **extra对象的fatiao**字段,包含

字段名 类型 说明
ftid string 法条id
fgid string 法规id
fgtitle string[] 法规名称
num string 法条条目
content string 内容
type string 内容类型(1-法条、2-法规、3-题注)
sxx string 时效性
effect1 string 一级效力级别
effect2 string 二级效力级别
dy string 地域
location string 地域含市
start int 实施日期
end int 失效日期
score float 相似度评分

5. 示例

5.1 请求示例

{
    "query": "内幕交易",
    "rewrite_flag": false,
    "fatiao_filter": {
        "effect1": ["法律"],
        "sxx": ["现行有效"]
    },
    "return_num": 2
}

5.2 成功响应示例

{
    "msg": "成功(返回结构化数据)",
    "code": 201,
    "answer": "",
    "extra": {
        "fatiao": [
            {
                "url": "https://ydzk.chineselaw.com/zxt/statuteDetail/detailPage/f74ea8ee4b09a918a3dea5c7d151514b?text=14",
                "ftid": "f74ea8ee4b09a918a3dea5c7d151514b_14",
                "fgid": "f74ea8ee4b09a918a3dea5c7d151514b",
                "fgtitle": "中华人民共和国期货和衍生品法",
                "num": "第十四条",
                "content": " 本法所称内幕信息,是指可能对期货交易或者衍生品交易的交易价格产生重大影响的尚未公开的信息。 \n期货交易的内幕信息包括: \n(一)国务院期货监督管理机构以及其他相关部门正在制定或者尚未发布的对期货交易价格可能产生重大影响的政策、信息或者数据; \n(二)期货交易场所、期货结算机构作出的可能对期货交易价格产生重大影响的决定; \n(三)期货交易场所会员、交易者的资金和交易动向; \n(四)相关市场中的重大异常交易信息; \n(五)国务院期货监督管理机构规定的对期货交易价格有重大影响的其他信息。",
                "sxx": "现行有效",
                "effect1": "法律",
                "tag": [
                    "证券行业法规"
                ],
                "effect2": "法律",
                "location": "中央",
                "start": 20220801,
                "end": 99999999,
                "dy": "中央",
                "score": 1.1926545599999998,
                "type": 1
            },
            {
                "url": "https://ydzk.chineselaw.com/zxt/statuteDetail/detailPage/f60152fce037dbb27c49045cb502bde7?text=52",
                "ftid": "f60152fce037dbb27c49045cb502bde7_52",
                "fgid": "f60152fce037dbb27c49045cb502bde7",
                "fgtitle": "中华人民共和国证券法(2019修订)",
                "num": "第五十二条",
                "content": " 证券交易活动中,涉及发行人的经营、财务或者对该发行人证券的市场价格有重大影响的尚未公开的信息,为内幕信息。 \n本法第八十条第二款、第八十一条第二款所列重大事件属于内幕信息。",
                "sxx": "现行有效",
                "effect1": "法律",
                "tag": [
                    "财税##金融证券法规##证券法规",
                    "财税##金融证券法规",
                    "财税##其他法律法规##其他法律",
                    "企业法##证券、债券",
                    "财税##金融证券法规##证券法规##证监会",
                    "财税##其他法律法规",
                    "财税",
                    "企业法",
                    "证券行业法规",
                    "上市公司法",
                    "上市公司法##上市公司"
                ],
                "effect2": "法律",
                "location": "中央",
                "start": 20200301,
                "end": 99999999,
                "dy": "中央",
                "score": 1.1910819,
                "type": 1
            }
        ]
    },
    "messageId": "",
    "style": "",
    "request_id": ""
}

6. 代码示例

6.1 CURL

curl --location --request POST 'https://open.chineselaw.com/open/law_vector_zq_search' \
--header 'X-API-Key: 你的api_key' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'Accept: application/json' \
--data-raw '{"query":"内幕交易","rewrite_flag":false,"fatiao_filter":{"effect1":["法律"],"sxx":["现行有效"]},"return_num":2}'

6.2 Python

import requests

url = "https://open.chineselaw.com/open/law_vector_zq_search"
API_KEY = "你的api_key"
headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
}
payload = {
    "query": "内幕交易",
    "rewrite_flag": False,
    "fatiao_filter": {
        "effect1": ["法律"],
        "sxx": ["现行有效"],
    },
    "return_num": 2,
}

response = requests.post(url, json=payload, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

6.3 Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

class CaseVectorSearchExample {

    static void main(String[] args) throws Exception {
        String apiKey = "你的api_key";
        String url = "https://open.chineselaw.com/open/law_vector_zq_search";
        String body = "{\"query\":\"内幕交易\",\"rewrite_flag\":false,\"fatiao_filter\":"
                + "{\"effect1\":[\"法律\"],"
                + "\"sxx\":[\"现行有效\"]},\"return_num\":2}";

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .timeout(Duration.ofSeconds(60))
                .header("X-API-Key", apiKey)
                .header("Content-Type", "application/json; charset=utf-8")
                .header("Accept", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(body))
                .build();

        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

6.4 JavaScript

const API_KEY = "你的api_key";
const url = "https://open.chineselaw.com/open/law_vector_zq_search";

const res = await fetch(url, {
  method: "POST",
  headers: {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
  },
  body: JSON.stringify({
    query: "内幕交易",
    rewrite_flag: false,
    fatiao_filter: {
      effect1: ["法律"],
      sxx: ["现行有效"],
    },
    return_num: 2,
  }),
});

if (!res.ok) throw new Error(`HTTP NULL`);
console.log(await res.json());