GridPulse: U.S. Energy Data

⚡ GridPulse

AI エージェント向けの、米国エネルギー市場データの従量課金 API です。エージェントは x402 プロトコルを使用し、Algorand または Base 上の USDC でリクエストごとに支払います。購入者の登録も API キーも不要です。

エンドポイント	価格	返される内容
GET /v1/grid-mix?region=ERCO	$0.02	電力系統地域の最新の1時間ごとの発電構成（燃料別の MWh、再生可能エネルギーおよびカーボンフリーの割合）
GET /v1/retail-price?state=CT&sector=RES	$0.01	州および部門別の小売電力価格、前年同期比、過去12か月の履歴
GET /v1/henry-hub	$0.01	ヘンリーハブの天然ガス現物価格、過去30日間の統計と履歴
GET /v1/seller-check?url=…	$0.01	x402 販売者チェック： あらゆる x402 販売者の信頼性スコア（0～100）。稼働状況のプローブ、決済履歴、運用期間、購入者の多様性を評価します
GET /v1/sellers/search?q=weather&maxPrice=0.05	$0.02	タスクに適した信頼できる x402 販売者を検索し、販売者チェックのスコア順に表示します
GET /v1/algorand/network-health	$0.008	Algorand のブロック時間、TPS、オンラインステーク比率、健全性（Algorand 上の USDC のみ）
GET /v1/algorand/account?address=…	$0.01	使用可能な ALGO、手数料を支払えるか、USDC を受け取れるか、ステーキングとリキーのステータス（Algorand 上の USDC のみ）
GET /v1/algorand/asset?id=31566704	$0.015	ASA の供給量、Pera の検証レベル、クローバック／凍結リスクのフラグ（Algorand 上の USDC のみ）
GET /v1/algorand/tx?id=…	$0.01	デコード済みのメモを含む、トランザクションの平易な説明（Algorand 上の USDC のみ）
GET /v1/crypto/market-pulse	$0.015	Coinbase と Kraken で照合した ALGO／BTC／ETH／SOL／USDC の価格（Algorand 上の USDC のみ）

Algorand MainNet で稼働中： https://noahs-mac-mini.tail571e99.ts.net

無料：/（ランディングページ）、/llms.txt（エージェント向けドキュメント）、/health。 データソース：米国エネルギー情報局（パブリックドメイン）。

エージェントから利用する

どの x402 クライアントでも利用できます。エンドポイントを呼び出し、402 Payment Required を受け取ったら支払い、再試行します。@x402/fetch ラッパーを使えば、これらすべてが自動的に行われます。

• OpenAPI 仕様：https://noahs-mac-mini.tail571e99.ts.net/openapi.json
• エージェント向けドキュメント：https://noahs-mac-mini.tail571e99.ts.net/llms.txt

Base 上の USDC で支払う（npm i @x402/fetch @x402/evm viem）：

import { x402Client, wrapFetchWithPayment } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { toClientEvmSigner } from "@x402/evm";
import { createPublicClient, http } from "viem";
import { base } from "viem/chains";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
const signer = toClientEvmSigner(account, createPublicClient({ chain: base, transport: http() }));
const client = new x402Client().register("eip155:8453", new ExactEvmScheme(signer));
const fetchWithPay = wrapFetchWithPayment(fetch, client);

const res = await fetchWithPay("https://noahs-mac-mini.tail571e99.ts.net/v1/grid-mix?region=CISO");
console.log(await res.json());

Algorand 上の USDC で支払う： src/pay.ts を参照してください（@x402/avm を使用）。

MCP サーバー（Claude Desktop、Claude Code、Cursor、…）

ワンクリック（Claude Desktop）： gridpulse-mcp.mcpb をダウンロードして開き、必要に応じて少額の支払い用ウォレットを入力します。公式 MCP Registry にも io.github.noah-silver/gridpulse として掲載されています。

または、手動で設定します。

GridPulse をツール（grid_mix、retail_electricity_price、henry_hub_gas_price）として追加します。各ツールの呼び出しでは、x402 経由でご自身のウォレットから支払います。少額の支払い専用ウォレットを使用し、メインのウォレットは使用しないでください。

