AKShare 外汇数据

实时行情数据

接口: forex_spot_em

目标地址: https://quote.eastmoney.com/center/gridlist.html#forex_all

描述: 东方财富网-行情中心-外汇市场-所有汇率-实时行情数据

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

输入参数

名称	类型	描述
-	-	-

输出参数

名称	类型	描述
序号	int64	-
代码	object	-
名称	object	-
最新价	float64	-
涨跌额	float64	-
涨跌幅	float64	-
今开	float64	-
最高	float64	-
最低	float64	-
昨收	float64	-

接口示例

import akshare as ak

forex_spot_em_df = ak.forex_spot_em()
print(forex_spot_em_df)

数据示例

     序号  代码           名称  ...          最高        最低        昨收
0      1   USDZAR      美元兑南非兰特  ...   17.7123   17.5129   17.5916
1      2   HKDJPY        港币兑日元  ...   18.3602   18.2621   18.2684
2      3   USDJPY        美元兑日元  ...  144.1268  143.3220  143.4055
3      4   CADJPY        加元兑日元  ...  105.5900  105.0575  105.0855
4      5   CNHJPY     离岸人民币兑日元  ...   20.1081   20.0145   20.0260
..   ...      ...          ...  ...       ...       ...       ...
185  186   JPYHKD     100日元兑港币  ...    5.4757    5.4466    5.4739
186  187   JPYTRY  100日元兑土耳其里拉  ...   27.7972   27.6140   27.7796
187  188  CNYZARC   人民币南非兰特中间价  ...    2.4602    2.4602    2.4773
188  189   ZARUSD      南非兰特兑美元  ...    0.0569    0.0565    0.0569
189  190   HUFUSD     匈牙利福林兑美元  ...    0.0030    0.0029    0.0030
[190 rows x 10 columns]

历史行情数据

接口: forex_hist_em

目标地址: https://quote.eastmoney.com/cnyrate/EURCNYC.html

描述: 东方财富网-行情中心-外汇市场-所有汇率-历史行情数据

限量: 单次返回指定 symbol 的历史行情数据

输入参数

名称	类型	描述
symbol	str	symbol="USDCNH"; 品种代码；可以通过 ak.forex_spot_em() 来获取所有可获取历史行情数据的品种代码

输出参数

名称	类型	描述
序号	int64	-
代码	object	-
名称	object	-
最新价	float64	-
涨跌额	float64	-
涨跌幅	float64	-
今开	float64	-
最高	float64	-
最低	float64	-
昨收	float64	-

接口示例

import akshare as ak

forex_hist_em_df = ak.forex_hist_em(symbol="USDCNH")
print(forex_hist_em_df)

数据示例

         日期      代码        名称      今开     最新价      最高      最低    振幅
0     2010-08-23  USDCNH  美元兑离岸人民币  6.7200  6.7250  6.7250  6.7200  0.00
1     2010-08-24  USDCNH  美元兑离岸人民币  6.7230  6.7265  6.7265  6.7230  0.05
2     2010-08-25  USDCNH  美元兑离岸人民币  6.7325  6.7325  6.7325  6.7325  0.00
3     2010-08-26  USDCNH  美元兑离岸人民币  6.7500  6.7450  6.7500  6.7450  0.07
4     2010-08-27  USDCNH  美元兑离岸人民币  6.7530  6.7530  6.7530  6.7530  0.00
...          ...     ...       ...     ...     ...     ...     ...   ...
3776  2025-02-28  USDCNH  美元兑离岸人民币  7.3007  7.2954  7.3019  7.2844  0.24
3777  2025-03-03  USDCNH  美元兑离岸人民币  7.2915  7.3027  7.3069  7.2848  0.30
3778  2025-03-04  USDCNH  美元兑离岸人民币  7.3028  7.2543  7.3069  7.2488  0.80
3779  2025-03-05  USDCNH  美元兑离岸人民币  7.2532  7.2362  7.2769  7.2343  0.59
3780  2025-03-06  USDCNH  美元兑离岸人民币  7.2363  7.2484  7.2485  7.2354  0.18
[3781 rows x 8 columns]

