跳转到主要内容

​
GET /api/suspension

​
接口说明

该接口提供全球主要交易所（SSE、NYSE、NASDAQ）的停复牌信息查询，所有接口均返回 JSON 格式数据，按公告时间倒序排列。

​
请求频率

计划单个接口单独请求同时请求多个http接口
免费每1分钟只能1次请求

1、10秒只能请求1个接口

2、多个接口请求时，需注意/batch-kline接口需间隔10秒
3、所有接口相加，1分钟最大请求10次(6秒1次)
4、每天总共最大可请求1000次，超过则第二天凌晨恢复使用

基础每1分钟只能1次请求

1、同1秒只能请求1个接口

2、多个接口请求时，需注意/batch-kline接口需间隔3秒
3、所有接口相加，1分钟最大请求60次(1秒1次)
4、每天总共最大可请求86400次，超过则第二天凌晨恢复使用

高级每1分钟只能1次请求

1、所以接口相加，每1秒可请求10次

2、多个接口请求时，需注意/batch-kline接口需间隔2秒
3、所有接口相加，1分钟最大请求600次(1秒10次)
4、每天总共最大可请求864000次，超过则第二天凌晨恢复使用

专业每1分钟只能1次请求

1、所以接口相加，每1秒可请求20次

2、多个接口请求时，需注意/batch-kline接口需间隔1秒
3、所有接口相加，1分钟最大请求1200次(1秒20次)
4、每天总共最大可请求1728000次，超过则第二天凌晨恢复使用

全部港股每1分钟只能1次请求

1、所以接口相加，每1秒可请求20次

2、多个接口请求时，需注意/batch-kline接口需间隔1秒
3、所有接口相加，1分钟最大请求1200次(1秒20次)
4、每天总共最大可请求1728000次，超过则第二天凌晨恢复使用

全部A股每1分钟只能1次请求

1、所以接口相加，每1秒可请求20次

2、多个接口请求时，需注意/batch-kline接口需间隔1秒
3、所有接口相加，1分钟最大请求1200次(1秒20次)
4、每天总共最大可请求1728000次，超过则第二天凌晨恢复使用

全部美股每1分钟只能1次请求

1、所以接口相加，每1秒可请求20次

2、多个接口请求时，需注意/batch-kline接口需间隔1秒
3、所有接口相加，1分钟最大请求1200次(1秒20次)
4、每天总共最大可请求1728000次，超过则第二天凌晨恢复使用

​
接口限制

1、请务必阅读：HTTP接口限制说明 2、请务必阅读：错误码说明

​
接口地址

1、查询上海证券交易所停复牌信息： 2、查询纽约证券交易所停复牌信息： 3、查询纳斯达克交易所停复牌信息：

​
请求示例

​
1. 获取上证所数据接口

​
接口信息

  • URL: /api/suspension/sse
  • 方法: GET
  • 描述: 获取上海证券交易所（SSE）全部停复牌信息

​
请求参数

字段名类型是否必填描述
tokenstring是用户套餐token
pageinteger否查询页码
sizeinteger否每页数据大小

​
响应示例

{
  "success": true,
  "timestamp": "2024-01-15T10:30:00",
  "totalCount": 125,
  "data": [
    {
      "symbol": "600000",
      "symbolName": "浦发银行",
      "haltReason": "重大事项停牌",
      "haltDate": "2024-01-15",
      "haltTime": "09:30:00",
      "haltPeriod": "全天停牌",
      "resumeDate": "2024-01-16",
      "resumeTime": "09:30:00",
      "publishDate": "2024-01-14 18:00:00"
    }
  ]
}

​
响应字段说明

字段名类型是否必填描述
» successboolean是请求是否成功
» timestampstring是响应时间戳（格式：yyyy-MM-dd’T’HH:mm:ss）
» totalCountinteger是数据总条数
» dataarray是停复牌信息列表
» totalPagesinteger否数据总页数（分页查询时返回）
» currentPageinteger否当前页（分页查询时返回）
» currentSizeinteger否当前页的数据条数（分页查询时返回）

​
data字段（停复牌信息列表中的对象）

字段名类型是否允许为空描述
» symbolstring否股票代码
» symbolNamestring是股票名称
» haltReasonstring是停牌原因
» haltDatestring是停牌日期
» haltTimestring是停牌时间
» haltPeriodstring是停牌期限
» resumeDatestring是复牌日期
» resumeTimestring是复牌时间
» publishDatestring否公告时间

​
调用示例

curl -X GET "https://quote.alltick.co/api/suspension/sse?token=您的Token&page=1&size=10" -H "Accept: application/json"

​
2. 获取纽交所数据接口

​
接口信息

  • URL: /api/suspension/nyse
  • 方法: GET
  • 描述: 获取纽约证券交易所（NYSE）全部停复牌信息

​
请求参数

字段名类型是否必填描述
tokenstring是用户套餐token
pageinteger否查询页码
sizeinteger否每页数据大小

