MPP クイックスタート

Tempo USDC と mppx クライアントで TwexAPI 高度検索ページを支払う。

MPP Quickstart

TwexAPI API キーなしで従量課金の高度検索リクエストを行います。このガイドでは mppx クライアントで HTTP 402 チャレンジに応答し、Tempo USDC で支払い、自動リトライします。

Step 1: クライアント依存関係をインストール

npm install mppx viem

mppx が MPP チャレンジと支払いを処理。viem が Tempo 秘密鍵をウォレットアカウントに変換。

Step 2: Tempo ウォレットを作成・入金

ローカル MPP アカウントを作成し、秘密鍵をエクスポート:

mppx account create
mppx account export

表示アドレスに Tempo 上の USDC を入金。エクスポートした 0x... 秘密鍵を環境変数に:

export TEMPO_PRIVATE_KEY="0x..."

Step 3: MPP リクエストを実行

mpp-search.ts を作成:

import { Mppx, tempo } from "mppx/client";
import { privateKeyToAccount } from "viem/accounts";

Mppx.create({
  methods: [
    tempo({
      account: privateKeyToAccount(
        process.env.TEMPO_PRIVATE_KEY as `0x${string}`,
      ),
    }),
  ],
});

const response = await fetch(
  "https://api.twexapi.io/twitter/advanced_search/page",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      searchTerms: ["openai"],
      sortBy: "Latest",
    }),
  },
);

if (!response.ok) {
  throw new Error(`TwexAPI request failed: ${response.status}`);
}

console.log(await response.json());

Mppx.create() は fetch を MPP 402 Payment Required チャレンジ処理用に設定。対象エンドポイントではサーバー提供 Tempo オファーを支払い、支払い認証情報付きで同一リクエストをリトライ。決済記録が必要なら response.headers.get("Payment-Receipt") を確認。

前ページから継続する場合は JSON ボディに next_cursor を渡す:

{
  "searchTerms": ["openai"],
  "sortBy": "Latest",
  "next_cursor": "cursor-from-the-previous-response"
}

Step 4: 生 HTTP フローを実装

mppx なしでは、まず検索ページを通常リクエスト:

curl -i --request POST 'https://api.twexapi.io/twitter/advanced_search/page' \
  --header 'Content-Type: application/json' \
  --data '{"searchTerms":["openai"],"sortBy":"Latest"}'

402 では WWW-Authenticate: Payment チャレンジを互換 Tempo MPP 実装で処理。生成した認証情報で同一リクエストをリトライ:

curl -i --request POST 'https://api.twexapi.io/twitter/advanced_search/page' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Payment eyJjaGFsbGVuZ2UiOnsi...' \
  --data '{"searchTerms":["openai"],"sortBy":"Latest"}'

成功レスポンスには TwexAPI 通常 JSON エンベロープと Payment-Receipt レスポンスヘッダー。照合が必要ならレシートを自前リクエスト記録と保存。

次のステップ

Machine Payments Protocol — サポート操作、支払いシーケンス、API キー比較。
API overview — API キー認証と完全エンドポイントカタログ。