1. 实时行情推送

建立 WebSocket 长连接,推送实时行情数据。

wss://feed.api.lwork.com/v1/realtime/tick

当然,你应该在Headers里面添加你的授权信息,如果您使用的技术框架并不支持这么做,那么我们为您新增了在Query Form中来传递:

wss://feed.api.lwork.com/v1/realtime/tick?x_api_tenantId={tenantId}&x_api_token={token}

连接数

租户在订购产品后,将有一定数量的实时行情连接数量,如果这些连接被占用,服务器将会拒绝建立新的连接。如果你需要更多的连接资源,请前往Support Center或联系你的客户经理进行新增。

心跳检测

为了避免网络异常引起的虚假连接,我们使用Websocket的控制协议来完成心跳,服务器会定时给客户端发送控制帧Ping消息,客户端应该在收到此消息回复控制帧Pong ,如果客户端没有及时回应,服务器将会主动断开此连接。

Demos

  Nodejs   Python

消息格式

每条消息包含实时行情数组,每条实时行情格式如下:

Name Type Description
symbol string 交易品种名称
time int64 Unix 时间戳,毫秒,GMT+0 时区
ask double 买入价
bid double 卖出价

返回示例

{
  "quote":[
    {
    "symbol": "EURUSD",
    "time": 1470982944,
    "ask":1.11436,
    "bid":1.11426
    },
    {
    "symbol": "USDJPY",
    "time": 1470982944,
    "ask":109.04,
    "bid":109.03
    }
  ]
}

2. 查询历史Tick数据

GET /v1/history/tick?symbol={symbol}&starttime={starttime}

支持获取指定交易品种symbol,请求时间starttime当前分钟的历史 Tick 数据,默认为当前请求时间。注意,所有数据时间的时区均为GMT+0,包括请求和返回的数据时间。

Request Parameters

Name Required Type Origin Description
symbol yes string Route 交易品种名称
starttime string Route 查询该时间当前分钟内的 Tick 数据,格式:YYYYmmDDHHMM
没有填写则默认为当前分钟,注意为 GMT+0 时区

Response

Name Type Description
msg string 错误信息
code int 错误码
time int64 Unix 时间戳,毫秒,GMT+0 时区
new_price double 最新价
ask double 买入价
bid double 卖出价
ask_depth string数组 买入量
bid_depth string数组 卖出量

Example

请求示例

GET /v1/history/tick?symbol=EURUSD

返回示例:成功

{
    "msg": "ok",
    "data": [
        {
            "time": 1470395911411,
            "new_price": 0,
            "ask": 1.34076,
            "ask_depth": [],
            "bid": 1.34074,
            "bid_depth": []
        },
        {
            "time": 1470395909405,
            "new_price": 0,
            "ask": 1.34081,
            "ask_depth": [],
            "bid": 1.34079,
            "bid_depth": []
        },
        {
            "time": 1470395908733,
            "new_price": 0,
            "ask": 1.34081,
            "ask_depth": [],
            "bid": 1.34079,
            "bid_depth": []
        }
    ]
}

返回示例:失败

{
    "msg": "err",
    "code": 5001
}

3. 查询历史行情数据

GET /v1/history/bar?bars={bars}&symbol={symbol}&period={period}&type={type}&endtime={endtime}

支持获取指定交易品种symbol的历史行情,单次请求数据最多不超过200条。默认情况下,行情数据类型typebid价,截止时间endtime为当前请求时间。注意,所有数据时间的时区均为GMT+0,包括请求和返回的数据时间。

Request Parameters

Name Required Type Origin Description
bars int Route 历史行情数据条数,单次请求最多不超过200(按时间倒序)
没有填写则默认100条
当查询m1的bar且没有数据返回时,表示近期没有可用的bar,可往前推8小时再查询
symbol yes string Route 交易品种名称
period string Route 历史行情数据周期:
m1,m5,m15,m30,h1,h4,d1,w1,mn1
没有填写则默认 m1
type int Route 行情数据的类型,
0:ask,1:bid,2:mid,
没有填写则默认为1
endtime string Route 截止时间点,格式:YYYYmmDDHHMM
没有填写则默认为当前时间,注意为 GMT+0 时区

Response

Name Type Description
msg string 错误信息
code int 错误码
time string 数据时间,注意为 GMT+0 时区
open double 开盘价
high double 最高价
low double 最低价
close double 收盘价
volume double 成交量(手)
amount double 成交额

Example

请求示例

GET /v1/history/bar?bars=2&symbol=EURUSD&period=m1

返回示例:成功

{
    "msg": "OK",
    "data":[
      {
        "time":"201608110831",
        "open":1.11426,
        "high":1.11436,
        "low":1.11426,
        "close":1.11433,
        "volume":0,
        "amount":0
      },
      {
        "time":"201608110830",
        "open":1.11415,
        "high":1.11427,
        "low":1.11414,
        "close":1.11419,
        "volume":0,
        "amount":0
      }
    ]
}

返回示例:失败

{
    "msg": "err",
    "code": 5001
}

4. Error 错误处理

错误码表(Error Code)

Code Message Description
5001 参数错误
5002 租户无此品种
5003 数据量已使用完成
300001 权限错误
300002 服务端忙,稍后再试
300003 处理超时
其他 服务出错

results matching ""

    No results matching ""