{"openapi":"3.1.0","info":{"title":"QuantSource API · 外汇","description":"QuantSourceAPI 是 QuantSource 的 HTTP API 工具, 主要目的是使 QuantSource 的数据接口部署到服务器，从而让用户通过 HTTP 访问相关接口来获取所需要的数据","version":"0.1.0"},"paths":{"/api/public/currency_boc_safe":{"get":{"tags":["外汇"],"summary":"公开接口：currency_boc_safe","description":"人民币汇率中间价\nhttps://www.safe.gov.cn/safe/rmbhlzjj/index.html\n:return: 人民币汇率中间价\n:rtype: pandas.DataFrame","operationId":"public_currency_boc_safe","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/public/currency_boc_sina":{"get":{"tags":["外汇"],"summary":"公开接口：currency_boc_sina","description":"新浪财经-中行人民币牌价历史数据查询\nhttps://biz.finance.sina.com.cn/forex/forex.php?startdate=2012-01-01&enddate=2021-06-14&money_code=EUR&type=0\n:param symbol: choice of {'美元', '英镑', '欧元', '澳门元', '泰国铢', '菲律宾比索', '港币', '瑞士法郎', '新加坡元', '瑞典克朗', '丹麦克朗', '挪威克朗', '日元', '加拿大元', '澳大利亚元', '新西兰元', '韩国元'}\n:type symbol: str\n:param start_date: 开始交易日\n:type start_date: str\n:param end_date: 结束交易日\n:type end_date: str\n:return: 中行人民币牌价历史数据查询\n:rtype: pandas.DataFrame","operationId":"public_currency_boc_sina","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","description":"symbol=\"美元\"; choice of {'美元', '英镑', '欧元', '澳门元', '泰国铢', '菲律宾比索', '港币', '瑞士法郎', '新加坡元', '瑞典克朗', '丹麦克朗', '挪威克朗', '日元', '加拿大元', '澳大利亚元', '新西兰元', '韩国元'}","default":"美元","title":"Symbol"},"description":"symbol=\"美元\"; choice of {'美元', '英镑', '欧元', '澳门元', '泰国铢', '菲律宾比索', '港币', '瑞士法郎', '新加坡元', '瑞典克朗', '丹麦克朗', '挪威克朗', '日元', '加拿大元', '澳大利亚元', '新西兰元', '韩国元'}"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"start_date=\"20230304\"；开始日期和结束日期之间的间隔要超过 6 个月","default":"20230304","title":"Start Date"},"description":"start_date=\"20230304\"；开始日期和结束日期之间的间隔要超过 6 个月"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"end_date=\"20231110\"；开始日期和结束日期之间的间隔要超过 6 个月","default":"20231110","title":"End Date"},"description":"end_date=\"20231110\"；开始日期和结束日期之间的间隔要超过 6 个月"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/currency_pair_map":{"get":{"tags":["外汇"],"summary":"公开接口：currency_pair_map","description":"指定货币的所有可获取货币对的数据\nhttps://cn.investing.com/currencies/cny-jmd\n:param symbol: 指定货币\n:type symbol: str\n:return: 指定货币的所有可获取货币对的数据\n:rtype: pandas.DataFrame","operationId":"public_currency_pair_map","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","description":"symbol=\"人民币\"；此处提供中文的币种名称，可以访问[网页](https://cn.investing.com/currencies/cny-jmd) 的页面下方查看","default":"美元","title":"Symbol"},"description":"symbol=\"人民币\"；此处提供中文的币种名称，可以访问[网页](https://cn.investing.com/currencies/cny-jmd) 的页面下方查看"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/forex_hist_em":{"get":{"tags":["外汇"],"summary":"公开接口：forex_hist_em","description":"东方财富网-行情中心-外汇市场-所有汇率-历史行情数据\nhttps://quote.eastmoney.com/cnyrate/EURCNYC.html\n:param symbol: 品种代码；可以通过 qs.forex_spot_em() 来获取所有可获取历史行情数据的品种代码\n:type symbol: str\n:return: 历史行情数据\n:rtype: pandas.DataFrame","operationId":"public_forex_hist_em","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","description":"symbol=\"USDCNH\"；品种代码；可以通过 qs.forex_spot_em() 来获取所有可获取历史行情数据的品种代码","default":"USDCNH","title":"Symbol"},"description":"symbol=\"USDCNH\"；品种代码；可以通过 qs.forex_spot_em() 来获取所有可获取历史行情数据的品种代码"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/forex_spot_em":{"get":{"tags":["外汇"],"summary":"公开接口：forex_spot_em","description":"东方财富网-行情中心-外汇市场-所有汇率-实时行情数据\nhttps://quote.eastmoney.com/center/gridlist.html#forex_all\n:return: 实时行情数据\n:rtype: pandas.DataFrame","operationId":"public_forex_spot_em","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/public/fx_c_swap_cm":{"get":{"tags":["外汇"],"summary":"公开接口：fx_c_swap_cm","description":"中国外汇交易中心暨全国银行间同业拆借中心-基准-外汇市场-外汇掉期曲线-外汇掉期 C-Swap 定盘曲线\nhttps://www.chinamoney.org.cn/chinese/bkcurvfsw\n:return: 外汇掉期 C-Swap 定盘曲线\n:rtype: pandas.DataFrame","operationId":"public_fx_c_swap_cm","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/public/fx_pair_quote":{"get":{"tags":["外汇"],"summary":"公开接口：fx_pair_quote","description":"中国外汇交易中心暨全国银行间同业拆借中心-市场数据-市场行情-债券市场行情-外币对即期报价\nhttp://www.chinamoney.com.cn/chinese/mkdatapfx/\n:return: 外币对即期报价\n:rtype: pandas.DataFrame","operationId":"public_fx_pair_quote","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/public/fx_quote_baidu":{"get":{"tags":["外汇"],"summary":"公开接口：fx_quote_baidu","description":"百度股市通-外汇-行情榜单\nhttps://finance.baidu.com/top/foreign-rmb\n:param symbol: choice of {\"人民币\", \"美元\"}\n:type symbol: str\n:param token: 目标网站复制 acs-token 后传入\n:type token: str\n:return: 外汇行情数据\n:rtype: pandas.DataFrame","operationId":"public_fx_quote_baidu","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","description":"symbol=\"人民币\"; choice of {\"人民币\"，美元\"}","default":"人民币","title":"Symbol"},"description":"symbol=\"人民币\"; choice of {\"人民币\"，美元\"}"},{"name":"token","in":"query","required":false,"schema":{"type":"string","description":"目标网站复制 acs-token 后传入","default":"","title":"Token"},"description":"目标网站复制 acs-token 后传入"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/fx_spot_quote":{"get":{"tags":["外汇"],"summary":"公开接口：fx_spot_quote","description":"中国外汇交易中心暨全国银行间同业拆借中心-市场数据-市场行情-外汇市场行情-人民币外汇即期报价\nhttp://www.chinamoney.com.cn/chinese/mkdatapfx/\n:return: 人民币外汇即期报价\n:rtype: pandas.DataFrame","operationId":"public_fx_spot_quote","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/public/fx_swap_quote":{"get":{"tags":["外汇"],"summary":"公开接口：fx_swap_quote","description":"中国外汇交易中心暨全国银行间同业拆借中心-市场数据-市场行情-债券市场行情-人民币外汇远掉报价\nhttps://www.chinamoney.com.cn/chinese/index.html\n:return: 人民币外汇远掉报价\n:rtype: pandas.DataFrame","operationId":"public_fx_swap_quote","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/public/macro_fx_sentiment":{"get":{"tags":["外汇"],"summary":"公开接口：macro_fx_sentiment","description":"金十数据-外汇-投机情绪报告\n外汇投机情绪报告显示当前市场多空仓位比例，数据由8家交易平台提供，涵盖11个主要货币对和1个黄金品种。\n报告内容：品种：澳元兑日元、澳元兑美元、欧元兑美元、欧元兑澳元、欧元兑日元、英镑兑美元、英镑兑日元、纽元兑美元、美元兑加元、美元兑瑞郎、美元兑日元以及现货黄金兑美元。\n         数据：由Shark - fx整合全球8家交易平台（ 包括 Oanda、FXCM、Insta、Dukas、MyFxBook以及FiboGroup） 的多空投机仓位数据而成。\n名词释义：外汇投机情绪报告显示当前市场多空仓位比例，数据由8家交易平台提供，涵盖11个主要货币对和1个黄金品种。\n工具使用策略：Shark-fx声明表示，基于“主流通常都是错误的”的事实，当空头头寸超过60%，交易者就应该建立多头仓位；同理，当市场多头头寸超过60%，交易者则应该建立空头仓位。此外，当多空仓位比例接近50%的情况下，我们则倾向于建议交易者不要进场，保持观望。\nhttps://datacenter.jin10.com/reportType/dc_ssi_trends\n:param start_date: 具体交易日\n:type start_date: str\n:param end_date: 具体交易日，与 end_date 相同\n:type end_date: str\n:return: 投机情绪报告\n:rtype: pandas.DataFrame","operationId":"public_macro_fx_sentiment","parameters":[{"name":"start_date","in":"query","required":false,"schema":{"type":"string","description":"start_date=\"2020-04-07\"；所指定的日期必须在当前交易日之前的30个交易日内","default":"20221011","title":"Start Date"},"description":"start_date=\"2020-04-07\"；所指定的日期必须在当前交易日之前的30个交易日内"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","description":"end_date=\"2020-04-07\"；与 start_date 一致","default":"20221017","title":"End Date"},"description":"end_date=\"2020-04-07\"；与 start_date 一致"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"tags":[{"name":"外汇"}],"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}