提供全球外汇黄金白银原油期货指数实时行情数据接口API,采用http请求get方式返回标准json格式结果。建议调用接口时,启用gzip压缩传输。

当前API接口包含了3个子API接口如下:

1、实时行情数据

请求示例: http://{api节点}/api/forex/quote?token={token账号}

测试接口:  http://api.sefapi.com/api/forex/quote

请求参数说明:

名称 必填 类型 说明
token(用户名账户) string 指定客服开的用户名token账户
psw(token账户密码) string token账户密码。默认没密码,如果设置了密码,这里必填。
symbol(品名) string 指定请求哪个品种行情数据,如果不指定返回当前定制所有商品行情数据。
可一次最多指定五个多个用小写逗号分隔。比如xauusd,eurusd,usoil,dxy,usdjpy

返回示例:

{
    "success": true,
    "count": 1,
    "msg": "",
    "results": [
        {
            "name": "欧元",
            "symbol": "EURUSD",
            "uptime": "2024/3/29 16:29:24",
            "bid": 1.07729,
            "ask": 1.07736,
            "high": 1.0805,
            "low": 1.0768,
            "open": 1.08008,
            "close": 1.07729,
            "vol": 1,
            "digit": 5
        }
    ]
}
				

2、实时tick数据

请求示例: http://{api节点}/api/forex/tick?token={token账号}

测试接口:  http://api.sefapi.com/api/forex/tick?symbol=xauusd

请求参数说明:

名称 必填 类型 说明
token(用户名账户) string 指定客服开的用户名token账户
psw(token账户密码) string token账户密码。默认没密码,如果设置了密码,这里必填。
symbol(品名) string 指定请求哪个品种折线tick数据,如果不指定其它参数一次最多可返回100条数据。可用uptime来指定返回哪段时间的数据。
uptime (更新超始时间) string 返回从起始时间到当前时间的数据。取值如:2024-03-28 14:35:00
rows (返回数据条数) string 指定返回数据条数,最大可返回 100条数据。

返回示例:

{
    "success": true,
    "count": 1,
    "msg": "",
    "results": [
        {
            "uptime": "2024/3/29 4:56:59",
            "bid": 2232.864,
            "ask": 2233.052
        }
    ]
}
				

3、实时K线数据

请求示例: http://{api节点}/api/forex/kline?token={token账号}

测试接口:  http://api.sefapi.com/api/forex/kline?symbol=xauusd&period=1

请求参数说明:

名称 必填 类型 说明
token(用户名账户) string 指定客服开的用户名token账户
psw(token账户密码) string token账户密码。默认没密码,如果设置了密码,这里必填。
symbol(品名) string 指定请求哪个品种K线数据,如果不指定其它参数一次最多可返回100条数据。可用uptime来指定返回哪段时间的数据。
uptime (更新超始时间) string 返回从起始时间到当前时间的数据。取值如:2024-3-20 14:35:00
period(K线周期) int 指定K线周期时间 取值如下:
1:1分钟K线
5:5分钟K线
15: 15分钟K线
30: 30分钟K线
60: 1小时K线
240:4小时K线
1440:1天K线
rows (返回数据条数)) string 指定返回数据条数,最大可返回 100条数据。

返回参数说明:

名称 类型 说明
success boolean 返回是否成功 成功true 或 失败false
msg string 错误或警告信息,如果有出错,会在这里直接显示出错的原因
rows int 指定URL参数返回指定行数
count int 输出数据计数行数。每次最多返回100条实时数据
name string 品种中文名
symbol string 商品合约名
uptime string 数据更新时间
bid double 当前买入价(一般以这个价格作为当前价格即可,卖出价格一般是加了点差了)
ask double 当前卖出价
open double 开盘价
close double 收盘价
high double 最高价
low double 最低价
vol int 字面上意思是成交量,但是全球市场太大,一下子统计不了,所以这里成交量为0,可忽略这个字段
digit int 报价小数点位数精度

返回示例:

{
    "success": true,
    "count": 1,
    "msg": "",
    "results": [
        {
            "uptime": "2024/3/29 4:55:00",
            "open": 2232.683,
            "high": 2234.41,
            "low": 2229.268,
            "close": 2232.864,
            "vol": 0
        }
    ]
}
				


可定制无限次数访问API包月,详情咨询客服。