macro-pulse-x402

Macro Pulse — x402 決済対応 API

国ごとに算出した「経済モメンタムスコア」を AI エージェントに提供する、x402 で保護されたエンドポイントです。すべて無料のパブリックドメインの World Bank データ（https://data.worldbank.org）を使用して構築しており、ライセンスが必要なフィードや有料フィードを再パッケージしたものは一切ありません。

できること

GET /macro-pulse/{country_code}（例：/macro-pulse/US）— 料金：1 回あたり $0.02

World Bank API から GDP 成長率、インフレ率、失業率の推移データを取得し、方向性を示す単一の「モメンタム」スコアとラベル（改善／安定／悪化）を生成します。透明性を確保するため、元の指標の履歴も含まれます。

ローカルでテスト済みです。支払いが添付されていない場合、支払いゲートが有効な支払い要件（scheme=exact、asset=USDC、network=Base）とともに HTTP 402 を正しく返すこと、および基盤となるデータ取得／スコアリングロジックが World Bank の正確なデータを返すことを確認しています。

これで実際に収益を得る前に必要なこと

1. Base ウォレットアドレスを取得します（Base 用に設定した Coinbase Wallet または MetaMask）。ここに USDC の支払いが入金されます。PAY_TO_ADDRESS に設定してください。 秘密鍵やシードフレーズは、私を含め、誰にも絶対に共有しないでください。

2. テストネットとメインネットのどちらを使うか決めます。

   • テストネット（Base Sepolia、NETWORK=eip155:84532）— 現在の設定はこちらです。偽の USDC で安全にテストでき、実際のリスクはありません。
   • メインネット（NETWORK=eip155:8453）— 実際のお金を扱います。メインネットで決済するには、それに対応したファシリテーターが必要です。公開されている https://x402.org/facilitator はテストネット専用です。メインネットでは、無料の Coinbase Developer Platform（CDP）アカウント（https://portal.cdp.coinbase.com）に登録し、CDP が提供するホステッドファシリテーターと API キーを使用してください。

3. インターネットからアクセスできる場所にデプロイします（localhost ではなく、実際のドメイン／URL）。エージェントやマーケットプレイスから見つけられるようにします。ウォレットとネットワークの選択が決まったら、喜んでサポートします。

4. ディスカバリーレイヤーに登録します — https://www.x402scan.com または https://x402.org の Bazaar に登録すると、エージェントが自動的に見つけて支払いできるようになります。また、自動検出用の /.well-known/x402 マニフェストも追加してください。

現実的な見通し

1 回あたり $0.02 の料金では、意味のある収益にするにはかなりの利用量（数百から数千回の呼び出し）が必要です。すぐに成果が出るものではなく、時間をかけて育てる副業として考えてください。現実的な収益の範囲については、これまでの話し合いを参照してください。

ファイル

• app.py — x402 決済ミドルウェアを備えた FastAPI サービス一式