金融问答API

一：产品说明

文因金融问答API是一款能够帮助您快速构建功能丰富、交互性强的金融问答机器人，目前提供公司、人物和行业等多个维度的基本信息查询，数据来源包括公开发布的上市公司公告、研报和新闻。

二：授权说明

• 阿里云市场授权：本授权适合于在阿里云市场有账号的用户，在阿里云市场购买产品即可获得授权。推荐使用阿里云调用API。商品连接
• 自主开发授权：通过token授权，token价格，调用地址，具体购买方式请发送邮件到：cloudservice@memect.co 电话号码:13146982978。调用API时通过header传递token

curl 'https://example.memect.cn/qaapi/qa/v2?qid=123'  \
-H 'token: <your token>'

三：主要功能

1 公司查询 通过文因金融问答API，可以查询上市A股企业和新三板企业的公司基本面信息，包括：财务数据（营业收入、净利润等，详情见附1）、财务变动原因、股价、市值、换手率、高管职位（不完全列表见附1）、子公司、产品、十大股东、欠款人（更多见附1）。数据主要来自上市企业和新三板企业的历年发布的公告。 示例：

* 四维图新的市值
* 四维图新的股价
* 四维图新的净利润
* 万科董事长
* 恒邦股份营收

2 行业查询 基于文因金融问答API，可以快速查找行业信息，目前支持的信息包括行业百科、行业上下游、行业市场规模。数据主要来自上市公司和新三板企业公告和近两年发布的研究报告。 示例：

* 计算机行业市场规模
* 人工智能市场规模
* 网络游戏上下游
* 钢化玻璃

3 人物查询 基于文因金融问答API，可以查询上市公司高管人物简历和关联关系，查询方式包括人名、公司+人名、公司+职位。数据主要来自上市公司和新三板企业公告。 示例：

* 万科董事长
* 万科王石
* 宋安澜

4 公司筛选 通过文因金融问答API，可以通过自然语言进行公司筛选和搜索，目前支持的筛选条件包括：行业（细分行业、概念）、板块（新三板、A股）、地区（行政区域规划）。支持按照财务指标和市值等信息进行排序。 示例：

* 浦东新区的公司
* 浦东新区的体育公司
* 浦东新区的新三板公司
* 浦东新区的市值最高的新三板公司
* 浦东新区净利润最高的新三板公司

五：API详情

1 创建问题 通过调用/qaapi/qa/{version} API的post请求，可以向机器人创建一个问题，因为机器人的处理是异步的，所以post请求后，并不会马上返回对应的答案，而是返回一个对应的问题id，这个问题id是用户用来获取问题答案的唯一标识，用户注意在本地保管好。

• 自主开发示例

curl 'https://example.memect.cn/qaapi/qa/v2' \
-H 'token: <your token>' \
-d '{
"question": "万科王石"
}'

• 阿里云市场示例：

curl -i -k -X POST 'https://memect0005.market.alicloudapi.com/qaapi/qa/v2'  -H 'Authorization:APPCODE <your appcode>' -H 'Content-Type:application/json; charset=utf-8' --data '{
"question": "万科王石"
}' -H 'Content-Type:application/json; charset=UTF-8'

• 返回数据说明

• 返回数据示例

{
"errCode": 0,
"response": {
    "qid": "15110116921533"
    }
}

2 获取答案 通过调用/qaapi/qa/{version} 接口的get请求，可以向机器人查询对应问题的答案和状态。

• 自行开发示例：

curl 'https://example.memect.cn/qaapi/qa/v2?qid=<your qid>' \
    -H 'token: <your token>'

• 阿里云市场调用API示例：

curl -i -k --get --include 'https://memect0005.market.alicloudapi.com/qaapi/qa/v2?qid=15143619627860'  -H 'Authorization:APPCODE <your appcode>'

• 返回数据说明

• 返回数据示例

{
    "errCode": 0,
    "response": {
          "cost ": 0.1,
          "score": 1,
          "suggestion ": [],
          "is_finished": true,
          "question_type":"query",
          "content": [
                {
                    "answer": [
"郁亮先生,1965年出生,汉族,中国国籍,郁亮先生,1965年出生,郁先生1990年加入万科,1994年起任公司董事,1996年任公司副总经理,1999年任公司常务副总经理兼财务负责人,2001年起任公司总裁至今。加入万科之前,郁先生曾供职于深圳外贸集团。郁先生目前兼任中城联盟投资管理股份有限公司董事,曾任上海美特斯邦威服饰股份有限公司(深圳证券交易所上市公司,股票代码:002269)独立董事。"
]
}
]
}
}
 

3 答案数据格式介绍 答案是指获取到的答案数据中被content包围起来的部分，这部分以列表形式存在，一般包含一到多个元素，其中每一个元素包含一个到多个不同的键。

answer示例

"content": [
    {
        "answer": [
            "万科A的挂牌日期是1991年01月29日。"
        ]
    }
]

full_report示例

"content": [
    {
        "full_report": {
            "url": "https://example.memect.cn/6e992d98f45f/a.pdf",
            "name": "万科A（000002）_文因互联_一键生成报告_20171124.pdf"
        }
    }
]

Image_url示例

"content": [
    {
        "image_url": "/qaapi/static/5c7cd5530f.png"
    }
]

report和data示例

"content": [
    {
        "answer": [
            "万科的高管有哪些"
        ],
        "report": "sadasdasdas",
        "data": {
            "layout": [
                "text"
            ],
            "data": [
                [
                    "你好"
                ]
            ],
            "title": "这是报告页",
            "notice": "万科A从业务属性判断，类似的A股企业有中国宝安(000009)"
        }
    }
]

4 报告数据格式介绍 报告数据指答案数据介绍中的data中的layout和data的说明。以下两个表格分别说明layout和data分别有哪些类型。

• layout类型说明

• data类型说明

• table格式说明

table是一个字典类型的数据，包括以下键：

示例：

{
 "rows": [
  [
   "",
   "收入(亿元)",
   "占比(%)"
  ],
  [
   "房地产",
   "655.23",
   "95.62"
  ],
  [
   "物业管理",
   "29.99",
   "4.38"
  ]
 ],
 "head": [
  "",
  "2017-06-30",
  "2017-06-30"
 ],
 "width": [
  1.4,
  3.7,
  3.1
 ],
 "merge": [
  [0, 1, 0, 0]
 ]
}

• middletable格式说明

与table一致，会在下一版本中弃用。

• text格式说明

元素是字符串或字符串组成的列表，每一个字符串是一段应该展示的文本。

• chart格式说明

略

• mschart格式说明

与chart一致，会在下一版中弃用。

• logic说明

略

5 错误码说明： 返回数据

* errCode
    * 数值，数值为0时表示请求正确。
    * 表示返回的错误码
* response
    * 字典
    * 返回内容