httppayai

x402-watchlist-batch

登録した最大10本の x402 URLの支払条件が変わった時だけ、1コールで全部の差分を返す。変わっていなければ changed:false。1本ずつ /watch を呼ぶと本数分の往復と本数分の支払いになるので、まとめて1回にする。条件は scheme・network・asset・amount・payTo・maxTimeoutSeconds の6項目で、差分は URL ごとに変わった項目の field / from / to だけ。curl: curl -X POST -H 'content-type: application/json' -d '{"urls":["https://api.example.com/a","https://api.example.com/b"]}' https://<host>/watchlist → watchlist_id を受け取り、以後は curl 'https://<host>/watchlist?id=<watchlist_id>' で差分だけを読む。Response: {"watchlist_id":"…","changed":true,"summary":{"total":2,"changed":1,"unchanged":1,"indeterminate":0},"items":[{"url":"https://api.example.com/a","status":"changed","changes":[{"field":"amount","from":"20000","to":"30000"}],"conditions":{"scheme":"exact","network":"eip155:8453","amount":"30000","payTo":"0x6f60…","maxTimeoutSeconds":60}},{"url":"https://api.example.com/b","status":"unchanged","changes":[]}]} — 変わったURLの変わった項目だけが返る。読み取れなかったURLは status:"indeterminate" で返り、「変化なし」にはしない（基準も上書きしない）。上限は10本で、超える要求は支払いの前に400で断る。登録も差分も1コール 0.05 USDC（/watch 0.02 × まとめ買い）。対象は支払いの後に最大4本ずつ並行で1回だけ取得し、1本ごとに5秒で打ち切り・リダイレクトは3回まで。同じURLの60秒以内の再取得はキャッシュから返す。 A purchase is two calls by design: this first call returns 402 with the price and the payment terms, and you then repeat the same request with the PAYMENT-SIGNATURE header to receive the 200 delivery.