人民币牌价数据

接口: currency_boc_sina

目标地址: https://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 {'美元', '英镑', '欧元', '澳门元', '泰国铢', '菲律宾比索', '港币', '瑞士法郎', '新加坡元', '瑞典克朗', '丹麦克朗', '挪威克朗', '日元', '加拿大元', '澳大利亚元', '新西兰元', '韩国元'}
start_date	str	start_date="20230304"; 开始日期和结束日期之间的间隔要超过 6 个月
end_date	str	end_date="20231110"; 开始日期和结束日期之间的间隔要超过 6 个月

输出参数

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

接口示例

import akshare as ak

currency_boc_sina_df = ak.currency_boc_sina(symbol="美元", start_date="20230304", end_date="20231110")
print(currency_boc_sina_df)

数据示例

    日期   中行汇买价   中行钞买价  中行钞卖价/汇卖价   央行中间价
0    2023-03-06  691.80  686.17     694.73  689.51
1    2023-03-07  694.49  688.84     697.44  691.56
2    2023-03-08  693.49  687.85     696.43  695.25
3    2023-03-09  695.04  689.39     697.99  696.66
4    2023-03-10  689.70  684.09     692.62  696.55
..          ...     ...     ...        ...     ...
175  2023-11-06  725.83  725.67     728.73  717.80
176  2023-11-07  726.73  726.57     729.63  717.76
177  2023-11-08  726.73  726.57     729.63  717.73
178  2023-11-09  727.28  727.12     730.18  717.72
179  2023-11-10  727.93  727.77     730.83  717.71
[180 rows x 5 columns]

人民币汇率中间价

接口: currency_boc_safe

目标地址: https://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
          ...     ...     ...     ...  ...     ...      ...     ...     ...
7318  2023-09-11  721.48  781.40  4.9710  ...  145.79  368.808  242.47  484.82
7319  2023-09-12  719.86  779.52  4.9573  ...  146.60  371.740  239.65  487.87
7320  2023-09-13  718.94  779.19  4.9356  ...  147.20  372.274  238.83  489.51
7321  2023-09-14  718.74  776.11  4.9174  ...  148.01  372.886  238.35  492.54
7322  2023-09-15  717.86  768.65  4.9064  ...  148.78  373.622  237.86  493.03
[7323 rows x 25 columns]

人民币外汇即期报价

接口: 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

外汇掉期 C-Swap 定盘曲线

接口: fx_c_swap_cm

目标地址: https://www.chinamoney.org.cn/chinese/bkcurvfsw

描述: 中国外汇交易中心暨全国银行间同业拆借中心-基准-外汇市场-外汇掉期曲线-外汇掉期 C-Swap 定盘曲线

限量: 单次返回所有行情数据

输入参数

名称	类型	描述
-	-	-

输出参数

名称	类型	描述
日期时间	object	-
期限品种	object	-
掉期点(Pips)	float64	-
掉期点数据源	object
全价汇率	float64

接口示例

import akshare as ak

fx_c_swap_cm_df = ak.fx_c_swap_cm()
print(fx_c_swap_cm_df)

数据示例

         日期时间 期限品种  掉期点(Pips) 掉期点数据源    全价汇率
0   2025-09-26 16:30:00.0   ON     -15.00   报价数据  7.1374
1   2025-09-26 16:30:00.0   TN      -4.75   报价数据  7.1359
2   2025-09-26 16:30:00.0   SN     -16.74   报价数据  7.1337
3   2025-09-26 16:30:00.0   1W     -16.74   报价数据  7.1337
4   2025-09-26 16:30:00.0   2W     -41.80   报价数据  7.1312
5   2025-09-26 16:30:00.0   3W     -76.05   报价数据  7.1278
6   2025-09-26 16:30:00.0   1M    -122.74   报价数据  7.1231
7   2025-09-26 16:30:00.0   2M    -239.50   报价数据  7.1115
8   2025-09-26 16:30:00.0   3M    -373.75   报价数据  7.0980
9   2025-09-26 16:30:00.0   6M    -706.75   报价数据  7.0647
10  2025-09-26 16:30:00.0   9M   -1030.50   报价数据  7.0324
11  2025-09-26 16:30:00.0   1Y   -1337.01   报价数据  7.0017