​
响应示例

{
  "success": true,
  "timestamp": "2024-01-15T10:30:00",
  "totalCount": 89,
  "data": [
    {
      "symbol": "AAPL",
      "haltReason": "新闻待公布",
      "haltDate": "2024-01-15",
      "haltTime": "10:15:00",
      "haltDateTime": "2024-01-15 10:15:00",
      "resumeDate": "2024-01-15",
      "resumeTime": "11:00:00",
      "resumeDateTime": "2024-01-15 11:00:00",
      "sourceExchange": "NYSE",
      "publishDate": "2024-01-15 10:10:00"
    }
  ]
}

​
响应字段说明

字段名类型是否必填描述
» successboolean是请求是否成功
» timestampstring是响应时间戳（格式：yyyy-MM-dd’T’HH:mm:ss）
» totalCountinteger是数据总条数
» dataarray是停复牌信息列表
» totalPagesinteger否数据总页数（分页查询时返回）
» currentPageinteger否当前页（分页查询时返回）
» currentSizeinteger否当前页的数据条数（分页查询时返回）

​
data字段（停复牌信息列表中的对象）

字段名类型是否允许为空描述
» symbolstring否股票代码
» symbolNamestring是股票名称
» haltReasonstring是停牌原因
» haltTimestring是停牌时间
» haltDateTimestring是停牌日期时间
» resumeDatestring是复牌日期
» resumeTimestring是复牌时间
» resumeDateTimestring是复牌日期时间
» sourceExchangestring是交易所代码
» publishDatestring否公告时间

​
调用示例

curl -X GET "https://quote.alltick.co/api/suspension/nyse?token=您的Token&page=1&size=10" -H "Accept: application/json"

​
3. 获取纳斯达克数据接口

​
接口信息

  • URL: /api/suspension/nasdaq
  • 方法: GET
  • 描述: 获取纳斯达克交易所（NASDAQ）全部停复牌信息

​
请求参数

字段名类型是否必填描述
tokenstring是用户套餐token
pageinteger否查询页码
sizeinteger否每页数据大小

​
响应示例

{
  "success": true,
  "timestamp": "2024-01-15T10:30:00",
  "totalCount": 156,
  "data": [
    {
      "symbol": "GOOGL",
      "haltDate": "2024-01-15",
      "haltTime": "13:45:00",
      "haltDateTime": "2024-01-15 13:45:00",
      "sourceExchange": "NASDAQ",
      "haltReason": "波动性暂停",
      "pauseThresholdPrice": "145.50",
      "resumeDate": "2024-01-15",
      "resumeTime": "14:00:00",
      "resumeDateTime": "2024-01-15 14:00:00",
      "publishDate": "2024-01-15 13:44:30"
    }
  ]
}

​
响应字段说明

字段名类型是否必填描述
» successboolean是请求是否成功
» timestampstring是响应时间戳（格式：yyyy-MM-dd’T’HH:mm:ss）
» totalCountinteger是数据总条数
» dataarray是停复牌信息列表
» totalPagesinteger否数据总页数（分页查询时返回）
» currentPageinteger否当前页（分页查询时返回）
» currentSizeinteger否当前页的数据条数（分页查询时返回）

​
data字段（停复牌信息列表中的对象）

字段名类型是否允许为空描述
» symbolstring否股票代码
» symbolNamestring是股票名称
» haltDatestring是停牌日期
» haltTimestring是停牌时间
» haltDateTimestring是停牌日期时间
» sourceExchangestring是交易所代码
» haltReasonstring是停牌原因
» pauseThresholdPricestring是暂停阈值价格
» resumeDatestring是恢复日期
» resumeTimestring是恢复报价时间
» resumeDateTimestring是恢复交易时间
» publishDatestring否公告时间

​
调用示例

curl -X GET "https://quote.alltick.co/api/suspension/nasdaq?token=您的Token&page=1&size=10" -H "Accept: application/json"

​
错误响应

所有接口在发生错误时返回以下格式： 
{
  "success": false,
  "error": "错误描述信息"
}
HTTP状态码: 500

​
错误响应字段说明

字段名类型是否必填描述
successboolean是请求是否成功，固定为false
errorstring是错误描述信息

​
注意事项

  1. 所有接口均不支持分页，返回最近一年的全量数据
  2. 数据已按公告时间倒序排列（最新的在前）
  3. 响应中的时间格式：
    • timestamp字段：ISO格式（yyyy-MM-dd'T'HH:mm:ss）
    • 其他时间字段：yyyy-MM-dd HH:mm:ss
  4. 建议设置适当的超时时间，大数据量时可能需要较长时间
  5. 字段为空说明：

​
AllTick网站

官方网站：https://alltick.co/

​
接口调试

调试 SSE 停复牌接口

调试 NYSE 停复牌接口

调试 NASDAQ 停复牌接口