AKShare 外汇数据

人民币牌价数据

接口: currency_boc_sina

目标地址: http://biz.finance.sina.com.cn/forex/forex.php?startdate=2012-01-01&enddate=2021-06-14&money_code=EUR&type=0

描述: 新浪财经-中行人民币牌价历史数据

限量: 单次返回指定日期的所有历史数据

输入参数

名称	类型	描述
symbol	str	symbol="美元"; choice of {'美元', '英镑', '欧元', '澳门元', '泰国铢', '菲律宾比索', '港币', '瑞士法郎', '新加坡元', '瑞典克朗', '丹麦克朗', '挪威克朗', '日元', '加拿大元', '澳大利亚元', '新西兰元', '韩国元'}
date	str	date="20220620"

输出参数

名称	类型	描述
日期	object	-
中行汇买价	float64	注意单位: 元
中行钞买价	float64	注意单位: 元
中行钞卖价/汇卖价	float64	注意单位: 元
央行中间价	float64	注意单位: 元

接口示例

import akshare as ak

currency_boc_sina_df = ak.currency_boc_sina(symbol="美元", date="20220620")
print(currency_boc_sina_df)

数据示例

        日期   中行汇买价   中行钞买价  中行钞卖价/汇卖价   央行中间价
0     2012-01-02  627.42  622.39     629.93  630.09
1     2012-01-03  627.42  622.39     629.93  630.09
2     2012-01-04  628.02  622.98     630.53  630.01
3     2012-01-05  628.79  623.75     631.31  631.15
4     2012-01-06  629.21  624.17     631.74  631.66
          ...     ...     ...        ...     ...
2924  2022-06-14  672.78  667.31     675.63  674.82
2925  2022-06-15  670.24  664.79     673.08  675.18
2926  2022-06-16  669.19  663.75     672.03  670.99
2927  2022-06-17  670.39  664.93     673.23  669.23
2928  2022-06-20  669.54  664.09     672.38  671.20

人民币汇率中间价

接口: currency_boc_safe

目标地址: http://www.safe.gov.cn/safe/rmbhlzjj/index.html

描述: 外汇管理局-人民币汇率中间价

限量: 单次返回所有历史数据

输入参数

名称	类型	描述
-	-	-

输出参数

名称	类型	描述
日期	object	-
美元	float64	-
欧元	float64	-
日元	float64	-
港元	float64	-
英镑	float64	-
林吉特	float64	-
卢布	float64	-
澳元	float64	-
加元	float64	-
新西兰元	float64	-
新加坡元	float64	-
瑞士法郎	float64	-
兰特	float64	-
韩元	float64	-
迪拉姆	float64	-
里亚尔	float64	-
福林	float64	-
兹罗提	float64	-
丹麦克朗	float64	-
瑞典克朗	float64	-
挪威克朗	float64	-
里拉	float64	-
比索	float64	-
泰铢	float64	-

P.S. 人民币对马来西亚林吉特、俄罗斯卢布、南非兰特、韩元、阿联酋迪拉姆、沙特里亚尔、匈牙利福林、波兰兹罗提、丹麦克朗、瑞典克朗、挪威克朗、土耳其里拉、墨西哥比索、泰铢汇率中间价采取间接标价法，即100人民币折合多少外币。人民币对其它10种货币汇率中间价仍采取直接标价法，即100外币折合多少人民币。

接口示例

import akshare as ak

currency_boc_safe_df = ak.currency_boc_safe()
print(currency_boc_safe_df)

数据示例

          日期      美元      欧元      日元  ...    挪威克朗  里拉      比索      泰铢
0     1994-01-01  870.00     NaN  7.7800  ...     NaN      NaN     NaN     NaN
1     1994-01-03  870.00     NaN  7.7800  ...     NaN      NaN     NaN     NaN
2     1994-01-04  870.00     NaN  7.7196  ...     NaN      NaN     NaN     NaN
3     1994-01-05  870.00     NaN  7.7196  ...     NaN      NaN     NaN     NaN
4     1994-01-06  870.00     NaN  7.7196  ...     NaN      NaN     NaN     NaN
          ...     ...     ...     ...  ...     ...      ...     ...     ...