外币对即期报价

接口: 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

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

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

输入参数

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

输出参数

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

接口示例

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
[90 rows x 2 columns]

货币对-投机情绪报告

接口: macro_fx_sentiment

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

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

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

输入参数

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

输出参数

名称	类型	描述
date	object	间隔10分钟
AUDJPY	float64	-
AUDUSD	float64	-
EURAUD	float64	-
EURJPY	float64	-
EURUSD	float64	-
GBPJPY	float64	-
GBPUSD	float64	-
NZDUSD	float64	-
USDCAD	float64	-
USDCHF	float64	-
USDJPY	float64	-
USDX	float64	-
XAUUSD	float64	-

接口示例

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)

数据示例

                 date  AUDJPY  AUDUSD  EURAUD  ...  USDCHF  USDJPY   USDX  XAUUSD
0    2022-10-11 00:00   52.45   72.53   44.73  ...   39.59   33.90  37.00   72.38
1    2022-10-11 00:10   52.46   72.47   44.85  ...   39.10   33.78  36.49   72.43
2    2022-10-11 00:20   52.48   72.23   45.37  ...   39.10   33.88  36.48   72.75
3    2022-10-11 00:30   52.38   72.34   44.71  ...   38.90   33.73  36.34   72.83
4    2022-10-11 00:40   52.31   72.48   44.44  ...   38.80   33.61  36.23   72.82
..                ...     ...     ...     ...  ...     ...     ...    ...     ...
962  2022-10-17 19:30   54.86   68.14   36.53  ...   42.80   30.48  39.77   60.45
963  2022-10-17 19:40   54.43   67.81   37.01  ...   43.54   30.83  39.82   60.73
964  2022-10-17 19:50   54.39   68.46   36.92  ...   43.38   30.75  39.72   60.77
965  2022-10-17 20:00   54.10   68.05   38.01  ...   44.05   30.88  39.49   61.36
966  2022-10-17 20:10   55.51   67.39   36.80  ...   42.82   30.95  39.78   59.70

外汇行情报价

接口: fx_quote_baidu

目标地址: https://gushitong.baidu.com/top/foreign-rmb

描述: 百度股市通-外汇-行情榜单

限量: 单次返回指定 symbol 当前时点的行情报价

输入参数

名称	类型	描述
symbol	str	symbol="人民币"; choice of {"人民币", 美元"}
token	str	目标网站复制 acs-token 后传入

输出参数

名称	类型	描述
代码	object	-
名称	object	-
最新价	float64	-
涨跌额	float64	-
涨跌幅	float64	-

接口示例

import akshare as ak

fx_quote_baidu_df = ak.fx_quote_baidu(symbol="人民币")
print(fx_quote_baidu_df)

数据示例

         代码         名称       最新价     涨跌额     涨跌幅
0    CNYSCR      人民币塞舌尔卢比    2.1391  0.2164  0.1126
1    CNYETH   人民币Ethereum    0.0000  0.0000  0.0217
2    CNYSBD     人民币所罗门群岛元    1.1711  0.0224  0.0195
3    CNYTOP       人民币汤加潘加    0.3461  0.0038  0.0111
4    CNYMDL     人民币摩尔多瓦列伊    2.4150  0.0238  0.0100
..      ...           ...       ...     ...     ...
150  CNYXPT       人民币珀价盎司    0.0001 -0.0000 -0.0071
151  CNYPKR     人民币巴基斯坦卢比   40.1263 -0.3054 -0.0076
152  CNYMGA  人民币马达加斯加阿里亚里  655.2200 -7.9000 -0.0119
153  CNYRUB      人民币俄罗斯卢布   11.3331 -0.1375 -0.0120
154  CNYXAG       人民币银价盎司    0.0018 -0.0000 -0.0151
[155 rows x 5 columns]