単一商品 K ライン - AllTick API

インターフェース説明

過去の K ラインを照会します。1 回のリクエストで照会できる商品は 1 つです。

GET /v1/kline/{queryData}

米国株、香港株、A 株、主要指数のリクエスト例： https://quote.alltick.co/quote-stock-b-api/v1/kline/{queryData} 外国為替、貴金属、暗号資産、原油、CFD 指数、商品先物のリクエスト例： https://quote.alltick.co/quote-b-api/v1/kline/{queryData}

リクエストパラメータ

パラメータ	型	必須	説明
`X-API-Key`	string	はい	認証トークン
`queryData`	string	はい	リクエスト内容

queryData

{
  "trace": "3baaa938-f92c-4a74-a228-fd49d5e2f8bc-1678419657806",
  "data": {
    "code": "857.HK",
    "kline_type": 1,
    "kline_timestamp_end": 0,
    "query_kline_num": 2,
    "adjust_type": 0
  }
}

名前	型	必須	説明
`trace`	string	はい	ログ検索用の追跡 ID。リクエストごとに一意の値を指定してください
`data`	object	はい	リクエストデータ
`code`	string	はい	商品コード。大文字・小文字は商品一覧と一致させてください
`kline_type`	integer	はい	1=1 分足、2=5 分足、3=15 分足、4=30 分足、5=1 時間足、6=2 時間足、7=4 時間足、8=日足、9=週足、10=月足。株式は 2 時間足と 4 時間足に非対応
`kline_timestamp_end`	integer	はい	0 は最新の取引日から過去へ照会。外国為替、貴金属、暗号資産はタイムスタンプを指定できますが、株式は非対応
`query_kline_num`	integer	はい	1 回の最大取得本数は 500。前日の終値を照会する場合は 2 を指定し、`kline_type` を 8 に設定
`adjust_type`	integer	はい	株式の株価調整種別：0=権利落ち、1=前方調整。現在は 0 のみ対応

レスポンス例

{
  "ret": 200,
  "msg": "ok",
  "trace": "3baaa938-f92c-4a74-a228-fd49d5e2f8bc-1678419657806",
  "data": {
    "code": "857.HK",
    "kline_type": 1,
    "kline_list": [
      {
        "timestamp": "1677829200",
        "open_price": "136.421",
        "close_price": "136.412",
        "high_price": "136.422",
        "low_price": "136.407",
        "volume": "0",
        "turnover": "0"
      },
      {
        "timestamp": "1677829260",
        "open_price": "136.412",
        "close_price": "136.401",
        "high_price": "136.415",
        "low_price": "136.397",
        "volume": "0",
        "turnover": "0"
      }
    ]
  }
}

レスポンスフィールド

名前	型	説明
`ret`	integer	レスポンスコード
`msg`	string	レスポンスメッセージ
`trace`	string	リクエストの追跡 ID
`code`	string	商品コード
`kline_type`	integer	K ライン種別
`kline_list`	array	K ライン一覧
`timestamp`	string	K ラインのタイムスタンプ
`open_price`	string	始値
`close_price`	string	終値。取引時間中の最新足では直近約定価格、休場中は終値
`high_price`	string	高値
`low_price`	string	安値
`volume`	string	出来高
`turnover`	string	売買代金