7012  2022-06-14  674.82  702.69  5.0267  ...  146.78  255.974  303.41  517.07
7013  2022-06-15  675.18  704.30  4.9933  ...  148.17  255.783  304.62  518.89
7014  2022-06-16  670.99  701.42  5.0021  ...  148.11  256.967  301.93  518.98
7015  2022-06-17  669.23  705.82  5.0471  ...  148.81  258.479  305.16  523.14
7016  2022-06-20  671.20  704.03  4.9601  ...  148.96  258.339  302.59  525.24

人民币外汇即期报价

接口: fx_spot_quote

目标地址: http://www.chinamoney.com.cn/chinese/mkdatapfx/

描述: 人民币外汇即期报价

限量: 单次返回实时行情数据

输入参数

名称	类型	描述
-	-	-

输出参数

人民币外汇即期报价

名称	类型	描述
货币对	object
买报价	float64
卖报价	float64

注：本行情为询价报价行情(美元为ODM), 实时更新

接口示例

import akshare as ak

fx_spot_quote_df = ak.fx_spot_quote()
print(fx_spot_quote_df)

数据示例

      货币对        买报价        卖报价
0      USD/CNY    6.68500    6.68540
1      EUR/CNY    7.08170    7.08260
2   100JPY/CNY    4.92400    4.92480
3      HKD/CNY    0.85184    0.85196
4      GBP/CNY    8.20610    8.20690
5      AUD/CNY    4.65300    4.65310
6      NZD/CNY    4.21240    4.21320
7      SGD/CNY    4.82670    4.82680
8      CHF/CNY    7.00390    7.00450
9      CAD/CNY    5.21290    5.21360
10     CNY/MYR    0.65590    0.65750
11     CNY/RUB    7.93950    7.98320
12     CNY/ZAR    2.37330    2.37360
13     CNY/KRW  192.14000  192.20000
14     CNY/AED    0.54935    0.54948
15     CNY/SAR    0.56142    0.56147
16     CNY/HUF   56.53140   56.57020
17     CNY/PLN    0.66319    0.66344
18     CNY/DKK    1.05070    1.05070
19     CNY/SEK    1.50220    1.50240
20     CNY/NOK    1.45980    1.46000
21     CNY/TRY    2.48949    2.48980
22     CNY/MXN    2.97690    2.97870
23     CNY/THB    5.24800    5.25000

人民币外汇远掉报价

接口: fx_swap_quote

目标地址: http://www.chinamoney.com.cn/chinese/mkdatapfx/

描述: 人民币外汇远掉报价

限量: 单次返回实时行情数据

输入参数

名称	类型	描述
-	-	-

输出参数

人民币外汇远掉报价

名称	类型	描述
货币对	object	e.g., "USD/CNY"
1周	object	e.g., "11.50/12.00"
1月	object
3月	object
6月	object
9月	object
1年	object

注：本行情为询价报价行情(美元为ODM), 实时更新

接口示例

import akshare as ak

fx_swap_quote_df = ak.fx_swap_quote()
print(fx_swap_quote_df)

数据示例

           货币对        1周  ...                 9月                 1年
0      USD/CNY      5.00/5.00  ...    -235.00/-233.00    -347.00/-345.00
1      EUR/CNY    39.17/39.28  ...    1241.70/1242.30    1513.74/1514.19
2   100JPY/CNY    25.93/26.33  ...    1156.41/1158.04    1604.66/1604.74
3      HKD/CNY      2.35/2.55  ...          6.88/7.10        -4.88/-4.41
4      GBP/CNY    15.36/16.28  ...      221.38/222.74      188.33/191.70
5      AUD/CNY      9.47/9.87  ...    -128.45/-127.09    -254.98/-248.56
6      NZD/CNY      1.36/1.76  ...    -311.14/-299.26    -435.15/-420.15
7      SGD/CNY      3.31/3.39  ...        44.03/44.60        72.00/84.97
8      CHF/CNY    35.23/36.21  ...    1346.89/1347.41    1702.55/1706.77
9      CAD/CNY      7.86/7.96  ...    -124.21/-122.50    -193.11/-190.60
10     CNY/MYR     -1.43/0.35  ...       -22.75/-9.30       -21.12/-5.39
11     CNY/RUB  627.40/627.80  ...  30785.79/32165.82  35730.95/36968.82
12     CNY/ZAR    12.36/12.37  ...      719.25/726.67     992.29/1007.07
13     CNY/KRW    -4.63/-0.56  ...     -106.97/-93.21    -125.42/-117.52
14     CNY/AED    -0.60/-0.50  ...        18.31/18.63        27.90/28.35
15     CNY/SAR        ---/---  ...        22.03/22.54        32.68/33.00
16     CNY/HUF  370.56/423.79  ...  26568.04/26596.38  36664.72/36718.42
17     CNY/PLN      5.37/5.39  ...      264.19/264.92      359.67/361.01
18     CNY/DKK    -5.70/-5.49  ...    -186.20/-186.08    -229.34/-226.54
19     CNY/SEK    -5.91/-5.90  ...    -132.23/-131.85    -137.94/-137.43
20     CNY/NOK    -2.67/-2.64  ...      -43.57/-42.56      -35.65/-33.93
21     CNY/TRY    53.89/61.57  ...    8321.13/8339.39  11516.20/11550.77
22     CNY/MXN    -2.84/-2.80  ...      105.61/105.73    2350.95/2393.33
23     CNY/THB  -68.44/-43.00  ...    -514.60/-436.28    -675.05/-534.00

