提供全球外汇黄金白银原油期货指数实时行情数据接口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包月,详情咨询客服。