メインコンテンツへスキップ

​
GET /api/suspension

​
インターフェース説明

このインターフェースは、世界主要取引所（SSE、NYSE、NASDAQ）の売買停止・再開情報照会を提供します。すべてのインターフェースはJSONデータを返し、公告時刻の降順で並びます。

​
リクエスト頻度

プラン単一インターフェースの単独リクエスト複数HTTPインターフェースを同時にリクエスト
無料1分に1回1. 10秒に1つのインターフェースのみリクエスト可能。
2. 複数インターフェースをリクエストする場合、/batch-kline インターフェースは10秒間隔が必要です。
3. すべてのインターフェース合計で1分あたり最大10回（6秒に1回）。
4. 1日の最大リクエスト数は1,000回。超過した場合は翌日未明に利用が回復します。
ベーシック1分に1回1. 同一秒内に1つのインターフェースのみリクエスト可能。
2. 複数インターフェースをリクエストする場合、/batch-kline インターフェースは3秒間隔が必要です。
3. すべてのインターフェース合計で1分あたり最大60回（1秒に1回）。
4. 1日の最大リクエスト数は86,400回。超過した場合は翌日未明に利用が回復します。
アドバンス1分に1回1. すべてのインターフェース合計で1秒あたり10回までリクエスト可能。
2. 複数インターフェースをリクエストする場合、/batch-kline インターフェースは2秒間隔が必要です。
3. すべてのインターフェース合計で1分あたり最大600回（1秒に10回）。
4. 1日の最大リクエスト数は864,000回。
プロフェッショナル1分に1回1. すべてのインターフェース合計で1秒あたり20回までリクエスト可能。
2. 複数インターフェースをリクエストする場合、/batch-kline インターフェースは1秒間隔が必要です。
3. すべてのインターフェース合計で1分あたり最大1,200回（1秒に20回）。
4. 1日の最大リクエスト数は1,728,000回。
香港株すべて1分に1回1. すべてのインターフェース合計で1秒あたり20回までリクエスト可能。
2. 複数インターフェースをリクエストする場合、/batch-kline インターフェースは1秒間隔が必要です。
3. すべてのインターフェース合計で1分あたり最大1,200回（1秒に20回）。
4. 1日の最大リクエスト数は1,728,000回。
A株すべて1分に1回1. すべてのインターフェース合計で1秒あたり20回までリクエスト可能。
2. 複数インターフェースをリクエストする場合、/batch-kline インターフェースは1秒間隔が必要です。
3. すべてのインターフェース合計で1分あたり最大1,200回（1秒に20回）。
4. 1日の最大リクエスト数は1,728,000回。
米国株すべて1分に1回1. すべてのインターフェース合計で1秒あたり20回までリクエスト可能。
2. 複数インターフェースをリクエストする場合、/batch-kline インターフェースは1秒間隔が必要です。
3. すべてのインターフェース合計で1分あたり最大1,200回（1秒に20回）。
4. 1日の最大リクエスト数は1,728,000回。

​
インターフェース制限

  1. 必ずお読みください: HTTPインターフェース制限
  2. 必ずお読みください: エラーコード説明

​
インターフェースURL

1. 上海証券取引所の売買停止・再開情報を照会: 2. ニューヨーク証券取引所の売買停止・再開情報を照会: 3. NASDAQの売買停止・再開情報を照会:

​
リクエスト例

​
1. SSEデータ取得インターフェース

​
インターフェース情報

  • URL: /api/suspension/sse
  • Method: GET
  • 説明: 上海証券取引所（SSE）のすべての売買停止・再開情報を取得します。

​
リクエストパラメータ

フィールド型必須説明
tokenstringはいユーザー購読token
pageintegerいいえ照会ページ番号
sizeintegerいいえページサイズ

​
レスポンス例