外币对即期报价

接口: fx_pair_quote

目标地址: http://www.chinamoney.com.cn/chinese/mkdatapfx/

描述: 外币对即期报价

限量: 单次返回当前时点最近更新的即时数据

输入参数

名称	类型	描述
-	-	-

输出参数

名称	类型	描述
货币对	object	e.g., "AUD/USD"
买报价	float64	e.g., "0.68460"
卖报价	float64	e.g., "0.68461"

注：本行情为询价报价行情(美元为ODM), 实时更新

接口示例

import akshare as ak

fx_pair_quote_df = ak.fx_pair_quote()
print(fx_pair_quote_df)

数据示例

        货币对        买报价        卖报价
0   AUD/USD    0.69594    0.69600
1   EUR/JPY  143.80300  143.81500
2   EUR/USD    1.05929    1.05935
3   GBP/USD    1.22733    1.22739
4   USD/CAD    1.28238    1.28247
5   USD/CHF    0.95410    0.95417
6   USD/HKD    7.84744    7.84755
7   USD/JPY  135.75500  135.76000
8   USD/SGD    1.38510    1.38518
9   NZD/USD    0.63003    0.63012
10  EUR/GBP    0.86308    0.86308

指定币种的所有货币对

接口: currency_pair_map

目标地址: https://cn.investing.com/currencies/cny-jmd

描述: 获取指定币种的所有能够获取到的货币对信息，历史数据可以调用 currency_history 获取

限量: 单次返回指定币种的所有能获取数据的货币对

输入参数

名称	类型	描述
symbol	str	symbol="人民币"; 此处提供中文的币种名称, 可以访问网页 的页面下方查看

输出参数

名称	类型	描述
name	str	货币对中文简称
code	float	货币对代码

接口示例

import akshare as ak

currency_pair_map_df = ak.currency_pair_map(symbol="人民币")
print(currency_pair_map_df)

数据示例

          name     code
0     人民币-丹麦克朗  cny-dkk
1     丹麦克朗-人民币  dkk-cny
2     人民币-瑞士法郎  cny-chf
3     瑞士法郎-人民币  chf-cny
4     人民币-捷克克朗  cny-czk
..         ...      ...
85   人民币-澳大利亚元  cny-aud
86   澳大利亚元-人民币  aud-cny
87    人民币-新西兰元  cny-nzd
88    新西兰元-人民币  nzd-cny
89  人民币-巴拿马巴波亚  cny-pab

外币对历史数据

接口: currency_hist

目标地址: https://cn.investing.com/currencies/

描述: 获取指定外币对指定时间的历史数据, 此接口需要使用代理访问

限量: 单次返回指定时间的所有历史数据

输入参数

名称	类型	必选	描述
symbol	str	Y	symbol="usd-jpy"; 可以通过 currency_name_code 查询该两种货币可以获取的所有货币对或通过 currency_pair_map 获取指定币种的所有货币对
start_date	str	Y	start_date="20050101"
end_date	str	Y	end_date="20200117"

数据示例-currency_name_code

          name     code
