x402 服務列表：發現並提交 Agent 可用的付費介面

x402 讓一個 HTTP 介面可以直接說明“呼叫這項能力需要支付多少”，但協議解決了付款握手之後，供需雙方還會遇到一個更早的問題：Agent 去哪裡找到適合目前任務的付費服務？一個已經上線的 x402 服務，又怎樣被更多開發者和 Agent 發現？

為此，我們上線了 StableOps x402 服務列表。它既是開發者可以瀏覽和測試的公開目錄，也是服務提供方展示自己收費介面的入口。你可以按類別與使用資料比較候選服務，在不連線錢包、不發起付款的情況下讀取即時 402 付款要求。如果你已經提供 x402 服務，也可以提交服務，把它加入目錄。

為什麼 x402 需要一個服務列表

傳統 API 往往從文件、搜尋引擎或整合市場中被發現，接入前還要申請金鑰、選擇方案並完成帳戶充值。x402 把付款要求帶回 HTTP 請求本身，減少了結算前的整合步驟，卻不會自動告訴 Agent 哪個服務存在、它能完成什麼任務，或者目前端點是否仍然返回有效的付款要求。

服務列表把這些發現資訊集中到一個可瀏覽入口：

• 按資料、搜尋、人工智慧、算力、儲存、內容等類別篩選服務。
• 搜尋服務名稱、服務商、介紹或介面地址。
• 按最近 30 天交易次數、交易量、付款地址數或最新收錄排序。
• 在服務詳情中檢視服務商、文件、標籤、介面說明、請求方法和請求模板。
• 線上請求真實端點，讀取它此刻返回的 402 付款方案與原始回應。

目錄並不替 Agent 作出購買決定，也不把歷史指標變成品質保證。它的作用是縮小候選範圍，並把接入前最需要核對的資訊放在一起。最終是否付款，仍應由任務需要、付款策略、預算、收款方允許列表和人工審批共同決定。

不付款，先讀取真實的 402 要求

每個服務可以收錄多個介面。進入詳情頁後，你可以選擇一個介面，檢查儲存的請求方法、查詢參數和示例請求體，再點選“測試 402”。StableOps 會按這份模板請求服務，並展示目前返回的付款方案，包括原子單位金額、資產、收款地址和付款時限。

這一步只讀取付款要求：不會連線錢包，也不會發起鏈上付款。它適合用來回答幾個關鍵問題：

1. 這個介面現在是否可訪問並返回有效的 x402 挑戰？
2. 請求模板是否與目前任務匹配？
3. 網路、資產、金額和收款地址是否符合你的付款策略？
4. 同一服務的不同介面，分別提供什麼能力？

詳情頁還會展示最近的付款要求變更記錄。若自動探測發現價格、收款地址、網路或 x402 版本發生變化，你可以在付款前看到新舊值。對於按報價動態分配收款地址的服務，則應始終以目前報價返回的地址為準。

讓程式也能讀取服務列表

網頁適合人工比較，公開 JSON 介面則適合工具和自動化程式先取得候選服務。下面的請求會讀取資料類服務，並按最近 30 天交易次數排序：

curl 'https://api.stableops.dev/v1/x402/resources?category=DATA&sort=TRANSACTION_COUNT&limit=10'

回應包含服務介紹、服務商、介面列表、類別、標籤、更新時間以及可用的 30 天指標。程式可以用這些欄位生成候選清單，但在真正付款前，仍應讀取目標介面的即時要求，並經過自己的策略、預算與審批流程。

如果你正在為 Agent 設定受控付款，可以繼續閱讀 Agent Payments 快速開始。執行時應先發現和比較服務，再預檢準確網址與即時報價。同一次購買的重試還要複用穩定的冪等鍵。

為什麼要把你的服務提交進來

一個收費介面只有被正確發現，才有機會獲得真實呼叫。提交到 StableOps 服務列表後，你可以：

• 用清晰的服務介紹、類別與標籤說明它適合解決什麼問題。
• 在同一個服務下展示多個介面，並分別提供請求方法、參數和示例請求體。
• 連結官方文件，降低開發者理解與接入成本。
• 讓訪問者在付款前讀取即時 402 要求，而不是依賴可能過期的靜態價格。
• 在公開詳情頁展示可用的線上率、回應耗時和交易指標，為選擇提供更多上下文。
• 透過“我的服務”維護已提交內容。已釋出服務的修改進入稽核時，現有公開版本會繼續展示。

提交服務不收費，但需要註冊或登入 StableOps，並選擇所屬組織。聯絡郵箱只用於稽核與溝通，不會公開展示。

提交前準備好這些資訊

開啟提交 x402 服務後，需要填寫服務名稱、服務商名稱、服務介紹、類別、標籤、聯絡郵箱，以及至少一個服務介面。官方文件連結和補充說明為可選項。

每個介面都應準備：

• 一個不含憑據、片段或內網地址的公開 HTTPS 地址。
• 能說明返回內容與適用任務的介面介紹。
• 正確的 HTTP 請求方法。
• 請求所需的查詢參數，以及適用時的請求體型別和示例請求體。

先對每個介面點選“測試 402”。提交時系統會再次實際請求所有介面。只有每個介面都返回有效的 HTTP 402 付款要求，服務才能儲存並進入稽核。已經被其他服務收錄的介面地址不能重複提交。

為了讓服務更容易被選擇，不要只寫“資料介面”或“人工智慧服務”。更有效的介紹會明確說明輸入、返回結果、覆蓋範圍、更新頻率和典型任務。請求模板應能夠直接得到付款要求，同時避免放入真實令牌、個人資料或其他敏感資訊。

從發現到第一次呼叫

如果你正在尋找能力，現在就去瀏覽 x402 服務列表，選擇一個類別，開啟候選服務並先測試它的即時付款要求。確認任務確實需要該結果，且網路、資產、金額和收款方均符合策略後，再透過你的 x402 用戶端或 Agent Payments 發起購買。

如果你已經在銷售資料、搜尋、推理、算力、儲存或內容介面，請提交你的 x402 服務。準確的介紹、可復現的請求模板和穩定返回的 402 挑戰，會讓開發者更快理解你的服務，也讓 Agent 更容易在正確的任務中發現並使用它。