電力価格の予測

電力価格予測APIのエンドポイントにより、系統エリア毎のTensor AIが生成したJEPX価格の予測値が取得できます。新しい予測は、毎日日本時間午前6:00に生成されます。

ベースURL: https://api.tensorenergy.jp/v1

パス: /service-price-forecast

リクエストメソッド: GET

パラメーター

このAPIにはクエリパラメーターは必要ありません。

レスポンス

全てのフィールドはnull不可です。レスポンスは、以下のフィールドを含むJSONオブジェクトの配列です。

フィールド	タイプ	概要
t	string	UTCでのISO 8601形式の予測タイムスタンプ
v	ZonePrices	すべての系統エリアの予測価格を含むJSONオブジェクト

ZonePricesオブジェクト

全てのフィールドはnull可です。

フィールド	タイプ	概要
chg	float	中国電力の系統エリア価格（JPY/kWh）
chb	float	中部電力の系統エリア価格（JPY/kWh）
kyu	float	九州電力の系統エリア価格（JPY/kWh）
hkd	float	北海道電力の系統エリア価格（JPY/kWh）
hok	float	北陸電力の系統エリア価格（JPY/kWh）
tok	float	東京電力の系統エリア価格（JPY/kWh）
kan	float	関西電力の系統エリア価格（JPY/kWh）
toh	float	東北電力の系統エリア価格（JPY/kWh）
shi	float	四国電力の系統エリア価格（JPY/kWh）
oki	float	沖縄電力の系統エリア価格（JPY/kWh）
sys	float	システム価格（JPY/kWh）

リクエストの例

cURL

curl --request GET \
     --url https://api.tensorenergy.jp/service-price-forecast \
     --header 'x-api-key: ${API_TOKEN}'

Python

import requests

API_URL = 'https://api.tensorenergy.jp/service-price-forecast'
API_TOKEN = 'YOUR_API_KEY'

headers = {
    'x-api-key': f'{API_TOKEN}',
}

response = requests.get(API_URL, headers=headers)

print(response.json())

Typescript

import axios from 'axios';

const API_URL = 'https://api.tensorenergy.jp/service-price-forecast';
const API_TOKEN = 'YOUR_API_KEY';

const fetchData = async () => {
    try {
        const response = await axios.get(API_URL, {
            headers: {
                'x-api-key': `${API_TOKEN}`,
            },
        });
        console.log(response.data);
    } catch (error) {
        console.error(error);
    }
};

fetchData();

レスポンスの例

[
  {
    "t": "2022-01-01T15:00:00Z",
    "v": {
      "chg": 10.1,
      "chb": 10.1,
      "kyu": 10.1,
      "hkd": 10.1,
      "hok": 10.1,
      "tok": 10.1,
      "kan": 10.1,
      "toh": 10.1,
      "shi": 10.1,
      "oki": null,
      "sys": 10.1 
    }
  },
  {
    "t": "2022-01-01T15:30:00Z", 
    "v": {
      "chg": 10.1,
      "chb": 10.1,
      "kyu": 10.1,
      "hkd": 10.1,
      "hok": 10.1,
      "tok": 10.1,
      "kan": 10.1,
      "toh": 10.1,
      "shi": 10.1,
      "oki": null,
      "sys": 10.1 
    }
  }
]