x402-client
Vybe x402 API 用戶端 SDK。支援 HTTP 按次計費 USDC 支付與預付點數 WebSocket 串流,用於 Vybe 的 Solana 分析 API,專為 AI 代理打造。
x402-client 是什麼?
x402-client 是 Vybe x402 API 的用戶端 SDK,提供 HTTP 按次計費 USDC 支付與預付點數 WebSocket 串流功能,專為 Vybe 的 Solana 分析 API 設計,適用於 AI 代理。
x402-client 概覽
這是什麼
這是 Vybe x402 API 的用戶端 SDK。它透過 HTTP 提供按次付費的 USDC 微支付,以及透過 WebSocket 提供預付點數串流服務,用於 Vybe 的 Solana 分析 API。專為 AI 代理程式打造,無需 API 金鑰或訂閱,只需一個 Solana 錢包即可使用。
主要功能
- HTTP 按次付費:每次請求結算一筆 USDC 微支付(預設 0.001 美元,較重量的端點最高 0.010 美元)。
- 預付 WebSocket 連線:支付 0.01 美元可獲得 1000 點點數(扣除 5 點連線費用後約有 995 個事件);支援自動加值。
- 預算上限:設定
maxUsd限制後,SDK 會在簽章前拒絕呼叫。 - AI 代理程式整合:使用標準的
client.get()/client.request()方法,無需特殊的 AI 輔助工具。 - 型別化錯誤處理:提供
ApiError和NetworkError類別進行結構化錯誤處理。 - 速率限制:每個錢包每分鐘最多 600 次付費 HTTP 請求(滑動視窗)。
使用情境
- 透過按次付費 HTTP 查詢 Solana 代幣資料(例如頂級持有者、代幣餘額)。
- 透過 WebSocket 以預付點數串流即時 Solana 事件(交易、轉帳、預言機價格、價格蠟燭、新代幣)。
- 將 Vybe 的分析 API 整合至 AI 代理程式的工具呼叫迴圈,無需管理 API 金鑰。
- 透過預算上限和每請求微支付來管理 API 花費。
快速開始
安裝: npm install @vybenetwork/x402-client 快速啟動程式碼位於儲存庫的 README 中,需要一個在 Solana 主網上擁有 USDC 資金的 Solana 金鑰對。完整的設定和範例請參閱儲存庫。
授權與價格
MIT 授權。目前價格為 Beta 促銷價:每次 HTTP 呼叫預設 0.001 美元,較重量的端點為 0.003/0.005/0.008/0.010 美元,每個 WebSocket 連線(1000 點點數)為 0.01 美元。正式推出後價格將調漲。另提供傳統固定費率訂閱方案,詳情請見 vybe.fyi/api-pricing。
內容整理自該專案公開的 README 與儲存庫資訊。