電力価格予測

価格予測APIを使用して、日本のすべての送配電エリアにおけるJEPX電力価格の最新のTensor AI予測を取得します。新しい翌日予測は毎日6:00 JSTから利用可能です。

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

パス: /price-forecast

メソッド: GET

クエリパラメータ

リクエストの一部としてクエリパラメータが提供されない場合、デフォルトの期間は[今日, 今日 + 3日]となります。

フィールド	タイプ	説明	必須
from	string	予測を取得するための開始時間。次の形式で表現: 2006-01-02T15:04:05Z。	いいえ
to	string	予測を取得するための終了時間。次の形式で表現: 2006-01-02T15:04:05Z。fromとtoの間隔は31日を超えることはできません。	いいえ

レスポンス

レスポンスは、次のフィールドを持つnull不可のJSONオブジェクトです。

フィールド	タイプ	説明
data	[PriceForecastSet] | null	クエリから返されたデータ。errorがnullでない場合、この値はnullになります。
error	Error | null	クエリから返されたエラー。dataがnullでない場合、この値はnullになります。

PriceForecastSetオブジェクト

フィールド	タイプ	説明
datetime	string	JEPX時間枠のタイムスタンプ。ISO 8601準拠のUTCタイムスタンプで表現。
prices	ZonePrices	すべてのエリアプライスを含むオブジェクト。すべてJPY/kWhで表現されます。

ZonePricesオブジェクト

このオブジェクトのすべてのフィールドはnull可能です。

フィールド	タイプ	説明
chugoku	float | null	中国エリアプライス（JPY/kWh）
chubu	float | null	中部エリアプライス（JPY/kWh）
kyushu	float | null	九州エリアプライス（JPY/kWh）
hokkaido	float | null	北海道エリアプライス（JPY/kWh）
hokuriku	float | null	北陸エリアプライス（JPY/kWh）
tokyo	float | null	東京エリアプライス（JPY/kWh）
kansai	float | null	関西エリアプライス（JPY/kWh）
tohoku	float | null	東北エリアプライス（JPY/kWh）
shikoku	float | null	四国エリアプライス（JPY/kWh）
okinawa	float | null	沖縄エリアプライス（JPY/kWh）
system	float | null	システム価格（JPY/kWh）

Errorオブジェクト

フィールド	タイプ	説明
message	string	問題が発生したことを説明するメッセージ。
code	internal_server_error | invalid_query_parameter	発生したエラーコード。

リクエスト例

cURL

curl --request GET \
     --url https://api.tensorenergy.jp/v1/price-forecast \
     --header "authorization: Bearer ${API_TOKEN}"

Python

import requests

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

headers = {
    'authorization': f'Bearer {API_TOKEN}',
}

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

print(response.json())

Typescript

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

const fetchData = async () => {
    try {
        const response = await fetch(API_URL, {
          method: 'GET',
          headers: {
            'authorization': `Bearer ${API_TOKEN}`
          }
        })
        console.log(response)
    } catch (error) {
        console.error(error)
    }
};

fetchData()

レスポンス例

操作中にエラーが発生しない場合

{
  "data": [
    {
      "datetime": "2022-01-01T15:00:00Z",
      "prices": {
        "chugoku": 10.1,
        "chubu": 10.1,
        "kyushu": 10.1,
        "hokkaido": 10.1,
        "hokuriku": 10.1,
        "tokyo": 10.1,
        "kansai": 10.1,
        "tohoku": 10.1,
        "shikoku": 10.1,
        "okinawa": null,
        "system": 10.1
      }
    },
    {
      "datetime": "2022-01-01T15:30:00Z",
      "prices": {
        "chugoku": 10.1,
        "chubu": 10.1,
        "kyushu": 10.1,
        "hokkaido": 10.1,
        "hokuriku": 10.1,
        "tokyo": 10.1,
        "kansai": 10.1,
        "tohoku": 10.1,
        "shikoku": 10.1,
        "okinawa": null,
        "system": 10.1
      }
    }
  ],
  "error": null
}

操作中にエラーが発生する場合

{
  "data": null,
  "error": {
    "message": "something went wrong during the process",
    "code": "internal_server_error"
  }
}

期間内に予測が存在しない場合

{
  "data": [],
  "error": null
}