0        欧元/美元  eur-usd
1        英镑/美元  gbp-usd
2        美元/日元  usd-jpy
3      美元/瑞士法郎  usd-chf
4     澳大利亚元/美元  aud-usd
..         ...      ...
268    日元/新加坡元  jpy-sgd
269  科威特第纳尔/日元  kwd-jpy
270  日元/白俄罗斯卢布  jpy-byn
271  日元/乌克兰赫里纳  jpy-uah
272   日元/土耳其里拉  jpy-try

输出参数

名称	类型	默认显示	描述
日期	str	Y	-
收盘	float	Y	-
开盘	float	Y	-
高	float	Y	-
低	float	Y	-
涨跌幅	float	Y	-

接口示例

import akshare as ak
currency_hist_df = ak.currency_hist(symbol="usd-jpy", start_date="20050101", end_date="20200117")
print(currency_hist_df)

数据示例

            收盘      开盘       高       低     涨跌幅
日期
2020-01-17  110.16  110.14  110.30  110.05   0.00%
2020-01-16  110.16  109.89  110.19  109.86   0.25%
2020-01-15  109.89  110.00  110.03  109.78  -0.08%
2020-01-14  109.98  109.94  110.22  109.86   0.04%
2020-01-13  109.94  109.49  109.95  109.45   0.43%
            ...     ...     ...     ...     ...
2005-01-07  104.80  104.97  105.17  103.83  -0.26%
2005-01-06  105.07  104.12  105.20  103.85   0.94%
2005-01-05  104.09  104.56  105.03  103.73  -0.50%
2005-01-04  104.61  102.77  104.81  102.41   1.84%
2005-01-03  102.72  102.69  103.47  102.33   0.24%

货币对-投机情绪报告

接口: macro_fx_sentiment

目标地址: https://datacenter.jin10.com/reportType/dc_ssi_trends

描述: 获取货币对-投机情绪报告

限量: 单次返回指定日期所有品种的数据(所指定的日期必须在当前交易日之前的30个交易日内)

输入参数

名称	类型	必选	描述
start_date	str	Y	start_date="2020-04-07"; 所指定的日期必须在当前交易日之前的30个交易日内
end_date	str	Y	end_date="2020-04-07"; 与 start_date 一致

输出参数

名称	类型	默认显示	描述
日期索引	str	Y	间隔10分钟
AUDJPY	str	Y	-
AUDUSD	str	Y	-
EURAUD	str	Y	-
EURJPY	str	Y	-
EURUSD	str	Y	-
GBPJPY	str	Y	-
GBPUSD	str	Y	-
NZDUSD	str	Y	-
USDCAD	str	Y	-
USDCHF	str	Y	-
USDJPY	str	Y	-
USDX	str	Y	-
XAUUSD	str	Y	-

接口示例

import akshare as ak
from datetime import datetime
test_date = datetime.now().date().isoformat().replace("-", "")
macro_fx_sentiment_df = ak.macro_fx_sentiment(start_date=test_date, end_date=test_date)
print(macro_fx_sentiment_df)

数据示例

                 AUDJPY AUDUSD EURAUD EURJPY  ... USDCHF USDJPY   USDX XAUUSD
2020-04-22 00:00  55.19  48.96  47.59  68.24  ...  59.42  58.91  48.07  45.64
2020-04-22 00:10  55.31  48.92  47.83  68.11  ...  59.38  57.90  47.89  45.63
2020-04-22 00:20  54.93  48.67  47.38  67.91  ...  59.32  57.78  47.99  45.73
2020-04-22 00:30  55.02  48.77  47.44  67.50  ...  59.61  57.64  48.02  45.32
2020-04-22 00:40  55.07  48.65  47.17  67.56  ...  59.27  56.99  47.75  45.36
                 ...    ...    ...    ...  ...    ...    ...    ...    ...
2020-04-22 20:20  53.66  44.01  47.54  67.38  ...  59.56  57.70  50.78  47.72
2020-04-22 20:30  53.91  44.11  47.78  67.43  ...  59.79  57.70  50.65  47.95
2020-04-22 20:40  54.00  44.01  48.00  67.05  ...  59.57  57.82  50.80  47.70
2020-04-22 20:50  53.95  44.11  48.14  66.76  ...  59.67  57.80  50.87  47.55
2020-04-22 21:00  53.95  44.06  47.99  67.21  ...  59.59  57.64  50.73  47.35