错误处理
大约 3 分钟
返回码以及对应描述信息
对应公共响应参数中的code和message，用来描述业务请求的结果，对应说明如下：
| code | message | 备注 |
|---|---|---|
| 0 | success | 请求成功 |
| 1 | server error | 当遇到请求参数无法处理时，或服务端本身服务异常时，会返回该状态码 |
| 2 | network read time out | 请求网络超时，需要检测网络状况如何，可以考虑和OpenAPI的服务就近部署，或使用稳定的专线服务 |
| 4 | access forbidden | 拒绝访问，可能的原因： 1.如果设置的IP白名单，但是发起请求的机器并不在白名单内 2.可能由于账号的频繁请求，或错误请求过多，导致被加入了黑名单 3.长连接验证签名失败 4.长连接订阅的标的过多，超过了限额 |
| 5 | rate limit error | 请求频率超过限制，这种情况下返回的http状态码是429，同时在错误消息中会返回单位时间内的限制次数说明 |
| 1000 | common param error | 解析公共参数出现会导致返回该导致，可能的原因： 1.请求的方法不支持(method参数错误) 2.请求的URL地址错误 3.请求的参数不是标准JSON格式 4.公共参数（非bizContent）校验出错，比如timestamp格式错误，字段为空，sign签名字段校验出错等 |
| 1010 | biz param error | 解析bizContent参数出错，可能的原因： 业务参数校验出错（比如begin_time格式错误，sec_type不支持） |
| 1100 | global account response error | 环球账号交易错误，比如： 1.TRADE DUPLICATE ORDER ID：交易订单号重复 2.TRADE ORDER NOT ALLOWED：当前不允许下单 |
| 1200 | prime account response error | 综合账号交易错误，比如： 1.BAD_REQUEST:Orders cannot be place at this moment:当前时间无法进行下单操作 2.BAD_REQUEST:You cannot place market or stop order during pre-market and after-hours trading：美股盘前盘后阶段无法下市价单和止损单 3.The order quantity you entered exceeds your currently available position：下单数量超过了可交易数量 4.bad_request:We don’t support trading of this stock now：不支持该只标的交易 |
| 1300 | paper account response error | 模拟账号交易错误，错误描述和综合账号返回基本一致 |
| 2100 | stock response error | 股票行情相关错误 |
| 2200 | option response error | 期权行情相关错误 |
| 2300 | futures response error | 期货行情相关错误 |
| 3xxx | subscribe error | 订阅数据相关错误，可能的原因： 1.订阅时的tigerId异常 2.订阅时发生了服务端异常 3.不支持的行情提供商参数 4.不支持的订阅类型 5.订阅数超过了限制要求 |
| 4000 | permission denied | 访问权限不足，访问被拒绝，可能的原因： 1.请求K线行情的时间段超过了被允许的范围 2.请求分时数据的时间段超过了被允许的范围 3.请求行情的设备不在允许范围内（多台设备同时抢占时只支持一个设备使用行情） 4.行情权限不符合要求 |
| 4001 | kick out by a new connection | 长连接通道已被新建立的连接踢出 |