{
  "mcpServers": {
    "gridpulse": {
      "command": "npx",
      "args": ["-y", "github:noah-silver/gridpulse"],
      "env": { "EVM_PRIVATE_KEY": "0x… (Base wallet holding a little USDC)" }
    }
  }
}

Algorand 上の USDC で支払うには、EVM_PRIVATE_KEY の代わりに（またはこれに加えて）ALGORAND_MNEMONIC を使用してください。

---

セットアップガイド（Mac mini）

Mac mini のターミナルで、各コマンドを1つずつ実行してください。

1. Node.js をインストールする

brew install node

brew が見つからない場合は、まず https://brew.sh から Homebrew をインストールしてください。

2. コードを取得してインストールする

この gridpulse フォルダーを Mac mini にコピーして（AirDrop を使用できます）、次の操作を行います。

cd ~/gridpulse
npm install
cp .env.template .env
open -e .env

3. .env に値を入力する

• PAY_TO_ADDRESS：支払いを受け取るため、Pera で新しいアカウントを作成します。約1 ALGO を入金し、USDC をオプトインします（Pera で「Add Asset」を選び、USDC を検索します。アセット ID は 31566704 です）。そのアドレスをここに貼り付けます。
• EIA_API_KEY：無料ですぐに取得できます：https://www.eia.gov/opendata/register.php
• ここでは NETWORK=testnet のままにします。

4. 実行する

npm start

http://localhost:4021 を開くと、ランディングページが表示されます。http://localhost:4021/v1/henry-hub は 402 Payment Required を返します。これはペイウォールが機能していることを示します。停止するには Ctrl+C を押してください。

5. 公開 HTTPS アドレスを用意する

次のいずれかを選びます。

オプション A：Tailscale Funnel（無料で最も簡単です）。 https://mac-mini.tail1234.ts.net のような固定 URL を取得できます。

brew install tailscale

サインインしてから、次を実行します。

tailscale funnel --bg 4021

オプション B：独自ドメインを使った Cloudflare Tunnel（年間約 $10 で、よりプロフェッショナルな印象です）。 Cloudflare で gridpulse.xyz などのドメインを購入してから、次を実行します。

brew install cloudflared
cloudflared tunnel login
cloudflared tunnel create gridpulse
cloudflared tunnel route dns gridpulse api.YOURDOMAIN.com
cloudflared tunnel run --url http://localhost:4021 gridpulse

取得した URL を .env の PUBLIC_URL に設定します。

6. MainNet に切り替えて、24 時間 365 日稼働させる

.env で NETWORK=mainnet に設定します。次に、次を実行します。

npm install -g pm2
pm2 start npm --name gridpulse -- start
pm2 save
pm2 startup

（pm2 startup は、コピーして実行するもう 1 つのコマンドを表示します。）システム設定 → 電源で、「自動スリープを防止」と「停電後に自動的に起動」をオンにします。

7. 最初の実際の支払いを行う（コンテストへの参加に必須）

「購入者」用に、新しい Pera アカウントをもう 1 つ作成します。約 $1 相当の USDC と 0.3 ALGO を入金します。25 語のフレーズを .env の BUYER_MNEMONIC に追加します。 メインウォレットのフレーズは絶対に使用しないでください。

npm run pay -- "/v1/grid-mix?region=ISNE"
npm run pay -- "/v1/retail-price?state=CT"
npm run pay -- /v1/henry-hub

決済が完了するたびに、そのエンドポイントが Bazaar と リーダーボード に掲載されます。

8. 提出する（9 月 30 日まで）

1. このフォルダーを公開 GitHub リポジトリにプッシュします。.env は Git の追跡対象外なので、シークレットはローカルに残ります。
2. リポジトリを Electric Capital open-dev-data に追加します。
3. 提出フォームに入力します。

---

技術的な注意事項

• @x402/* パッケージは 2.17.0 に固定されており、ネットワーク ID は、現在ホストされている GoPlausible ファシリテーターが想定しているレガシー形式でハードコードされています（x402-foundation/x402#3528）。ファシリテーターが更新されるまでは、アップグレードしないでください。
• Algorand のネットワーク手数料はファシリテーターが支払います。購入者に必要なのは USDC のみです。
• EIA の応答は 10 分間キャッシュされます。
• 無効な入力には 400 を返し、上流の障害には 502 を返します。どちらの応答も決済されないため、購入者に請求されることはありません。