OKXでAI agentが支払いと登録を行う
OKX Walletでx402の支払いを行い、1回のリクエストでAPI keyと残高を取得します。
- X Layer上のUSD₮0、OKXで決済
- クレジットカードも登録フォームも不要
- 一般ユーザーもx402でチャージ可能
curl -i -X POST https://bazaarlink.ai/api/v1/agents/register/x402 \
-H "Content-Type: application/json" \
-d '{"name":"my-agent","amountUsd":1.1}'HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"x402Version": 2,
"resource": {
"url": "https://bazaarlink.ai/api/v1/agents/register/x402",
"description": "BazaarLink paid agent registration",
"mimeType": "application/json"
},
"accepts": [
{
"scheme": "exact",
"network": "eip155:196",
"payTo": "0xPAY_TO_ADDRESS",
"asset": "0xASSET_CONTRACT",
"amount": "1100000",
"maxTimeoutSeconds": 300,
"extra": { "name": "USD₮0", "version": "1" }
}
]
}x402とは
- POST
/api/v1/agents/register/x402 - ← 402
accepts[ network, asset, amount, payTo ] - sign
EIP-3009 - POST
X-PAYMENT: … - ← 201
api_key, credits, claim_token
支払いはOKXのx402 facilitatorを通じてX Layerで決済され、サーバーは処理の前に毎回確認します。
HTTP 402で支払いを求める
サーバーは402を返し、受け付けるネットワーク、アセット、金額、送金先アドレスを示します。クライアントは支払い認可に署名し、同じリクエストを再送します。BazaarLinkはOKXのx402 facilitatorを通じてX Layerで各支払いを決済します。
api_keysk-bl-…credits5claim_token…payment.txHash0x…先にアカウントは不要
agentは事前にフォームへ入力したり、アカウントを作成したりする必要がありません。支払いを含むリクエストがアカウントを作成し、API keyを発行して残高を追加します。
リクエストからAPI keyまでの4ステップ
リクエストを送る
/api/v1/agents/register/x402 にPOSTし、名前と支払いたい米ドル額を送ります。
402を受け取る
サーバーが402と支払い要件を返します。この時点では何も作成されません。
署名して再送する
自分のウォレットで支払い認可に署名し、X-PAYMENTヘッダーに入れて同じリクエストを再送します。
API keyを受け取る
支払い確認後、API key、残高、引き継ぎリンクを含む201が返ります。API keyが表示されるのはこのレスポンスだけなので、すぐに保存してください。
アカウントをお持ちですか？x402でチャージできます
agentは既存のAPI keyを使います。一般ユーザーはログインしてクレジットページからチャージします。
Agentとスクリプト
AuthorizationヘッダーとamountUsdを付けて /api/x402/topup にPOSTします。登録と同じく、見積もり、署名、再送の流れです。
一般ユーザー
ログインしてクレジットページでx402を選び、ブラウザウォレットで支払いに署名します。
対応ネットワークとアセット
現在対応している組み合わせは1つです。
- ネットワーク
- X Layer、OKXのx402 facilitatorを通じて決済
- アセット
- USD₮0
- 残高
- プラットフォームのチャージ手数料がかかるため、入金される残高は支払額より少なくなります（料金ページ参照）
- 1回の金額
- 下限と上限があります。現在の範囲は402レスポンスとGET /api/x402/topupで確認できます
オンチェーンの支払いは取り消せません。署名前に金額とネットワークを確認してください。
まだ支払っていなくても無料モデルを使えます
未払いのagentアカウントは、既存の無料モデル枠とレート制限（auto:free）を利用します。支払い後は通常の有料アカウントのルールに従います。
よくある質問
x402とは何ですか？
x402はHTTP 402ステータスコードで支払いを求めるプロトコルです。サーバーが金額、ネットワーク、送金先アドレスを示し、クライアントが支払い認可に署名して同じリクエストを再送します。
x402で支払うには何が必要ですか？
OKX Wallet、またはEIP-3009認可に署名できるウォレットキーと、X Layer上のUSD₮0が必要です。連携ドキュメントにはx402クライアントで署名するTypeScriptコードがあります。
対応するネットワークとアセットは？
X LayerのUSD₮0で、OKXのx402 facilitator経由で決済されます。プラットフォームのチャージ手数料がかかるため、受け取る残高は支払額より少なくなります。料金ページをご覧ください。
二重に支払ったり再送したりするとどうなりますか？
各支払いは1回だけ入金されます。チャージで同じ支払いを再送するとalready_creditedが返ります。登録では15分間は同じ結果が返り、その後はalready_registeredとなり、API keyは再表示されません。
返金できますか？
オンチェーンの支払いは取り消せず、システムが自動で返金することもありません。問題が起きた場合はサポートに連絡してください。
登録回数に制限はありますか？
あります。同じネットワーク送信元からの登録は短時間に制限されます。上限に達すると429とRetry-Afterヘッダーが返るので、待ってから再試行してください。
人がagentアカウントを引き継げますか？
はい。登録レスポンスにはclaim_tokenとupgrade_urlが含まれます。人がログインしてアカウントを引き継ぐと、API keyと残高がそのアカウントへ移ります。claim_expiresが期限を示します。