{
  "success": true,
  "timestamp": "2024-01-15T10:30:00",
  "totalCount": 125,
  "data": [
    {
      "symbol": "600000",
      "symbolName": "Shanghai Pudong Development Bank",
      "haltReason": "Trading halt due to major matters",
      "haltDate": "2024-01-15",
      "haltTime": "09:30:00",
      "haltPeriod": "Full-day trading halt",
      "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フィールド（売買停止・再開情報リスト内のオブジェクト）

フィールド型Null可説明
» symbolstringいいえ株式コード
» symbolNamestringはい株式名
» haltReasonstringはい売買停止理由
» haltDatestringはい売買停止日
» haltTimestringはい売買停止時刻
» haltPeriodstringはい売買停止期間
» resumeDatestringはい売買再開日
» resumeTimestringはい売買再開時刻
» publishDatestringいいえ公告時刻

​
呼び出し例

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

​
2. NYSEデータ取得インターフェース

​
インターフェース情報

  • URL: /api/suspension/nyse
  • Method: GET
  • 説明: ニューヨーク証券取引所（NYSE）のすべての売買停止・再開情報を取得します。

​
リクエストパラメータ

フィールド型必須説明
tokenstringはいユーザー購読token
pageintegerいいえ照会ページ番号
sizeintegerいいえページサイズ

​
レスポンス例

{
  "success": true,
  "timestamp": "2024-01-15T10:30:00",
  "totalCount": 89,
  "data": [
    {
      "symbol": "AAPL",
      "haltReason": "News pending",
      "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フィールド（売買停止・再開情報リスト内のオブジェクト）

フィールド型Null可説明
» symbolstringいいえ株式コード
» symbolNamestringはい株式名
» haltReasonstringはい売買停止理由
» haltTimestringはい売買停止時刻
» haltDateTimestringはい売買停止日時
» resumeDatestringはい売買再開日
» resumeTimestringはい売買再開時刻
» resumeDateTimestringはい売買再開日時
» sourceExchangestringはい取引所コード
» publishDatestringいいえ公告時刻

​
呼び出し例

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

​
3. NASDAQデータ取得インターフェース

​
インターフェース情報

  • URL: /api/suspension/nasdaq
  • Method: 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": "Volatility halt",
      "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フィールド（売買停止・再開情報リスト内のオブジェクト）

フィールド型Null可説明
» symbolstringいいえ株式コード
» symbolNamestringはい株式名
» haltDatestringはい売買停止日
» haltTimestringはい売買停止時刻
» haltDateTimestringはい売買停止日時
» sourceExchangestringはい取引所コード
» haltReasonstringはい売買停止理由
» pauseThresholdPricestringはい停止しきい値価格
» resumeDatestringはい売買再開日
» resumeTimestringはい気配再開時刻
» resumeDateTimestringはい取引再開時刻
» publishDatestringいいえ公告時刻

​
呼び出し例

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

​
エラーレスポンス

すべてのインターフェースでエラーが発生した場合、次の形式を返します。 
{
  "success": false,
  "error": "Error description information"
}
HTTPステータスコード: 500

​
エラーレスポンスフィールド説明

フィールド型必須説明
successbooleanはいリクエストが成功したかどうか。false固定です。
errorstringはいエラー説明情報

​
注意事項

  1. すべてのインターフェースはページングに対応しておらず、直近1年の全データを返します。
  2. データは公告時刻の降順（最新が先）で並びます。
  3. レスポンス内の時刻形式:
    • timestampフィールド: ISO形式（yyyy-MM-dd’T’HH:mm:ss）
    • その他の時刻フィールド: yyyy-MM-dd HH:mm:ss
  4. 適切なタイムアウトを設定することを推奨します。データ量が大きい場合はより長い時間が必要になることがあります。
  5. 空フィールドの説明:
    • 「いいえ」: フィールドには必ず値があり、nullにはなりません。
    • 「はい」: フィールドはnullまたは空文字列の場合があります。呼び出し側で空値を処理してください。

​
AllTickウェブサイト

公式サイト: https://alltick.co/

​
インターフェースデバッグ

SSE 売買停止・再開インターフェースをデバッグ

NYSE 売買停止・再開インターフェースをデバッグ

NASDAQ 売買停止・再開インターフェースをデバッグ