AgentFeed について
AgentFeedは、暗号資産市場、清算、Solanaの取引前チェック、言語タスクを扱うAIエージェント向け従量課金データサービスです。x402などの決済方式でUSDC等を支払います。
主な機能
- 01暗号資産価格と市場データ
- 02清算、資金調達率、建玉データ
- 03Solanaトークンの取引前チェック
- 04OCR、翻訳、要約などのタスク
- 05アカウントやAPIキー不要の従量課金
活用シーン
- 01暗号資産市場や清算データの取得
- 02取引前のSolanaトークン審査
- 03テキスト、画像、音声処理タスクの実行
MCP 対応
ClaudeやCursorなどのMCPクライアント向けに、Streamable HTTPのMCPエンドポイントを提供します。有料呼び出しにはx402決済を使用します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://x402.ochinimus.app/mcpclaude mcp add --transport http seekdaseek-agentfeed https://x402.ochinimus.app/mcp{"mcpServers":{"seekdaseek-agentfeed":{"type":"http","url":"https://x402.ochinimus.app/mcp"}}}Cursor で開く{"servers":{"seekdaseek-agentfeed":{"type":"http","url":"https://x402.ochinimus.app/mcp"}}}VS Code で開く{"mcpServers":{"seekdaseek-agentfeed":{"type":"http","url":"https://x402.ochinimus.app/mcp"}}}{"mcpServers":{"seekdaseek-agentfeed":{"serverUrl":"https://x402.ochinimus.app/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
50このツールにパラメーターはありません。
詳細
AgentFeed
AI エージェント向けの暗号資産市場データ(清算、資金調達率、建玉、価格)、Solana の取引前チェック、OFAC 制裁スクリーニング、学術論文、ユーティリティ、用途特化型の言語タスク(OCR、翻訳、要約、抽出、分類、プロンプトインジェクションチェック、文字起こし)。USDC で呼び出しごとに支払います。アカウントもサブスクリプションも不要で、API キーも必要ありません(x402 で支払えないボット向けに、プリペイドキーも任意で利用できます)。
AgentFeed は、Solana、Base、Polygon、Arbitrum、Arc、Algorand、Optimism、Monad、Avalanche 上で、またリクエストに応じて Celo、HyperEVM、Unichain、Scroll、SKALE Base、BNB Chain、Ethereum、Robinhood Chain、World Chain、Sei、X Layer 上で、x402 payment protocol を通じてリアルタイムの取引データを提供します(GET /api/<route>|<network>)。エージェントがエンドポイントにアクセスすると、価格を示す 402 Payment Required が返されます。エージェントは自身のウォレットから USDC(または各ネットワークが指定するドル連動トークン)で数セント未満を支払い、データを受け取ります。ファシリテーターがガス代を負担するため、所要時間は約 2 秒です。
2 つの接続方式で、データは同じです。
| 接続方式 | エンドポイント | 対象 |
|---|---|---|
| MCP(Streamable HTTP) | https://x402.ochinimus.app/mcp | Claude、Cursor、MCP ネイティブのフレームワーク |
| HTTP(x402) | https://x402.ochinimus.app/api/* | HTTP に対応するあらゆるもの |
これが他と異なる理由:清算データ
私たちは Bybit、OKX、Binance の全 USDT 建て無期限先物を対象に、独自の清算データ収集システムを運用しています。記録は 2026-07-08 から継続しています。
このデータ量は主張ではなく、クエリで確認できます。2026-09-28 06:56 UTC 時点の測定値です。
| 行数 | 4,924,729 |
| データ全体に含まれる無期限先物市場の数 | 907 |
| 過去 7 日間の無期限先物市場の数 | 861 — binance 728 · bybit 693 · okx 454 |
| 範囲(UTC) | 2026-07-08 16:42:32 → 2026-09-28 06:56:17 |
この文章を読んでいる間にも増え続けています。上記の行数と、5 分後に同じクエリから取得する行数は一致しません。
過去 7 日間の数値は、サービス自身が / の coverage.perp_markets_7d でリアルタイムに公開しています。データから再計算しているため、README に記載された値を鵜呑みにせず、照合できます。
このデータは購入できません。 私たちからも、ほかの誰からも購入できません。
- Binance は清算アーカイブを削除しました。
data.binance.visionのliquidationSnapshotはすでに存在せず、ディレクトリは空のままです。2026-07-12 に確認済みです。 - Bybit は過去の清算データを一度も公開していません。
- OKX が提供するのは、ローリング方式の REST ウィンドウで取得できる過去 7 日間分のみです。
主要な取引所について、公開されている過去の清算データセットは、どの価格でも入手できません。このデータを保有する唯一の方法は、記録し続けることです。
データに弱点がある箇所を正確に説明します
率直に伝えることは、宣伝よりも重要です。
| 取引所 | フィード | 完全ですか? |
|---|---|---|
| Bybit | allLiquidation | ✅ はい。 500ms 間隔で、すべての清算を記録します。主要な無期限先物取引所の中で唯一、制限のない完全な公開清算ストリームです。 |
| Binance | !forceOrder@arr | ❌ いいえ。 スナップショットのみです。Binance の公式ドキュメントによると、1000ms ごとにシンボルあたり最大 1 件の注文です。allForceOrders REST はメンテナンスされていません。 |
| OKX | liquidation-orders | ❌ いいえ。 コントラクトごとに、1 秒あたり最大 1 件の更新です。 |
| Hyperliquid | — | ⛔ 含まれていません。 Hyperliquid は公開清算ストリームを提供していません。WsTrade に清算を示すマーカーはなく、データはユーザー限定のストリームでのみ利用できます。取得するにはノードを実行する必要があります。 |
Binance と OKX のデータ件数は、構造上過少です。特に過少になるのは、データが最も重要となる清算の連鎖発生時です。 これは、よく知られたデータセットも含め、市場にあるすべての清算データセットに当てはまります。ほとんどの提供元はこのことを明記していません。
Bybit のデータは、このデータセットの中で最も信頼性が高い部分です。 その点を考慮してください。
多くのデータセットで誤っている side フィールド
3 つの取引所に、3 つの異なる規約があります。すべて正規化しています。
- Bybit の
Sはすでにポジションのサイドです(Buy= ロングポジションが清算された)。そのまま渡します。 - Binance の
Sは注文のサイドです。SELL注文はロングポジションを閉じるものです。反転します。 - OKX では
posSideが明示的に公開されています。これをマッピングします。
出力では、Buy = ロングポジションが清算された、Sell = ショートポジションが清算された、という意味です。 これを逆にすると、計算するロング/ショート比率が一部の取引所で逆になります。
名目金額には filled_qty × avg_fill_price を使用します。これは実際に約定した値であり、limit_price × requested_size ではありません。
価格インデックス
有料ルートをすべて、最も安い質問を最後にして掲載しています。
/.well-known/x402.json
から生成し、2026-10-18 に読み込みました。名称、価格、ルートはマニフェストの内容であり、手作業で同期を保っているコピーではありません。各ルートが返す内容は、
サービスが公開している文言そのままに、
90 tools に記載しています。
| Tool | Price | Route |
|---|---|---|
buy_key_pass | $25 | /api/keys/buy-pass |
buy_key_20 | $20 | /api/keys/buy-20 |
topup_key_20 | $20 | /api/keys/topup-20 |
buy_key_5 | $5 | /api/keys/buy-5 |
topup_key_5 | $5 | /api/keys/topup-5 |
buy_key_1 | $1 | /api/keys/buy-1 |
buy_key_day_pass | $1 | /api/keys/buy-day-pass |
buy_key_trial | $0.25 | /api/keys/buy-trial |
get_squeeze_score | $0.1 | /api/squeeze-score |
get_cascade_scan | $0.05 | /api/cascade-scan |
get_liq_history | $0.05 | /api/liq-history |
get_peg_universe | $0.05 | /api/peg-universe |
get_ocr | $0.04 | /api/ocr |
get_translate | $0.04 | /api/translate |
get_cascade_history | $0.03 | /api/cascade-history |
get_peg_sessions | $0.03 | /api/peg-sessions |
get_extract | $0.025 | /api/extract |
get_sol_token_check | $0.025 | /api/sol-token-check/:mint |
get_base_launches | $0.02 | /api/base-launches |
get_cascade_forecast | $0.02 | /api/cascade-forecast |
get_exit_quote | $0.02 | /api/exit-quote |
get_funding_extremes | $0.02 | /api/funding-extremes |
get_funding_radar | $0.02 | /api/funding-radar |
get_hl_whales | $0.02 | /api/hl-whales |
get_liq_heatmap | $0.02 | /api/liq-heatmap |
get_liquidation_leaders | $0.02 | /api/liquidation-leaders |
get_market_state | $0.02 | /api/market-state |
get_oi_spike_scan | $0.02 | /api/oi-spike-scan |
get_peg_deviation | $0.02 | /api/peg-deviation |
get_summarize | $0.02 | /api/summarize |
get_token_holders | $0.02 | /api/token-holders/:mint |
get_tradfi_radar | $0.02 | /api/tradfi-radar |
get_transcribe | $0.02 | /api/transcribe |
get_venue_liq_share | $0.02 | /api/venue-liq-share |
get_wallet_activity | $0.02 | /api/wallet-activity/:wallet |
get_papers | $0.015 | /api/papers |
get_basis | $0.01 | /api/basis |
get_cascade_alert | $0.01 | /api/cascade |
get_equity_24h | $0.01 | /api/equity-24h |
get_honeypot_check | $0.01 | /api/honeypot-check |
get_insider_trades | $0.01 | /api/insider-trades |
get_liquidation_stats | $0.01 | /api/liquidation-stats |
get_open_interest | $0.01 | /api/open-interest |
get_orderbook_imbalance | $0.01 | /api/orderbook-imbalance |
get_orderbook_walls | $0.01 | /api/orderbook-walls |
get_pdf_markdown | $0.01 | /api/pdf-markdown |
get_sec_8k | $0.01 | /api/sec-8k |
get_signal_board | $0.01 | /api/signal-board |
get_token_risk | $0.01 | /api/token-risk/:mint |
get_top_movers | $0.01 | /api/top-movers |
get_trade_context | $0.01 | /api/trade-context |
get_volatility | $0.01 | /api/volatility |
get_sanctions_check | $0.008 | /api/sanctions-check/:address |
get_sol_holder_clusters | $0.008 | /api/sol-holder-clusters/:mint |
get_sol_token_flow | $0.008 | /api/sol-token-flow/:mint |
get_wallet_holdings | $0.008 | /api/wallet-holdings/:wallet |
get_base_balance | $0.005 | /api/base-balance |
get_base_gas | $0.005 | /api/base-gas |
get_classify | $0.005 | /api/classify |
get_convert | $0.005 | /api/convert |
get_domain | $0.005 | /api/domain/:domain |
get_email_verify | $0.005 | /api/email-verify |
get_funding_history | $0.005 | /api/funding-history |
get_funding_pulse | $0.005 | /api/funding-pulse |
get_funding_rate | $0.005 | /api/funding-rate |
get_hash | $0.005 | /api/hash |
get_jito_tips | $0.005 | /api/jito-tips |
get_liq_pulse | $0.005 | /api/liq-pulse |
get_macro_calendar | $0.005 | /api/macro-calendar |
get_market_snapshot | $0.005 | /api/market-snapshot |
get_paper | $0.005 | /api/paper/:doi |
get_perp | $0.005 | /api/perp |
get_positioning | $0.005 | /api/positioning |
get_priority_fees | $0.005 | /api/priority-fees |
get_qr | $0.005 | /api/qr |
get_recent_liquidations | $0.005 | /api/liquidations |
get_sec_filings | $0.005 | /api/sec-filings |
get_sol_network | $0.005 | /api/sol-network |
get_time | $0.005 | /api/time |
get_token_metadata | $0.005 | /api/token-metadata/:mint |
get_tradfi_perps | $0.005 | /api/tradfi-perps |
get_web_markdown | $0.005 | /api/web-markdown |
get_wiki | $0.005 | /api/wiki |
get_coin_signal | $0.004 | /api/coin-signal/:coin |
get_injection_check | $0.004 | /api/injection-check |
get_fx_rates | $0.002 | /api/fx-rates |
get_btc_price | $0.001 | /api/btc-price |
get_eth_price | $0.001 | /api/eth-price |
get_liq_feed | $0.001 | /api/liq-feed |
get_sol_price | $0.001 | /api/sol-price |
get_spot | $0.001 | /api/price |
1つの402で2つの決済プロトコル
有料ルートはすべて、PAYMENT-REQUIRED ヘッダーに x402 v2 チャレンジを含めた 402 を返し、Base と Solana 向けには同じチャレンジを x402 v1 の本文({x402Version: 1, accepts})としても返します。支払いには PAYMENT-SIGNATURE(v2、すべてのレール)または X-PAYMENT(Base または Solana での v1。CDP ファシリテーターの v1 種別を通じて検証および決済)を使用します。Polygon と Arbitrum には v1 種別がないため、v2 のみとなります。9つのネットワークはすべての402に含まれ、さらに11のネットワークはリクエストに応じて提供されます(「任意のチェーンで支払う」を参照)。各ネットワークの決済は、必ず1つのファシリテーターが担当します。Solana、Base、Polygon、Arbitrum、World Chain は CDP、Arc は専用の Arc アドレス宛てに Circle の Facilitator Service、Algorand は GoPlausible、Optimism、Monad、Avalanche、Celo、HyperEVM、Unichain、Scroll、SKALE Base、BNB Chain、Ethereum、Robinhood Chain は Ultravioleta、Sei と X Layer は PayAI が担当します。payments.js は各ファシリテーターのクライアントにそのファシリテーターが担当するネットワークのみを割り当てるため、あるネットワークでの支払いが別のファシリテーターに送られることはありません。
有料ルートにはすべて、MPP tempo/charge チャレンジも WWW-Authenticate に含まれます(Tempo mainnet、チェーン4217、最初は OUSD、次に USDC.e、ルートの料金で決済。手数料の支払者は設定されず、支払者がガス代を支払います)。受け付けるのは署名済みトランザクション(プルモード)のみです。サーバーは送金を検証してリクエストを実行し、応答が400未満の場合にのみトランザクションをブロードキャストするため、失敗した呼び出しに課金されることはありません。すでにブロードキャスト済みのハッシュ資格情報は拒否されます。/api/sol-price と /api/btc-price には、MPP solana/charge チャレンジも含まれます。これらはすべて同じ応答に含まれるため、クライアントは対応するプロトコルで決済できます。2つのプロトコルは互いに重ならないヘッダー名前空間を使用するため、x402 のみを扱うクライアントには MPP のチャレンジが表示されず、影響もありません。
$ curl -si https://x402.ochinimus.app/api/btc-price # 2026-09-23 09:18:09 UTC
HTTP/2 402
payment-required: eyJ4NDAyVmVyc2lvbiI6MiwiZXJyb3IiOiJQYXltZW50IHJlcXVpcmVkIiwi…
www-authenticate: Payment id="T0-lA4BfXXpf3GvzGklT8YobRJwSlEu8AXu9ZLz5VOg",
realm="x402.ochinimus.app", method="solana", intent="charge",
request="eyJhbW91bnQiOiIxMDAwIiwiY3VycmVuY3ki…",
expires="2026-09-23T09:23:09.919Z", opaque="eyJfbXBweF9zY29wZSI6…"
Base64 デコードすると、この MPP request が見積もり全体になります。
{
"amount": "1000",
"currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"recipient": "4a8o45skRPcyjAdyR8yES215Swvh8uTpZD6KLarhxCJ7",
"methodDetails": {
"decimals": 6,
"network": "mainnet",
"recentBlockhash": "6e6NEAxddHca5ipHioSwZRhcGcSL4rW4q18AYszfnxyv",
"tokenProgram": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
}
}
ここにないものに注目してください。feePayer はありません。クライアントが自身のトランザクション手数料を支払い、サーバーは資金を入れた署名鍵を保持しません。これは、同じ応答に含まれる MPP チャレンジと Solana の x402 チャレンジとの違いです。
リプレイは単に推奨されないのではなく、拒否されます。 リソースを提供する前に、決済済みの署名を SQLite でアトミックに登録します。そのため、同じ資格情報を使って2つのプロセスが競合すると、必ず一方だけが200を返し、もう一方は拒否されます。この動作は、競合をスタブで再現するのではなく、実際のワーカープロセスをフォークするテストで検証されています。
このレイヤーは、設計上フェイルソフトです。 初期化できない場合は [mpp] DISABLED: <cause> をログに記録し、サービスは有料のエンドポイント群を停止せず、すべてのルートで x402 による提供を続けます。ゲート対象のルートは / と /.well-known/x402.json の mpp.routes にリアルタイムで公開されるため、告知される対象は常に実際にマウントされているルートと一致します。
AgentFeed は、Solana mainnet で MPP を受け付けている複数の販売事業者の1つです。Foundation 自身の Google プロキシと solana-foundation/pay-skills の smartmoney-market も MPP を受け付けています。
ここから生まれた上流への貢献
solana-foundation/pay-kit #328 | fix(mpp): send preflightCommitment with sendTransaction so confirmed-only blockhashes are accepted — confirmed で発行されたチャレンジのブロックハッシュが、デフォルトで finalized になっているプリフライトバンクに拒否されるため、高速に支払うクライアントは必ず失敗します。オープン、承認済み、44/44 のチェックが成功、マージ可能/競合なし(2026-09-23 確認) |
solana-foundation/surfpool #813 | fix(core): make blockhash handling honor commitment and preflightCommitment — MicaiahReid によって 2026-09-21 にマージされました。#328 をレビューしていた EfeDurmaz16 がオープンしました。説明では、上記のバグが CI ではなぜ見えなかったかが解説されています。「この問題により、pay-kit の Surfpool CI で、決定論的に発生するメインネットの障害が隠れていました:solana-foundation/pay-kit#328」。常に有効なブロックハッシュを付与するサンドボックスでは、メインネットで毎回発生するファイナリティ競合を再現できませんでした |
solana-foundation/pay-skills #260 | providers: add ochinimus/agentfeed |
solana-foundation/pay #469 | GUI のないコンテキストで、有料ルート上の pay が永久にハングします。Touch ID のゲートが、表示できないプロンプトをポーリングし続けます |
pay-kit の修正は、ここでは mpp/patches/@solana+mpp+0.7.0.patch として提供され、インストール時に
patch-package で適用され、npm run verify-patch で検証されます。このパッチは本番環境の
依存関係であり、開発用ではありません。開発用依存関係にすると、--omit=dev のインストールが
パッチ未適用のまま、何事もなく完了してしまうためです。
高頻度で利用する場合は半額
頻繁に呼び出すボットは、1 回あたりの料金がルート価格の半額(最低 $0.0005)になります。この割引は、呼び出しごとの支払い方法と同じ 402 で利用できる、次の 2 つの方式のいずれかで適用されます。呼び出しごとの価格は変わりません。6 つのプリペイドキー購入ルートが受け付けるのは、呼び出しごとの支払い方法のみです。Gateway の支払い方法は Arc でのみ提供されます。2026 年 10 月 18 日に Base、Polygon、Arbitrum から削除されました。これらのチェーンで、クライアントが最安の支払い方法として選んだ購入者が、Gateway ウォレットへの通常の USDC 承認に署名してしまっていました。これは Gateway 決済ではないため、拒否されていました。
| batch-settlement | Circle Gateway nanopayment | |
|---|---|---|
| ネットワーク | Base、Polygon、Arbitrum | Arc |
| 支払い方法 | scheme: batch-settlement | scheme: exact、extra.name: GatewayWalletBatched |
| 支払先 | 財務資金庫 0x22DB3A9686EE5261e7Bf3ed4f91277232E8076e6 | Gateway の販売者 0xA853129ACF56A851f9d51CD8cb47619465260Fa9 |
| 購入者が一度だけ行うこと | 1 回のデポジットでチャネルを開きます(支払い方法の extra.minDeposit)。それ以降の呼び出しでは、オフチェーンのバウチャーを使用します | GatewayWallet 0x77777777Dcc4d5A8B6E418Fd04D8997ef11000eE に USDC を入金します |
| 精算 | 30 分ごとにバウチャーを請求します | Circle が承認をまとめて処理します |
| 未使用の資金 | チャネルの時間指定出金で返金されます(24 時間の遅延) | 購入者の Gateway 残高に残ります |
400 以上のステータスコードを返す呼び出しは、どちらの方式でも請求されません。
Base での batch-settlement
import { privateKeyToAccount } from 'viem/accounts';
import { createPublicClient, http } from 'viem';
import { base } from 'viem/chains';
import { BatchSettlementEvmScheme } from '@x402/evm/batch-settlement/client';
import { wrapFetchWithPaymentFromConfig } from '@x402/fetch';
const account = privateKeyToAccount(process.env.EVM_KEY);
const pub = createPublicClient({ chain: base, transport: http() });
const signer = Object.assign(account, { readContract: (args) => pub.readContract(args) });
const pay = wrapFetchWithPaymentFromConfig(fetch, {
schemes: [{ network: 'eip155:8453', client: new BatchSettlementEvmScheme(signer) }],
});
// the first call opens the channel (one EIP-3009 authorization, no ETH needed); the rest are vouchers
for (let i = 0; i < 5; i++) {
const res = await pay('https://x402.ochinimus.app/api/eth-price');
console.log(res.status, await res.json());
}
呼び出しの間は pay オブジェクトを維持してください。呼び出しごとに新しいプロセスを起動するクライアントは、バウチャーが未精算の間に一度だけ再同期を求められ、その後は同じリクエストでサービスを受けられます。
署名の前に支払い方法を確認するガードを含む完全なスクリプト:ops/proof-batch.mjs。
Arc での Gateway
Gateway の支払い方法は Arc でのみ利用できます(詳しい手順は下記の「Arc での支払い」を参照してください):ops/proof-gateway.mjs(デフォルトの CHAIN=arc)を使うと、GatewayWallet に一度入金し、ナノペイメントを 1 回支払います。
メインネットでの実績
- 2026年10月13日、Baseでのバッチ決済:チャネルを開設し、0x6175…4492のデポジットを入金しました。0.0005 USDCのバウチャー10件を請求し、トレジャリーに決済しました。2回目の実行では、請求ジョブの実行中に8件の呼び出しに支払いました。
- 2026年10月13日、Arc上のGateway:「Arcでの支払い」を参照してください。
いずれも自前のテストウォレットから支払いました。
Arcでの支払い
すべての有料ルートでは、Arcメインネット(eip155:5042、USDC 0x3600000000000000000000000000000000000000、小数桁数6)のUSDCを2つの方法で受け付けます。どちらも他の決済方式と同じ402に含まれています(プリペイドキーの購入ルートでは、該当する方式のみを提供します)。そのため、クライアントは保有している資産で支払えます。Arcのガス代はUSDCで支払うため、購入者はほかに何も必要ありません。
| x402 exact | Circle Gateway ナノペイメント | |
|---|---|---|
| 受け付ける方式 | scheme: exact | scheme: exact、extra.name: GatewayWalletBatched |
| 価格 | ルートの価格 | ルートの価格の半額、最低$0.0005 |
| 決済者 | Circle Facilitator Service、呼び出しごとに1件のトランザクション | Circle Gateway、バッチ処理 |
| 支払い先 | 0x0Cf44185564F2b72E291050DC79E578429E52f83 | Gatewayの販売者 0xA853129ACF56A851f9d51CD8cb47619465260Fa9 |
| 購入者に必要なもの | Arc上のUSDC | GatewayWallet 0x77777777Dcc4d5A8B6E418Fd04D8997ef11000eEへの一度限りのデポジット |
1回の呼び出し:x402 exact
import { privateKeyToAccount } from 'viem/accounts';
import { ExactEvmScheme } from '@x402/evm/exact/client';
import { wrapFetchWithPaymentFromConfig } from '@x402/fetch';
const account = privateKeyToAccount(process.env.ARC_KEY);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
schemes: [{ network: 'eip155:5042', client: new ExactEvmScheme(account) }],
});
const res = await pay('https://x402.ochinimus.app/api/liquidation-stats');
console.log(res.status, await res.json());
完全なスクリプト:ops/pay-arc.mjs。
複数回の呼び出し:Gatewayナノペイメント
import { GatewayClient } from '@circle-fin/x402-batching/client';
const client = new GatewayClient({ chain: 'arc', privateKey: process.env.ARC_KEY });
await client.deposit('0.02'); // once: approve + deposit, gas paid in USDC
const res = await client.pay('https://x402.ochinimus.app/api/liquidation-stats');
console.log(res.formattedAmount, res.data);
ライブのガス見積もりに基づいたデポジット額の算出とドライランを含む完全なスクリプト:ops/proof-gateway.mjs(CHAIN=arc)。
メインネットでの実績
- 2026年10月12日、Circleのファシリテーター経由のx402 exact:0x15e8…41d0
- 2026年10月13日、Gatewayへのデポジット0xffe7…9d50、続いて0.0005 USDCのナノペイメント(Circleの送金
d32e4ea9-2d62-4fd6-ad4c-6de70affba00) - 2026年10月14日、本番キーを使い、Circleのファシリテーター経由でx402 exact:0xee59…bf33。
/api/eth-priceへの0.001 USDCの呼び出しで、ステータスはokでした。
いずれも自前のテストウォレットから支払いました。
コード内の場所
lib/rails.js:Arcの決済方式(ネットワーク、アセット、payTo)。lib/circle-arc.js:Circle Facilitator Serviceのクライアント。Arc専用の/supported、/verify、/settleと、決済ステータスのポーリングを行います。決済が保留中の場合は支払いを保留し、ops/arc-reconcile.js用にログを記録します。lib/hf.js:半額料金の階層。Base、Polygon、Arbitrumでのバッチ決済、ArcでのGatewayオファー、半額ルール、およびGatewayの支払いをCircleのBatchFacilitatorClientに渡すrouteGatewayを含みます。それ以外の支払いでは引き続き各ファシリテーターを使用します。ops/batch-claim.js:30分ごとにバッチ決済のバウチャーを請求し、決済します。payments.js:ファシリテーターの順序。まずCoinbase CDP、次にArcではCircle、最後にGatewayの階層を使用します。ops/gateway-withdraw.mjsとops/arc-sweep.mjs:ホットアドレスから収益を引き出します。test/arc.test.js。
すべてのチェーンで支払い可能
9つのネットワークは、有料ルートのすべての 402 に含まれています。さらに11のネットワークもリクエストに応じて利用できます。ルートの末尾にネットワークを付けて指定してください:GET /api/<route>|<network>(| は %7C として送信してもかまいません)。たとえば、Celo の場合は /api/sol-price|eip155:42220 です。返される 402 にはデフォルトの accept とそのネットワークの accept が含まれ、どのネットワークで支払っても通常の URL で受け付けられます。プリペイドキーの購入ルートに含まれるのは9つのネットワークのみです。最初の6つのネットワーク(Solana、Base、Polygon、Arbitrum、Arc、Algorand)については、「1つの 402 に2つの決済プロトコル」と「Arc で支払う」で説明しています。次の表には、lib/ext-rails.js から生成された残りの14のネットワークを示します。すべての行で scheme: exact(EIP-3009)を使用し、同じ EVM トレジャリーに支払い、各行に記載された1つのファシリテーターによって決済されます。
| ネットワーク | CAIP-2 ID | トークンとアドレス | 小数点以下の桁数 | ファシリテーター | 提供状況 | ルートの最低価格 |
|---|---|---|---|---|---|---|
| Optimism | eip155:10 | USDC 0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85 | 6 | Ultravioleta | すべての 402 | なし |
| Monad | eip155:143 | USDC 0x754704Bc059F8C67012fEd69BC8A327a5aafb603 | 6 | Ultravioleta | すべての 402 | なし |
| Avalanche | eip155:43114 | USDC 0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E | 6 | Ultravioleta | すべての 402 | なし |
| Celo | eip155:42220 | USDC 0xcebA9300f2b948710d2653dD7B07f33A8B32118C | 6 | Ultravioleta | リクエストに応じて | なし |
| HyperEVM | eip155:999 | USDC 0xb88339CB7199b77E23DB6E890353E22632Ba630f | 6 | Ultravioleta | リクエストに応じて | なし |
| Unichain | eip155:130 | USDC 0x078D782b760474a361dDA0AF3839290b0EF57AD6 | 6 | Ultravioleta | リクエストに応じて | なし |
| Scroll | eip155:534352 | USDC 0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4 | 6 | Ultravioleta | リクエストに応じて | なし |
| SKALE Base | eip155:1187947933 | USDC.e 0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20 | 6 | Ultravioleta | リクエストに応じて | なし |
| BNB Chain | eip155:56 | AUSD 0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a | 6 | Ultravioleta | リクエストに応じて | なし |
| Ethereum | eip155:1 | USDC 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 | 6 | Ultravioleta | リクエストに応じて | なし |
| Robinhood Chain | eip155:4663 | USDG 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168 | 6 | Ultravioleta | リクエストに応じて | なし |
| World Chain | eip155:480 | USDC 0x79A02482A880bCE3F13e09Da970dC34db4CD24d1 | 6 | CDP | リクエストに応じて | なし |
| Sei | eip155:1329 | USDC 0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392 | 6 | PayAI | リクエストに応じて | $0.005 |
| X Layer | eip155:196 | USDC 0xB6CEceAB302E2E4948951eE7843FC24E92933061 | 6 | PayAI | リクエストに応じて | $0.005 |
トークンはどこでも USDC とは限りません。BNB Chain では AUSD、Robinhood Chain では USDG、SKALE Base では USDC.e で決済されます。Sei と X Layer は、PayAI が決済ごとに手数料を課すため、価格が $0.005 以上のルートでのみ利用できます。
@x402/fetch で支払う
@x402/fetch 2.28 は、クライアントが spendControls.allowedAssets で明示的に許可しない限り、@x402/evm の DEFAULT_ASSETS にないトークンを拒否します。標準のクライアントは、追加設定なしで Monad、Avalanche、Celo、Ethereum、Sei で支払えます。Optimism、HyperEVM、Unichain、Scroll、SKALE Base、BNB Chain、Robinhood Chain、World Chain、X Layer では、トークンが許可されるまで拒否されます。@x402/core の型定義にあるオプションの形式は次のとおりです。
spendControls?: {
maxAmountPerPayment?: Money | false; // USD cap on default assets, default "$1"
allowedAssets?: true | SpendControlAsset[]; // true allows any asset
}
interface SpendControlAsset {
network: Network; // CAIP-2, e.g. 'eip155:10'
asset: string; // on-chain token address, or a default-asset symbol
maxAmountPerPayment?: string; // integer atomic units, e.g. '50000' = $0.05 at 6 decimals
}
トークンを明示的に許可して Optimism で支払う例(上限の '50000' は $0.05 を表します。トークンは表に記載されたアドレスです)。
import { privateKeyToAccount } from 'viem/accounts';
import { ExactEvmScheme } from '@x402/evm/exact/client';
import { wrapFetchWithPaymentFromConfig } from '@x402/fetch';
const account = privateKeyToAccount(process.env.EVM_KEY);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
schemes: [{ network: 'eip155:10', client: new ExactEvmScheme(account) }],
spendControls: { allowedAssets: [{ network: 'eip155:10', asset: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85', maxAmountPerPayment: '50000' }] },
});
const res = await pay('https://x402.ochinimus.app/api/sol-price');
console.log(res.status, await res.json());
spendControls の行がない場合、同じクライアントは "All payment requirements were rejected by spendControls" というエラーをスローします。署名する前に accept を出力するドライランを含む完全なスクリプトは ops/r10-proof-evm.mjs です。
メインネットで実証済み
- 2026年10月14日、
/api/sol-price|<network>で0.001 USDCの決済を3件実施しました。それぞれ、テストウォレットからトレジャリーへの1回のUSDC送金です:Optimism 0xdc64…d4c5、Monad 0xdf06…da2d、Avalanche 0x5c3e…70d0。 - ほかの11ネットワークはリクエストに応じて提供しており、決済実績はまだありません。
いずれも、当社所有のテストウォレットから支払いました。
90個のツール(有料データルート83個+無料7個)と料金
有料83個+無料7個で、MCP レール上に合計90個あります(以下のプリペイドキー対応ルート8個はHTTP専用です)。すべての呼び出しはx402を通じてUSDCで個別に従量課金されます。バンドルも最低料金もありません。有料データツール83個をすべて1回ずつ呼び出すと、$1.137かかります。件数と料金は ライブマニフェストから集計したものです(2026-10-15閲覧)。
主力はget_squeeze_scoreです。資金調達率、ポジションの偏り、OIの積み上がり、そして当社独自の清算データの清算偏りをもとに算出する、0~100のショートスクイーズ/ロングフラッシュ複合指標です。たった1つの数値、わずか10セントで、「この取引は混み合っていて、誰かが痛い目を見る寸前か」を把握できます。
優位性 — 独自の清算テープ
| ツール | 価格 | ルート | 得られる情報 |
|---|---|---|---|
get_squeeze_score | $0.1 | /api/squeeze-score | Hyperliquid のあらゆる無期限先物について、ショートスクイーズスコアとロングの投げ売りスコアを 0~100 で取得できます。Hyperliquid のファンディング(35)、大口投資家のポジション偏り(25:個人投資家ではなく、対象コインを保有する Hyperliquid 上位 250 アカウントのネットロング比率)、独自の 5 分間隔サンプラーで記録した 24 時間の建玉増加(20)、独自のテープによる清算の偏り(20)を組み合わせたスコアです。取引が混み合っていて、誰かが損失を被りそうかどうかを示す数値です。上場していないシンボルの場合は 400 を返します。建玉記録が 24 時間分に満たない場合、または Hyperliquid や大口投資家のスナップショットを利用できない場合は 503 を返します。いずれの場合も課金されません。上位 250 アカウントのどれも保有していない上場コインの場合は 200 を返し、不足している入力を示す説明が含まれます。 |
get_liq_history | $0.05 | /api/liq-history | 時間ごとに集計した清算履歴を取得できます。USDT 無期限先物の銘柄ごと、または記録済みの全銘柄について、最大 7 日前までの各期間の合計、ロングとショートの USD 額、約定件数、最大の約定を確認できます。暗号資産業界で完全な清算テープを提供しているのは Bybit だけであり、清算履歴を公開している取引所はありません。 |
get_liq_heatmap | $0.02 | /api/liq-heatmap | 価格帯別の清算ヒートマップです。過去 N 時間に実際にレバレッジ解消が発生した価格帯について、各価格ゾーンの USD 額、約定件数、ロング/ショートの内訳を取得でき、最も清算が集中したゾーンも示されます。エントリー価格の推定ではなく、実際の清算約定に基づいています。BTC、ETH、SOL、HYPE、その他、複数の取引所にまたがる清算テープに記録されたあらゆる USDT 無期限先物が対象です。 |
get_cascade_history | $0.03 | /api/cascade-history | 清算カスケードの履歴を取得できます。独自のテープから再構成した、過去の同方向の清算集中イベントについて、開始・終了時刻、約定件数、USD 合計、最大の約定を最大 72 時間前まで確認できます。/api/cascade が「今」起きていることを示すのに対し、こちらはすでに起きたことを示します。 |
get_venue_liq_share | $0.02 | /api/venue-liq-share | 取引所ごとの清算状況を取得できます。Bybit、OKX、Binance における清算比率を、ロング/ショートの内訳と最大の約定とともに、銘柄ごとまたは記録済みの全銘柄について確認できます。どの取引所で、誰が清算されているかを把握できます。 |
get_cascade_forecast | $0.02 | /api/cascade-forecast | 清算予測です。過去に起きたことの説明ではなく、将来を予測します。今後 15 分間の清算額が、その銘柄における過去の 15 分間の 90 パーセンタイルを上回る確率を返します。600 万件を超える清算を含む、複数の取引所にまたがる独自の清算テープで調整され、6 時間ごとに再学習されます。この履歴を公開している取引所はないため、再構築できません。すべての回答には、具体的な予測対象、USD 建てのしきい値、参照した期間、その数値の根拠となる過去の発生回数、公開フィードを使って自分で結果を検証する手順が含まれます。十分な履歴がない状態では、推測せずにツールが回答を拒否し、その理由を示します。検証済みの記録は /api/forecast-record で無料で確認できます。 |
2つ目の堀 — 独自のトークン化株式ペッグテープ
| ツール | 価格 | ルート | 提供内容 |
|---|---|---|---|
get_peg_universe | $0.05 | /api/peg-universe | 時間外のペッグリスクで順位付けしたトークン化株式です。追跡対象のトークン化された米国株式すべてについて、p95と最大乖離(bps)、基準値となる市場開場時の乖離、流動性の中央値を取得できます。流動性のないプールは、完全なペッグとして報告するのではなく除外します。 |
get_peg_sessions | $0.03 | /api/peg-sessions | 取引セッション別のトークン化株式のペッグです。開場前、プレマーケット、時間外、夜間、週末それぞれの乖離を、平均、p95、最大値(bps)、流動性の中央値とともに取得でき、時間外で最も悪い時間帯にはフラグが付きます。市場開場時を基準値として扱います。 |
get_peg_deviation | $0.02 | /api/peg-deviation | Solana 上のトークン化株式のペッグ乖離です。トークン化された米国株式のオンチェーン DEX 価格と、原資産の直近の実際の取引価格との差を bps で示し、過去24時間の統計を市場開場時と時間外に分けて取得できます。独自のコレクターが5分ごとにサンプリングし、トークン価格はオンチェーンで読み取ります。latest.reference は null です。原資産の参照価格は返されません(その価格の提供元が再配布を許可していないため)。参照価格から算出した乖離のみを返します。 |
5分ごとにサンプリングします。乖離は原資産の直近の実際の取引価格を基準に測定します。米国市場の取引時間外では、これはリアルタイムの気配値ではなく、終値前の最後の約定価格です。流動性のないプールは、完全なペッグとして報告するのではなく除外します。
3つ目の堀 — 独自の担保換金流動性テープ
| ツール | 価格 | ルート | 提供内容 |
|---|---|---|---|
get_exit_method | 無料 | /api/exit-method | 測定方法と、各有料回答の根拠となる行数を説明します。リクエスト時にテープから算出します。 |
get_exit_quote | $0.02 | /api/exit-quote | 担保差し押さえ時の換金流動性です。ライブのルーティングに Kamino のリザーブを売却したときに、清算人が実際にいくら回収できるかを、プロトコルが担保評価に使うオラクル価格と比較します。max_exitable_usd(清算人のマージンがプラスのまま維持される最大の取引額。二分探索で特定し、その探索幅も示します)、換金可能な割合、ペナルティ下限を2%とした場合の保守的な上限を返します。また、実際に調査した最も近い取引額について、実現 USD 額、ヘアカット(bps)、清算人マージン(bps)を返します。トークンの見積もりをルーターが拒否した場合(流動性不足ではなく、アクセス制限)と、板にルートがない場合(実際の流動性に関する所見)を区別します。これは別々の事実ですが、これまでは同じステータスとして扱われていました。最終判定には、その銘柄固有のテープで6回連続して一致する観測結果が必要なため、見積もりが一度失敗しただけで所見が出ることはありません。判定を保留する場合は null を返さず、最後に裏付けが取れた測定値とその経過時間を返します。現在不良債権がゼロであっても、これらの懸念は否定されません。大規模な取引で検証せざるを得ない状況が、まだ誰にも発生していないということです。測定方法、裏付けのルール、行数は get_exit_method から無料で確認できます。 |
リアルタイムの清算と連鎖
| ツール | 価格 | ルート | 得られる情報 |
|---|---|---|---|
get_recent_liquidations | $0.005 | /api/liquidations | 暗号資産の清算、リアルタイムのテープ:Bybit、OKX、Binance 全体における最近の無期限先物の清算記録。タイムスタンプ、清算された側、数量、価格、米ドル換算額を取得できます。主要銘柄だけでなく、記録対象のすべての USDT 無期限先物が対象です。Bybit のテープは完全で、スロットリングされません。 |
get_cascade_alert | $0.01 | /api/cascade | 清算連鎖検出器、リアルタイム:各取引所において、SOL、BTC、ETH、XRP、DOGE で現在発生している、同じ側に集中した清算を検出します。清算された側、米ドル合計、記録件数、継続時間、深刻度を取得できます。記録対象のすべての無期限先物については /api/cascade-scan を使用してください。 |
get_cascade_scan | $0.05 | /api/cascade-scan | 記録対象のすべての USDT 無期限先物を対象にした清算連鎖スキャン。主要銘柄だけではありません。銘柄、清算された側、米ドル合計、記録件数、継続時間、深刻度を取得できます。複数の取引所から独自に収集した清算テープに基づいて算出されます。 |
get_liquidation_leaders | $0.02 | /api/liquidation-leaders | 清算ランキング:Bybit、OKX、Binance で記録対象となっているすべての USDT 無期限先物から、現在の清算額(米ドル)上位の銘柄を表示します。ロング/ショートの内訳、単一で最大の記録、取引所数も取得できます。急落している銘柄をランキング順に確認できます。 |
get_liquidation_stats | $0.01 | /api/liquidation-stats | 清算統計。SOL、BTC、ETH、XRP、DOGE の1時間および24時間の合計について、ロングとショートの米ドル換算額の内訳、単一で最大の記録、Bybit、OKX、Binance の取引所別内訳を取得できます。 |
get_liq_pulse | $0.005 | /api/liq-pulse | エージェントが現在清算されている対象を把握する必要がある場合に使用します。記録対象のすべての USDT 無期限先物について、直近60分間の米ドル合計、ロング/ショートの内訳、記録件数、上位5銘柄を返します。記録データが古い場合は503を返し、課金されません。 |
get_liq_feed | $0.001 | /api/liq-feed | エージェントが発生中の清算圧力を把握する必要がある場合に使用します。途切れのないカーソルから、各銘柄について取引所をまたいだロングとショートの清算額を5秒ごとの区間で返します。優勢な側と、その銘柄自身の基準値に対する圧力も確認できます。 |
デリバティブ
| ツール | 価格 | ルート | 得られる情報 |
|---|---|---|---|
get_funding_radar | $0.02 | /api/funding-radar | すべてのHyperliquid無期限先物を対象としたファンディングレーダーです。2026年10月13日時点で337銘柄あり、メインDEXに178銘柄、HIP-3 DEX(株式、指数、コモディティ、FX)に159銘柄あります。各無期限先物について、8時間換算した現在のファンディング、確定済みの過去データに対する30日間のzスコア、DEXと資産クラス、および|z|が2以上の場合のフラグを、極端なものから順に返します。デフォルトでは、建玉が1,000万ドル以上の無期限先物を返します。min_oi_usdで条件を変更でき、0を指定するとすべて返します。5分ごとに事前計算され、as_ofも含まれます。スナップショットが15分より古い場合は503を返し、料金は発生しません。 |
get_market_state | $0.02 | /api/market-state | BTC、ETH、SOL、HYPEの市場状況を1回の呼び出しで取得します。現物価格とHyperliquidオラクルに対する無期限先物のベーシス、実現ボラティリティ(7日・30日)、30日間のzスコア付きファンディング、建玉とその変化、Hyperliquid上位アカウントのネットロング比率、売買方向別の清算(1時間・24時間)、Fear and Greed、次回のFOMCまたはCPI発表、および明示されたしきい値に基づくフラグを返します。各項目にはデータソースと取得時刻が付いています。データがない項目は理由とともにnullになります。市場データをまったく構築できない場合は503を返し、料金は発生しません。 |
get_funding_extremes | $0.02 | /api/funding-extremes | 流動性の下限を超えるすべてのHyperliquid無期限先物を対象とした、ファンディングレートの極端値です。最も高いファンディングと最も低いファンディングを、年率換算の%、24時間の価格変動、建玉とともに返します。市場で最もポジションが偏っている取引がわかり、ショートが混み合っている場合は踏み上げ候補になります。 |
get_open_interest | $0.01 | /api/open-interest | 任意のHyperliquid無期限先物の建玉を取得します。マーク価格とともに、基準通貨単位および米ドル建ての建玉を返します。また、独自の5分間隔サンプラーによる1時間・24時間の変化も返します(記録がその期間分蓄積するまではnull)。/api/positioningでは、SOLとBTCのクジラのネットロング比率も取得できます。 |
get_oi_spike_scan | $0.02 | /api/oi-spike-scan | すべてのHyperliquid無期限先物を対象とした建玉の急増スキャンです。直近1時間の建玉変動が、各銘柄の前日と比べて異常な銘柄を、1時間・4時間・24時間の変化(コイン単位のため、価格変動は含まれません)、急増のzスコア、価格変動、ファンディングとともに返します。独自の5分間隔サンプラーのデータを使用します。記録が24時間分蓄積するまでは503を返し、料金は発生しません。 |
get_basis | $0.01 | /api/basis | 任意のHyperliquid無期限先物のベーシスを取得します。Hyperliquidオラクル価格(バリデーターが現物市場を基に算出する加重中央値)に対するマーク価格を、プレミアムまたはディスカウントの%、コンタンゴまたはバックワーデーションの判定、ファンディングの状況とともに返します。 |
get_volatility | $0.01 | /api/volatility | 任意のHyperliquid無期限先物の実現ボラティリティを取得します。日足ローソク足を基にした7日・30日の年率換算値と、当日の値幅を%で返します。ポジションサイズの決定に利用できます。 |
get_funding_history | $0.005 | /api/funding-history | 任意のHyperliquid無期限先物のファンディングレート履歴を、最大200回分の1時間ごとの決済データで返します。平均レート、年率換算の%、プラスだった間隔の割合、生データ系列を取得できます。実際のキャリーの状況を確認できます。 |
get_top_movers | $0.01 | /api/top-movers | 流動性の下限を超えるすべてのHyperliquid無期限先物を対象に、24時間の上昇率・下落率上位を、それぞれのファンディングレートとともに返します。「何が動いたか」を確認するスクリーナーです。 |
get_perp | $0.005 | /api/perp | エージェントが1回の呼び出しで1つの無期限先物市場の情報を必要とする場合に使用します。Hyperliquidのファンディングと建玉(独自の5分間隔サンプラーによる1時間・24時間の変化付き)、および売買方向別の内訳と独自の取引テープでの最大取引を含む24時間の清算情報を返します。上場していないシンボルの場合は400を返し、データ取得に失敗した場合は503を返します。どちらの場合も料金は発生しません。 |
get_funding_pulse | $0.005 | /api/funding-pulse | エージェントが現在の極端なファンディングレートを必要とする場合に使用します。流動性の下限を超えるHyperliquid無期限先物から、絶対値が大きい上位5件を、8時間レート、建玉、24時間の価格変動とともに返します。全件をスクリーニングせず、1回の呼び出しで取得できます。 |
マイクロストラクチャー
| ツール | 価格 | ルート | 得られる情報 |
|---|---|---|---|
get_orderbook_imbalance | $0.01 | /api/orderbook-imbalance | 任意の Hyperliquid パーペチュアルの注文板の不均衡を取得します。ミッド価格から±N bps以内にある買い板と売り板の未約定流動性(USD)、両サイドの比率、偏りの判定を返します。 |
get_orderbook_walls | $0.01 | /api/orderbook-walls | 任意の Hyperliquid パーペチュアルの注文板の壁を取得します。各サイドで最も大きな未約定注文について、USD建てのサイズとミッド価格からの距離を返します。 |
市場とポジショニング
| ツール | 価格 | ルート | 得られる情報 |
|---|---|---|---|
get_spot | $0.001 | /api/price | 取引所を指定せずにスポット価格が必要なエージェント向けです。SOL、BTC、ETHのオンチェーン DEX 価格を返します。Solana、Ethereum、Base 上の流動性の高い USDC プールの中央値を、オンチェーンの状態から読み取り、価格の取得元となったプールも返します。それ以外のシンボルは、対応シンボル一覧とともに 400 を返し、課金されません。 |
get_sol_price | $0.001 | /api/sol-price | SOL の価格、つまり USD 建ての Solana スポット価格をオンチェーンからリアルタイムで読み取ります。Solana 上の流動性が最も高い 2 つの SOL/USDC プール(Orca Whirlpool、Raydium CLMM)の中央値を、オンチェーンの状態から計算します。価格、読み取り時刻、応答したプールを返します。 |
get_btc_price | $0.001 | /api/btc-price | BTC の価格、つまり USD 建ての Bitcoin スポット価格をオンチェーンからリアルタイムで読み取ります。Base と Ethereum 上の 3 つの Uniswap V3 読み取り値(cbBTC/USDC、および WETH/USDC 経由の cbBTC と WBTC)を、オンチェーンの状態から計算した中央値です。価格、読み取り時刻、応答したプールを返します。 |
get_eth_price | $0.001 | /api/eth-price | Ethereum と Base 上にある、流動性が最も高い 2 つの WETH/USDC Uniswap V3 プールから、ETH の USD 建てスポット価格をオンチェーンで読み取ります。中央値に加え、各プールの価格も返すため、呼び出し元はチェーン間の価格差を確認できます。オンチェーンの状態から計算し、取引所の価格フィードは使用しません。 |
get_funding_rate | $0.005 | /api/funding-rate | 任意の Hyperliquid パーペチュアルの資金調達率を取得します。未加工のレート、時間単位の間隔、8時間換算レート、年率換算レート、次回の資金調達時刻、マーク価格を返します。シンボルを指定しない場合は、Hyperliquid の SOL および BTC パーペチュアルの資金調達率と建玉を返します。30日間の Z スコアを含む全体の表は /api/funding-radar で取得できます。 |
get_market_snapshot | $0.005 | /api/market-snapshot | 1回の呼び出しで暗号資産市場のスナップショットを取得します。DEX プールからオンチェーンで読み取った SOL と BTC のスポット価格、マーク価格と建玉を含む両方の Hyperliquid パーペチュアルの資金調達率、分類付きの Fear & Greed 指数を返します。5回分の読み取りを、1回の支払いで利用できます。 |
get_positioning | $0.005 | /api/positioning | Hyperliquid の SOL および BTC パーペチュアルのポジショニングを取得します。1時間および24時間の変化を含む建玉と、Hyperliquid 上位250アカウントのネットロング比率を返します。それ以外の Hyperliquid パーペチュアルについては、/api/open-interest を使用してください。 |
get_trade_context | $0.01 | /api/trade-context | 1回の呼び出しで暗号資産取引のコンテキストを取得します。DEX プールからオンチェーンで読み取った SOL と BTC の価格、パーペチュアルの資金調達率、Fear & Greed、ポジショニング(建玉と Hyperliquid 上位アカウントのネットロング比率)、1時間および24時間の清算統計を返します。取引前に把握すべき情報をすべて、1回の支払いで取得できます。 |
get_hl_whales | $0.02 | /api/hl-whales | 大口 Hyperliquid トレーダーのポジショニングを把握したいエージェント向けです。Hyperliquid 上位アカウントの未決済パーペチュアルポジションをコインごとに集計し、USD建てのネットロングまたはネットショート、アカウント数、サイズ加重平均エントリー価格、名目価値加重の清算価格までの距離、清算価格の10%以内にある名目価値、未実現損益(uPnL)を返します。coin=BTC を指定すると、5%刻みの価格帯ごとのクジラの清算水準と最大ポジションを返します。5分ごとに更新され、データが古い場合は 503 を返します。 |
Solana オンチェーン
| ツール | 価格 | ルート | 提供内容 |
|---|---|---|---|
get_wallet_holdings | $0.008 | /api/wallet-holdings/:wallet | 任意のアドレスの Solana ウォレット保有資産です。AgentFeed 独自のオンチェーン SOL 価格による米ドル換算額付きのネイティブ SOL、ミント、シンボル、数量(トークン価格は含みません)を含むすべての SPL トークン、および NFT の数を取得できます。残高とオンチェーンメタデータは Helius DAS getAssetsByOwner から取得し、最大 100 件の資産に対応します。 |
get_token_metadata | $0.005 | /api/token-metadata/:mint | 任意の Solana ミントの SPL トークンメタデータです。名前、シンボル、URI、小数桁数、総供給量、ミント権限と凍結権限、トークンプログラム、およびメタデータがまだ変更可能かどうかを取得できます。ミントアカウントとそのメタデータアカウントから読み取ります。 |
get_token_risk | $0.01 | /api/token-risk/:mint | 任意の SPL ミントの Solana トークンラグチェック/リスクシグナルです。ミント権限と凍結権限の状態(取り消されていればより安全)、上位 1 位と 10 位の保有者への集中度、供給量、およびリスクフラグのリストを取得できます。ハニーポットや LP ロックのチェックではありません。 |
get_token_holders | $0.02 | /api/token-holders/:mint | 任意の SPL トークンの上位保有者です。Solana ミントについて、アカウントごとの保有割合と上位 1 位、5 位、10 位への集中度を取得できます。/api/token-risk の概要よりも詳しい情報です。 |
get_wallet_activity | $0.02 | /api/wallet-activity/:wallet | Solana ウォレットのアクティビティです。任意のアドレスの最近のトランザクションを取得でき、それぞれにウォレットの SOL とトークンの残高変動、手数料、失敗、および呼び出されたプログラムが含まれます。チェーンから読み取り、当社が要約します。 |
get_priority_fees | $0.005 | /api/priority-fees | 現在の Solana 優先手数料です。過去約 150 スロットのうち、最も利用の多い SOL/USDC プールで支払われたスロットあたりの最低手数料について、最小から最大までのパーセンタイルを、計算ユニットあたりのマイクロ lamport 単位で取得できます。推奨レベルも含まれます。トランザクションを着地させる必要があるボット向けです。 |
get_jito_tips | $0.005 | /api/jito-tips | オンチェーンでサンプリングされた Jito チップです。Jito のチップアカウントへの最新送金額の p25 から p99 までを SOL 単位で取得できます。実際に着地したバンドルが支払った額も含まれ、15 分ごとに更新されます(回答にデータの経過時間が記載されます)。着地に関する推奨事項も含まれます。 |
get_sol_network | $0.005 | /api/sol-network | Solana ネットワークの健全性です。最近の平均 TPS、現在のスロット、現在のエポック、およびエポックの進捗率(%)を取得できます。 |
get_sol_token_check | $0.025 | /api/sol-token-check/:mint | エージェントが Solana トークンの取引前チェックを必要とするときに使用します。ミント権限と凍結権限、Token-2022 のトラップ、上位保有者、最も流動性の高いプールと米ドル建ての流動性、100 ドルおよび 1,000 ドルの買い付けによる価格への影響、pump.fun の進捗状況、すべてのルールに基づく判定を返します。 |
get_sol_token_flow | $0.008 | /api/sol-token-flow/:mint | エージェントが Solana トークンを誰が取引しているか把握する必要があるときに使用します。直近のスワップにおけるユニークなトレーダー、上位 5 位の出来高シェア、往復取引を行うウォレット、新規購入者のウォレットが占める割合、および発行から 7 日未満のミントについてはローンチスロットのバンドルサイズを返します。 |
get_sol_holder_clusters | $0.008 | /api/sol-holder-clusters/:mint | エージェントが Solana トークンの保有者が単一の所有者かどうか把握する必要があるときに使用します。上位 20 ウォレットそれぞれに最初に資金を提供したアカウント、資金提供元を共有するクラスター、およびそれらが占める供給量の割合を返します。資金提供元が取引所である場合もあります。 |
Base / EVM
| ツール | 価格 | ルート | 得られる情報 |
|---|---|---|---|
get_base_gas | $0.005 | /api/base-gas | Base(チェーン 8453)のガス価格を、gwei と wei の両方で返します。ノードから取得できる場合は、ベース手数料、優先手数料、ブロック番号も含まれます。wei で尋ねる呼び出し元も gwei で尋ねる呼び出し元も、同じ情報を求めているため、両方の単位を返します。キー不要のパブリック RPC を3つのノードでフォールバックしながら利用するため、ローテーションや有効期限を気にする API キーはありません。 |
get_base_balance | $0.005 | /api/base-balance | 0x アドレスまたは ENS 名を指定して、Base または Ethereum メインネット上の ERC20 とネイティブ ETH のウォレット残高を取得します。decimals() と symbol() は18桁と仮定せず、リクエスト時にコントラクトから読み取ります。18桁と仮定すると、USDC 残高が実際の1兆倍として報告されるためです。ENS は独立した2つのリゾルバーを通じて解決し、両者が一致した場合にのみ結果を使用するため、誤ったアドレスに対して誤ったウォレットの残高を確信を持って返すことはありません。未対応のチェーンは、別のチェーンの情報を黙って返すのではなく、リクエストを拒否します。 |
| get_honeypot_check | $0.01 | /api/honeypot-check | エージェントが Base、BNB Chain、Ethereum 上のトークンを購入する前に、そのトークンを売却できるか確認する必要がある場合に使用します。トークンの最大規模のプールで独自の売買シミュレーションを実施した判定と、測定した購入税・売却税を返します。さらに、ウォレット間の送金が機能するか、バイトコードのフラグ(ミント可能、ブラックリスト、プロキシ、一時停止可能、オーナー)、シミュレーションとバイトコードの判定が食い違う箇所、およびブロックも返します。Uniswap、Aerodrome、PancakeSwap のプールに対応しています。プールが見つからない場合も結果として返し、RPC エラーの場合は 503 を返します。 |
| get_base_launches | $0.02 | /api/base-launches | エージェントが Base の最新トークンローンチを確認する必要がある場合に使用します。過去24時間以内に Base で作成された Uniswap V4、V3、V2、Aerodrome のプールを、新しい順に、ローンチパッド、流動性、取引量とともに返します。それぞれについて、ペア、作成時刻、V4 フックから特定したローンチパッド(Zora、Clanker、Doppler、Flaunch)、クオート側の流動性、24時間の取引量とスワップ数、および最も取引の多いプールのハニーポットシミュレーションを含みます。Base のログを毎分読み込み、スナップショットが5分より古い場合は 503 を返します。 |
申告書類、文書、ウェブ
| ツール | 料金 | ルート | 内容 |
|---|---|---|---|
get_sec_filings | $0.005 | /api/sec-filings | エージェントが米国企業の最新のSEC申告書類を必要とする場合に使用します。ティッカーに対応する最新のEDGAR申告書類を返します。必要に応じて、フォームの種類(10-K、10-Q、8-K、4、S-1、13F-HR)を1つ指定できます。申告日、報告日、アクセッション番号、説明、8-Kの項目コード、文書および申告書類インデックスへのリンクも含まれます。ソース:SEC EDGARの公開申告書類。 |
get_insider_trades | $0.01 | /api/insider-trades | エージェントが企業の内部関係者による売買内容を必要とする場合に使用します。企業の最近のSEC Form 4申告書類から、取引ごとに1行を返します。内部関係者、役職、取引コードとその意味、株数、価格、金額、取引後の保有株数、日付に加え、対象期間の公開市場での買付と売却の合計が含まれます。ソース:SEC EDGAR Form 4申告書類。 |
get_sec_8k | $0.01 | /api/sec-8k | エージェントが過去数時間に米国企業が開示した重要事象を必要とする場合に使用します。対象期間に市場全体で提出された8-K申告書類を返します。企業、CIK、申告時刻、アクセッション番号、8-Kの項目コードとタイトル(例:2.02 決算、5.02 役員の変更、1.01 契約)、項目ごとの件数が含まれます。ソース:SEC EDGARの最新申告書類。 |
get_web_markdown | $0.005 | /api/web-markdown | エージェントがウェブページの読みやすいテキストをMarkdown形式で必要とする場合に使用します。指定した1つのURLの主要コンテンツを、タイトル、最終URL、取得時刻、単語数とともに、整形済みMarkdownとして返します(Mozilla Readability、続いてturndownを使用)。ポート80と443のhttpまたはhttps、5 MB、10秒に対応します。robots.txtを遵守し、プライベートアドレスへのアクセスは拒否します。ブロックされたURLまたは到達不能なURLに対して料金は発生しません。 |
get_pdf_markdown | $0.01 | /api/pdf-markdown | エージェントがPDFのテキストをMarkdown形式で必要とする場合に使用します。指定した1つのPDF URLのテキストを、ページごとにMarkdown形式で返します。タイトル、ページ数、単語数も含まれます。httpまたはhttps、10 MB、10秒に対応します。robots.txtを遵守し、プライベートアドレスへのアクセスは拒否します。PDF以外のファイル、テキストレイヤーのないPDF(スキャン画像)、または到達不能なURLに対して料金は発生しません。 |
マクロ経済
| ツール | 料金 | ルート | 内容 |
|---|---|---|---|
get_macro_calendar | $0.005 | /api/macro-calendar | トレーダー向けのFOMC、CPI、NFP、PCEカレンダーです。次回の米連邦準備制度(Fed)金利決定と、CPI、非農業部門雇用者数、PCEの発表日を、ニューヨーク時間から換算したUTC時刻(夏時間に対応)で提供します。それぞれに公式のFed、BLS、BEAのソースURLと、確認時刻が付いています。各機関のページから毎日取得し、手入力は一切行いません。データの確認から35日を超えている場合は503を返し、料金は発生しません。 |
get_fx_rates | $0.002 | /api/fx-rates | エージェントが公式の日次為替レートを必要とする場合に使用します。ECBが公表する約30通貨のユーロ外国為替参照レートを、ユーロ建て、または別の基準通貨に対するクロスレートとして返します。さらに、Hyperliquid HIP-3の為替および商品マークも提供します。ECBのレートはECBのウェブサイトで無料で入手できます。情報提供のみを目的としており、取引には使用できません。 |
TradFi 無期限先物と株式
| ツール | 価格 | ルート | 内容 |
|---|---|---|---|
get_tradfi_radar | $0.02 | /api/tradfi-radar | 資金調達率順に並べた株式無期限先物、S&P 500、Nasdaq、金、原油の無期限先物です。HyperliquidのHIP-3 DEX(trade[XYZ]、Paragon、Markets by Kinetiq、Entropy)にあるすべての株式、指数、コモディティ、FXの無期限先物を対象とし、8時間換算の資金調達率、30日間の資金調達率zスコア、建玉とその24時間変化、マーク価格とオラクル価格の乖離、24時間取引高を返します。資産クラスで絞り込めます。5分ごとに事前計算されます。データが古い場合は503を返します。 |
get_equity_24h | $0.01 | /api/equity-24h | 米国株の週末価格です。Hyperliquidの株式無期限先物と当社のトークン化株式DEX価格から、株式または指数(TSLA、NVDA、S&P 500、Nasdaq)の参考となる24時間価格を取得します。直近の通常取引時間中の価格、その時刻と情報源、価格差(%)、各情報源の流動性、取引セッション(通常取引、プレマーケット、アフターマーケット、夜間、週末)も返します。あくまで参考価格であり、取引所の気配値ではありません。いずれの情報源にも流動性がない場合は503を返します。 |
get_tradfi_perps | $0.005 | /api/tradfi-perps | 市場時間外に株式、指数、コモディティ、通貨の24時間価格が必要なエージェント向けです。HyperliquidのHIP-3無期限先物市場について、オラクル価格とマーク価格、プレミアム、1時間および8時間の資金調達率、建玉、24時間変化、DEXを返します。シンボル(TSLA、GOLD、EUR、xyz:TSLA)を指定すると、そのシンボルのすべての稼働中市場を返します。指定しない場合は全市場の一覧を返します。価格は各市場独自のHIP-3オラクル価格とマーク価格です。 |
調査、コンプライアンス、ユーティリティ
| ツール | 価格 | ルート | 提供内容 |
|---|---|---|---|
get_sanctions_check | $0.008 | /api/sanctions-check/:address | エージェントが暗号資産ウォレットへの支払い、またはウォレットからの支払いを行う前にスクリーニングする必要がある場合に使用します。Bitcoin、Ethereum、Tron、SolanaなどのアドレスをOFAC SDNリストと照合し、完全一致する項目、プログラム、リストの日付を返します。一致しないことは、制裁対象外であることを意味しません。 |
get_email_verify | $0.005 | /api/email-verify | エージェントがメールアドレスでメールを受信できそうか確認する必要がある場合に使用します。構文、MX、使い捨てドメイン、ロールアカウント、無料プロバイダーのチェック結果と、deliverable_likely、risky、undeliverableの判定およびその理由を返します。SMTPプローブは行いません。 |
get_domain | $0.005 | /api/domain/:domain | エージェントがドメインの基本情報を確認する必要がある場合に使用します。DNSのA、AAAA、MX、NS、TXTレコードと、有効なTLS証明書の発行者、代替名、有効期間、失効までの日数を返します。公開ホストのみが対象で、レジストラー情報は含みません。 |
get_papers | $0.015 | /api/papers | エージェントがトピックに関する学術論文を探す必要がある場合に使用します。検索結果に該当するOpenAlexの研究成果(CC0データ)について、タイトル、年、DOI、著者、掲載誌、被引用数、オープンアクセスリンクを最大25件返します。指定した年以降に絞り込むこともできます。24時間キャッシュされます。 |
get_paper | $0.005 | /api/paper/:doi | エージェントがDOIに対応する論文を確認する必要がある場合に使用します。タイトル、年、著者、掲載誌、被引用数、オープンアクセスURLと、OpenAlexに登録されている場合は抄録を返します(CC0データ)。DOIは、スラッシュを含め、記載どおりにパスへ指定します:/api/paper/10.1038/nature14539。 |
get_wiki | $0.005 | /api/wiki | エージェントがトピックの信頼できるプレーンテキスト要約を必要とする場合に使用します。任意の言語のページタイトルについて、Wikipediaの要約と導入部、CC BY-SA 4.0ライセンス、記事URL、著者リンクを返します。24時間キャッシュされます。 |
get_qr | $0.005 | /api/qr | エージェントがリンク、アドレス、支払い文字列のQRコードを必要とする場合に使用します。誤り訂正レベルMで、スキャンしやすいサイズに調整したSVGまたはPNG(base64およびデータURI)を返します。入力は最大2 KBで、それを超える場合は400エラーとなり、課金されません。 |
get_hash | $0.005 | /api/hash | エージェントが自身で計算すべきでないハッシュを必要とする場合に使用します。UTF-8テキストまたは16進バイト列のSHA-256、Keccak-256(Ethereumのハッシュ)、BLAKE2b-512を、16進数および0x付きの16進数で返します。入力は最大2 KBで、それを超える場合は400エラーとなり、課金されません。 |
get_time | $0.005 | /api/time | エージェントが適切な夏時間ルールを適用した正確な時刻変換を必要とする場合に使用します。任意のIANAタイムゾーンで、ISO時刻またはエポックを返します。現地時刻とオフセット、曜日、略称、DSTフラグ、エポックが含まれます。既定値はUTCの現在時刻です。 |
get_convert | $0.005 | /api/convert | エージェントが正確な単位変換を必要とする場合に使用します。長さ、質量、体積、時間、データ、速度、面積、圧力、エネルギー、温度の単位間で変換した値を、有効数字12桁で返します。異なるカテゴリー間の変換は400エラーとなり、課金されません。 |
情報源とその利用条件:OFAC SDNリスト(米国連邦政府の著作物)、CC0の使い捨てメールドメインリスト、DNSと有効な TLSハンドシェイク、OpenAlex(CC0データ)、Wikipedia(CC BY-SA 4.0、回答ごとに帰属表示が必要)。詳細は docs/SOURCES.mdを参照してください。
言語タスク(用途固定、Gemini)
| ツール | 料金 | ルート | 内容 |
|---|---|---|---|
get_ocr | $0.04 | /api/ocr | エージェントが画像内のテキストを必要とする場合に使用します。PNG、JPEG、WebP、GIF(5 MB、1 辺あたり 4096 px)のテキストを、改行を含むブロック単位で読み取り順に返し、検出された言語も返します。テキストを文字起こしするだけで、画像内のテキストの指示には従いません。 |
get_summarize | $0.02 | /api/summarize | エージェントがウェブページや PDF の要点を必要とする場合に使用します。要点を含む短い要約または中程度の長さの要約を返し、文書が 20,000 トークンで打ち切られたかどうかと、読み取った量を示します。文書に書かれている内容だけを使用します。 |
get_extract | $0.025 | /api/extract | エージェントがページや PDF から名前付きフィールドを必要とする場合に使用します。最大 20 個のフィールド(string、number、boolean、date、string[])のスキーマに対する JSON を返します。文書に記載されていない項目は null とし、値を捏造することはありません。 |
get_translate | $0.04 | /api/translate | エージェントが別の言語のテキストを必要とする場合に使用します。最大 4,000 文字を指定された言語コード(de、fr、ja、pt-BR)に翻訳し、改行、数字、URL を保持して、検出された原文の言語も返します。テキスト内の指示には従いません。 |
get_classify | $0.005 | /api/classify | エージェントがテキストを独自のカテゴリに分類する必要がある場合に使用します。最大 4,000 文字、2~20 個のラベルに対し、合計が 1 になるラベルごとのスコアと最適なラベルを返します。ラベルは名前であり、指示ではありません。24 時間キャッシュされます。 |
get_injection_check | $0.004 | /api/injection-check | エージェントが信頼できないテキストをプロンプトインジェクションの試みについて審査する必要がある場合に使用します。最大 4,000 文字に対し、no_injection_found、suspicious、malicious のいずれかを返し、一致したルール(ロールタグ、隠し Unicode、エンコードされたペイロード)とモデルの見解も返します。 |
get_transcribe | $0.02 | /api/transcribe | エージェントが音声ファイル内の言葉を必要とする場合に使用します。mp3、wav、m4a、ogg、webm 音声(10 MB、5 分。ファイルから確認)について、テキスト、時間付きセグメント、話されている言語を返します。音声自体をキーとして 24 時間キャッシュされます。 |
各ツールは、Google の Gemini API(有料プラン)で単一の用途に固定されたタスクです。呼び出し元が渡すのはコンテンツのみで、プロンプト、モデル、設定は渡しません。 信頼できないコンテンツは区切られたデータとして扱われ、すべての出力はスキーマ検証されます。プロバイダーの障害は 503 となり、料金は請求されません。 これら 7 つのツールは Google が利用可能としている地域 内の呼び出し元のみ利用できます。 それ以外の地域では、支払いが発生する前に 451 を返します。
トレーディングボット向けシグナル
| ツール | 料金 | ルート | 内容 |
|---|---|---|---|
get_signal_board | $0.01 | /api/signal-board | Hyperliquid の無期限先物市場を建玉で順位付けした 1 つの表で提供します。価格変動、資金調達率、OI とその変動、直近 1 時間の清算(そのコイン自身の過去 7 日間に対する z スコア付き)、クジラのネットポジションと傾き、crowded_long、crowded_short、squeeze_risk、liq_spike のフラグ(ルールは説明を参照)が含まれます。1~5 分ごとにポーリングしてください。 |
get_coin_signal | $0.004 | /api/coin-signal/:coin | 1 つのコインについて同じ行を返し、15 分間のカスケード確率、価格の上下で最も近い清算クラスター、上位 3 件のクジラのポジションも提供します。 |
どちらのツールも、このサービスが独自に記録したデータ(Hyperliquid の OI サンプラー、清算テープ、クジラのスナップショット)のみを読み取り、すべてのデータソースを as_of とともに明示します。データソースが古い場合は 503 を返し、料金は請求されません。前払いキーを使用すると、料金はそれぞれ $0.005 と $0.002 です。
ボット向け清算圧力フィード
GET /api/liq-feed は、AgentFeed が独自に記録した清算データから算出する、取引所横断の清算圧力です。ボットがポーリングする方法に合わせて、5 秒バケット、スキップも重複もしないカーソル、最低価格を提供します。
- 各行の内容。 清算が発生した、クローズ済みの 5 秒バケットごとに、シンボルごとに 1 行を返します。
longsとshorts(清算されたロングおよびショートポジションの USD 額、基準数量、VWAP。全取引所のデータを合算した値)、dominant(longs、shorts、balancedのいずれか。バケットの少なくとも 60%を占める側)と、pressure(バケットの USD 額を、そのシンボルにおける 5 秒あたりの典型的な USD 額で割った値。直近 7 日間の各時間の中央値を使い、1 時間あたり $5,000 を下限とします)を返します。数値は有効数字 2 桁(VWAP は 3 桁)に丸められ、約定件数は返されません。 - カーソル。 最初に
since=<ms>(最大 24 時間前まで)を指定し、その後は各応答のnextを変更せずに次のリクエストへ渡します。指定しない場合、最初の呼び出しは 2 分前から始まります。バケットはクローズから 10 秒経過してから配信され、クローズ済みの各バケットは必ず 1 回だけ配信されます。has_moreはすぐに再リクエストすべきことを示します。1 回の呼び出しで最大 20 シンボル、500 行まで取得できます(symbols=BTC,ETH,SOLまたはBTC-USDT形式)。 - ボットの利用料金。 x402 経由では 1 回あたり $0.001、プリペイドキーでは $0.0005 です。呼び出し元、x402 の支払者、またはプリペイドキーごとに、5 秒に 1 回(1 バケット)までです。パスキーの場合は 10 秒に 1 回までです(拒否されたポーリングは
Retry-Afterを伴う 429 となり、課金されません。has_moreを示す応答の後に行う呼び出しは制限の対象外です)。キーでは REST と MCP ツールget_liq_feedの間で同じ単一の時間制限が適用されます。x402 の支払者は、REST では IP、MCP では支払いウォレットで識別されます。対象期間は 5 秒単位で進むため、それより早く呼び出しても新しいバケットは取得できません。5 秒間隔の場合、キーでは 1 日あたり 17,280 回、$8.64です。30 秒間隔では 1 日あたり 2,880 回、$1.44、60 秒間隔では $0.72 です。ボットパス(このルートのみ、30 日間有効で一律 $25)なら、ポーリング間隔にかかわらず 1 日あたり $0.83 です。
curl -s -H "X-AgentFeed-Key: $AGENTFEED_KEY" \
"https://x402.ochinimus.app/api/liq-feed?symbols=BTC,ETH,SOL&since=$(( $(date +%s) * 1000 - 300000 ))"
無料で試せるツール
全部で 7 つあり、そのうち 4 つに HTTP ルートがあります。この 4 つは / の free_tools に掲載されています。残りの 3 つは MCP 専用で、対抗する有料 HTTP 版はありません。
| ツール | ルート |
|---|---|
get_fear_greed | /api/fear-greed |
get_last_liquidation | /api/last-liquidation(15 分遅延) |
get_exit_method | /api/exit-method |
get_cascade_forecast_free | MCP 専用 — 品質を落としていない SOL 清算予測。非公開のデータはありません |
get_forecast_question | MCP 専用 — 予測で分かることと、自分で検証する方法 |
get_forecast_record | /api/forecast-record — 生データ行付きの、リアルタイムで更新される決済済み実績 |
pricing | MCP 専用 — ライブ価格付きの全項目一覧 |
さらに、独自のツールを持たない無料の HTTP エンドポイントが 2 つあります。
| エンドポイント | 取得できる内容 |
|---|---|
GET /api/sample | 保存済みのサンプル応答があるすべての有料ルートを一覧表示します |
GET /api/sample/<route> | 有料ルートのいずれかで実際に取得した応答です。Bazaar の掲載情報に含まれるものと同じ例で、価格、入力スキーマ、有料 URL を含みます。料金を支払う前に、ルートの応答内容を確認できます。 |
無料ルートは "paid": false、有料ルートは "paid": true を返します。このフィールドはリクエストごとの値で、呼び出したルートに料金が設定されているかどうかを示します。上記 2 つのエンドポイントはいずれも curl で無料で呼び出せ、そのことも応答で確認できます。
elizaOS エージェントから利用する
npm i @seekdaseek/plugin-agentfeed # one action per data route; the current version is on npm
資金を入金した Solana ウォレットの AGENTFEED_PRIVATE_KEY を設定すると、エージェントが呼び出しごとに自動で支払います。デフォルトの支出上限は 1 回あたり $0.50 です(変更するには AGENTFEED_MAX_SPEND_PER_CALL を設定します)。
今すぐ無料で試す
curl https://x402.ochinimus.app/api/fear-greed # "paid": false — it really is free
curl https://x402.ochinimus.app/api/last-liquidation
curl https://x402.ochinimus.app/api/exit-method
curl https://x402.ochinimus.app/ # full pricing index + live coverage
curl https://x402.ochinimus.app/api/cascade-scan # returns 402 + payment terms
x402 クライアントは自動で支払い、再試行します。
プリペイドキー(x402 で支払えないボット向け)
HTTP ヘッダーは設定できても x402 決済に署名できないボット(n8n、Freqtrade、Hummingbot、単純なスクリプト、claw402 などのゲートウェイ)は、キーを一度購入し、呼び出しごとに残高を消費します。
- 一度だけ購入: 任意の x402 クライアントを使い、ルートが提供する正確な決済手段で購入します:
GET /api/keys/buy-trial($0.25)、buy-1、buy-5、buy-20。キーをヘッダーに指定して、topup-5またはtopup-20でチャージできます。または Base ウォレットを使って、ブラウザーで /keys から購入できます。このページはライブラリを読み込まず、キーのハッシュ以外は何も送信しません。 - 呼び出しごとに消費: 有料の GET または
POST /mcpで、X-AgentFeed-Key: afk_...(またはAuthorization: Bearer afk_...)を送信します。各呼び出しで、残高から**ルートの x402 価格の半額(最低 $0.0005)**が引かれます。400、404、500、503 の応答では引かれません。キーごとに毎分 120 リクエストまでです。 - キーの持ち込み: 自分で
afk_+ 32 個のランダムバイトを base58 エンコードしたものを生成し、?key_hash=<sha256 hex>&prefix=<8 characters after afk_>を指定して購入できます。サーバーはハッシュを登録し、キーそのものを受け取ることはありません。また、決済後に接続が切れても、失うものはありません。key_hashを指定しない場合、サーバーがキーを生成し、一度だけ返します。 - ボットパス:
GET /api/keys/buy-pass($25)は、終日/api/liq-feedをポーリングするボット向けの、別種のキーです。決済が確定した時点から 30 日間有効で、/api/liq-feed(および MCP ツールget_liq_feed)のみで使用でき、呼び出しごとの引き落としはありません。ただし、呼び出しは 10 秒に 1 回までです。それ以外のすべてのルートでは 403 が返され、チャージもできません。GET /api/keys/balanceでは対象ルートと有効期限を確認できます。30 秒間隔でポーリングする場合、通常のキーでは 1 日 $1.44 かかるのに対し、1 日あたり $0.83 です。 - デイパス:
GET /api/keys/buy-day-passは、決済が確定した時点から 24 時間有効で、料金は一律 $1.00です。/api/liq-feedと/api/liquidationsのみで使用でき、呼び出しごとの引き落としはありません。2 つのルートそれぞれで、キーごとに 10 秒に 1 回呼び出せます(毎分 6 回。10 秒以内の呼び出しはRetry-Afterを伴う 429 となり、請求されません)。デフォルトの x402 クライアントでもそのまま購入できるパスです。実測では@x402/fetch2.28 は署名前に $1 を超える決済を拒否し、ちょうど $1.00 は受け付けるため、$5 と $20 のパック、および $25 のボットパスではspendControlsを引き上げる必要がありますが、このパスでは不要です。それ以外のすべてのルートでは 403 が返され、チャージもできません。GET /api/keys/balanceでは対象ルート、有効期限、残り時間を確認できます。ブラウザーの /keys からも購入できます。 - 残高: ヘッダーを指定して
GET /api/keys/balanceを呼び出します。無料です。 - 利用規約: プリペイド残高は利用クレジットであり、返金不可で、有効期限はありません(ボットパスは定額料金で返金不可、有効期間は 30 日、デイパスも同様に 24 時間有効です)。キーはベアラーシークレットであり、所持している人は誰でも残高を消費できます。不正利用があった場合は失効となります。購入ルートが提供するのは正確な決済手段のみです。これは、半額の一括購入や Gateway ティアを通じてクレジットを購入すると、50% 分が無料になってしまうためです。
- 帳簿上の扱い: 購入は決済済み(ステータス
paid)として記録されます。その購入で賄われる呼び出しはステータスkeyの行となり、すでに計上済みのクレジット消費として扱われ、売上にはなりません。
ウォレットがない場合:Apify Store を利用
5 つの AgentFeed データセットは、Apify Store のアクターとしても提供されています。Store では Apify を通じて法定通貨で請求されるため、ウォレットは不要です。
| アクター | 取得内容 | 価格 |
|---|---|---|
| 暗号資産の清算ヒートマップとマップ:実際の Hyperliquid ポジション | Hyperliquid の最大規模のアカウントが保有するオープンポジションに基づく、価格の 5% 刻みの清算水準 | 1 コインあたり $0.008 |
| 学術論文検索:OpenAlex、Google Scholar の代替 | OpenAlex の CC0 データから、検索語または DOI で論文を取得 | 1 論文あたり $0.003 |
| 米国企業のティッカー別提出書類:10-K、10-Q、8-K、Form 4 | SEC の EDGAR システムから、ティッカーごとに最近の公開提出書類を取得 | 1 件あたり $0.002 |
| PDF から Markdown へ:あらゆる PDF URL から読みやすいテキストを取得 | PDF のテキストをページごとに Markdown として取得 | PDF 1 件あたり $0.01 |
| AI データ抽出ツール:ウェブページまたは PDF を指定したスキーマで JSON に変換 | 指定したフィールドの構造化 JSON をウェブページまたは PDF から取得します。ページに記載されていないフィールドは null になります | 1 ページあたり $0.02 |
価格は結果ごとの料金です。実行ごとに Apify の開始手数料 $0.00005 が加算されます。
NOFX で AgentFeed を利用する
NOFX はオープンソースの AI 取引ターミナルです。get_signal_board と get_coin_signal は、NOFX の External Data Sources 向けに整形されています。data.coins はオープンインタレスト順に並んだコインをキーとするオブジェクトで、data.ranked はリスト、data.sources は各ソース名を示し、30 コイン分のボードは約 10 KB です。まずはこちらをお読みください: NOFX のコミット ef476f2 では、External Data Sources を取得する関数(StrategyEngine.FetchExternalData)が呼び出されないため、標準の NOFX は 2 つのエントリを保存するだけで、プロンプトには読み込みません。この機能は、その関数を呼び出す NOFX ビルドで動作し、同じキーはヘッダーを送信する他のあらゆるツールからも利用できます。docs/nofx.md (中文) には、正確な戦略 JSON、NOFX がすでに claw402 の支払いに使っているウォレットからキーを購入する方法、トレーダーごとのコスト(NOFX のデフォルトの 15 分間隔のスキャンで、ボードは 1 日あたり約 $0.48、コインごとに 1 日あたり $0.19)、およびライブのルートに対して NOFX のフェッチと data_path のたどり方を再現する検証ハーネスが記載されています。
呼び出し料金を支払う
payTo は必ず新しい 402 レスポンスからのみコピーしてください。トランザクション履歴からコピーしないでください。 2026-07-31、Base のトレジャリーに見せかけたアドレス(0x22DB…76e6 と先頭および末尾の文字が同じ)が、最大の購入者に価値ゼロのアドレスポイズニング送金を行いました。そのため、ウォレットの履歴には実際の受取人の横に偽の受取人が表示される場合があります。
x402 — このリポジトリに含まれるクライアント
test-client.mjs は、このリポジトリ独自の Solana x402 支払いクライアントです。標準の solana-keygen 64 バイト JSON キーペアを読み込み、wrapFetchWithPaymentFromConfig の背後で @x402/svm の ExactSvmScheme を使用します。
node test-client.mjs https://x402.ochinimus.app/api/sol-price ./payer-wallet.json
test-client-evm.mjs は viem アカウントを使って Base(eip155:8453)経由で同じ処理を行い、test-mcp-client.mjs は Streamable HTTP 経由で MCP ツール呼び出しの料金を支払います。決済内容は、支払者とトランザクション署名とともに監査テーブルに記録されます。このクライアントをプロジェクト独自の支払者 GBFoGJXvLsgBXAKJw9cGK18BGxaevpYtAyQKoqgcSQKz から最後に実行した際の決済署名は、4ixeZSHSYcBcx5PhRDvPbLwMY2Vgj24FPkjnCaBkewhfcva2kHj32suXv7UE2M4NGsh4q31yGJRqx5nvqbBLNxvD です。
MPP — Foundation の pay CLI
pay --mainnet --mpp --account <account> curl -s https://x402.ochinimus.app/api/btc-price
2026-09-19 の 21:53:39 と 21:57:36(UTC)に、このサービスに対する MPP 決済が 2 件決済されました。両方の署名はリプレイストアに記録されているため、二重に使用されることはありません。
pay CLI の実行には対話型セッションが必要です。 auth_required: true のアカウントは、CI、ヘッドレスエージェント、スケジュールされたタスクでは表示できない Touch ID プロンプトで停止します。また、タイムアウトなしで停止するため、TCP ソケットを一つも保持していないにもかかわらず、ネットワークがハングしたように見えます。これが solana-foundation/pay #469 です。実際の GUI セッションから実行するか、auth_required が設定されていないアカウントを使用してください。
MCP のクイックスタート
任意の MCP クライアントを https://x402.ochinimus.app/mcp(Streamable HTTP、POST)に接続します。有料ツールは決済条件を返し、x402 対応クライアントが決済して再試行します。
createx402MCPClient は公開済みの @x402/mcp(npm tarball、バージョン 2.27.0、2026-09-23 で確認)からエクスポートされています。このリポジトリの test-mcp-client.mjs が実際に行う処理は次のとおりです。
import { createx402MCPClient } from '@x402/mcp';
import { ExactSvmScheme } from '@x402/svm/exact/client';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
const client = createx402MCPClient({
name: 'agentfeed-test',
version: '1.0.0',
schemes: [{ network: 'solana:*', client: new ExactSvmScheme(signer) }],
autoPayment: true,
});
await client.connect(new StreamableHTTPClientTransport(new URL('https://x402.ochinimus.app/mcp')));
const { tools } = await client.listTools();
const result = await client.callTool('get_sol_price', {}); // pays and retries
elizaOS プラグインとしても利用できます。
設定
ソースから確認した、サービスが読み取るすべての変数です(grep -rhoE "process\.env\.[A-Z0-9_]+")。動作するデフォルト値がないのは HELIUS_API_KEY、PAY_TO、および MPP が有効な場合の MPP_SECRET_KEY のみです。
| 変数 | デフォルト | 備考 |
|---|---|---|
PORT | 3006 | |
HELIUS_API_KEY | — | 必須。プライマリの Solana RPC URL を構築します(チェーン状態のみ。DAS は対象外)。Helius のクレジットが切れた場合、または停止した場合、呼び出しは RPC_FALLBACKS(下記)に移行します |
HELIUS_RPC | https://mainnet.helius-rpc.com/?api-key=$HELIUS_API_KEY | |
SOLANA_RPC_URL | HELIUS_API_KEY に基づく Helius | すべての Solana 読み取りに使う標準 RPC のプライマリエンドポイントです。オンチェーンのスポット、ペグテープ、トークンおよびウォレットのルートで使用します(lib/solrpc.js) |
RPC_FALLBACKS | https://api.mainnet-beta.solana.com | HTTPS URL のカンマ区切りリスト(空の場合はなし)。プライマリから HTTP 429、402、403、5xx、接続切断、またはタイムアウトが返された場合、同じ呼び出しを次の URL に送信し、プライマリは10分間使用しません。応答するエンドポイントがない場合は503を返します(課金対象外)。古いデータや不完全な有料応答は返しません。devnet または testnet のプライマリにはフォールバックを適用しません。10分ごとに1行の rpc_usage が出力され、メソッド別、ホスト別に呼び出し回数を記録します(キーは記録せず、ホストのみ) |
JITO_RPC_PRIMARY, JITO_RPC_FALLBACKS | パブリック mainnet RPC、上記のプライマリ | Jito チップ収集処理(bin/jito-tips-collect.js、15分ごと)は、まず無料のパブリック RPC から読み取り、フォールバックとして Helius を使用します |
X402_MODE | on | off にすると、すべてのルートを無料で提供します |
X402_NETWORK | — | X402_MODE が有効な場合は必須です。本番環境では mainnet、テストでは devnet を指定します。指定されていない場合、起動に失敗します |
PAY_TO | — | 必須。USDC を受け取る Solana のトレジャリーです |
PAY_TO_EVM | — | すべての EVM レール用の EVM トレジャリーです。未設定の場合、すべての EVM レールがチャレンジから除外されます |
X402_EVM_NETWORKS | 未設定(すべて) | 元の EVM レール(Base、Polygon、Arbitrum、Arc)を絞り込む CAIP-2 ID のカンマ区切りリストです。たとえば Base のみの場合は eip155:8453 を指定します。R10 ネットワークは X402_EXT_NETWORKS で絞り込みます |
X402_EXT_NETWORKS | 未設定(すべて) | R10 ネットワーク(lib/ext-rails.js)を絞り込む CAIP-2 ID のカンマ区切りリストです。X402_EXT=off にするとすべて削除され、X402_ULTRAVIOLETA=off と X402_PAYAI=off にすると、それぞれのファシリテーターの行が削除されます |
FACILITATOR_URL | — | X402_MODE が有効な場合は必須です。指定されていない場合、起動に失敗します。本番環境では CDP ファシリテーター https://api.cdp.coinbase.com/platform/v2/x402 を使用します |
MPP_ENABLED | 未設定(オフ) | true にすると solana/charge レイヤーをマウントします |
MPP_SECRET_KEY | — | MPP_ENABLED=true の場合は必須。32文字以上である必要があります。mppx はチャレンジ ID を HMAC でバインドし、検証をステートレスにします。初期化時に短すぎるキーは拒否されます |
MPP_NETWORK | mainnet | |
MPP_REALM | x402.ochinimus.app | WWW-Authenticate チャレンジ内の realm |
MPP_RPC_URL | HELIUS_API_KEY に基づく Helius | |
LIQ_DB | /opt/agentfeed/liquidations.db | 清算テープ(読み取り専用) |
PEGWATCH_DB | /opt/pegwatch/pegwatch.db | 切り替え前のトークン化株式ペグテープおよびその参照(読み取り専用) |
PEG_ONCHAIN_DB | ソースと同じ場所の peg-onchain.db | bin/peg-collect.js が書き込むオンチェーンのペグテープ |
JITO_TIPS_FILE | ソースと同じ場所の jito-tips.json | bin/jito-tips-collect.js が書き込むオンチェーンの Jito チップサンプル |
OVERHANG_DB_PATH | /opt/overhang/overhang.db | 担保の退出流動性テープ(読み取り専用) |
CALIPER_DIR | /opt/caliper | 予測モデルディレクトリ |
CALIPER_MODEL | $CALIPER_DIR/model.json | |
CALIPER_RECORD_DB | $CALIPER_DIR/record.db | |
CALIPER_LIQ_DB | /opt/agentfeed/liquidations.db | |
TELEGRAPH_LOG | ソースと同じ場所 | リクエスト形状ログ |
BYBIT_WS BYBIT_API BYBIT_MAX_SYMBOLS | Bybit パブリック(清算テープのみ。R7 以降、ルートは Bybit の市場データを読み取りません) | シンボル上限 1000 |
OKX_WS OKX_API | OKX パブリック(清算テープのみ。R6 以降、ルートは OKX の市場データを読み取りません) | |
BINANCE_WS | Binance パブリック(清算テープのみ。R6 以降、ルートは Binance の市場データを読み取りません) | |
HL_API | https://api.hyperliquid.xyz/info | |
BASE_RPC | https://mainnet.base.org | |
DB_PATH、SIGNATURE、VERIFY_DELAY_MS、HOME、PATH は、MPP のテストハーネス(mpp/test/helpers/)でのみ使用されており、サービスの設定には使用されません。 |
テスト
npm install
cd mpp && npm install && cd .. # separate tree: mppx pins express>=5, this service is express 4
node --test test/tool.test.js # 10 tests — the route wrapper and the `paid` flag
node --test mpp/test/*.js # 40 tests — MPP conformance, offline, every RPC call stubbed
どちらの package.json にも test スクリプトは定義されていません。上記のコマンドは、テストファイル自体に記載されているものです。
test/tool.test.js は、実際のソケット上で一時的な express アプリに lib/tool.js の実際のラッパーをマウントします。これは server.js がマウントするものと同じモジュールであり、コピーではありません。そのため、req.route は本番環境とまったく同じように設定されます。価格付きのルート、パスパラメーター付きのルート(フラグがリクエスト URL ではなく、登録済みの パターン に一致することを証明します)、価格引数付きで登録されているものの価格が設定されていないルート、X402_MODE=off、成功時/エラー時/bad_request 時の監査行のフィールドセット、req.route.path 経由のプロトタイプ汚染をテストします。
MPP のテストのうち 2 つは、1 つのイベントループ内で競合をシミュレーションするのではなく、実際のワーカープロセスをフォークして、プロセス境界をまたいでリプレイストアを競合させます。
無料データセット
複数の取引所の清算データセットは、正規化され、毎日更新され、無料で提供されます。対象期間、既知の欠落、取引所のレート制限、フィールド定義を網羅した品質に関する詳細な説明も付属しています:ochinimuse.gumroad.com/l/liqdata
使用する前に DATASET_QUALITY.md をお読みください。データに誤りがある箇所が正確に記載されています。
リンク
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。