AgentServices

AgentServices

AI エージェント向けの有料 API レイヤー — x402 マイクロペイメントによるデータ、インテリジェンス、推論、メディア

正規のプロジェクト: https://github.com/vbkotecha/agentservices-api 公式サイト: https://agentservices.to ライセンス: Apache-2.0

AgentServices は独立したプロジェクトです。他の x402 マーケットデータプロバイダーとは提携しておらず、その推奨や代替を目的とするものでもありません。

稼働中: agentservices.to | MCP サーバー: https://agentservices.to/mcp（Streamable HTTP）| 検出: /.well-known/x402

これは何ですか？

AgentServices は、AI エージェント向けの収益化された API レイヤーです。API キーもサブスクリプションも不要です。エージェントは x402 payment protocol を使い、Base 上で USDC によるリクエストごとの支払いを行います。

暗号資産データ、市場インテリジェンス、DeFi 分析、オンチェーン分析、400 以上の LLM モデル、画像生成、テキスト読み上げ、ポートフォリオインテリジェンス、紛争解決にわたる60 以上のエンドポイントを提供します。12 個は無料です。48 個以上は x402 経由の有料で、1 回あたり 0.002 ドルから 0.25 ドルです。

v6.0 の新機能

• OpenAI 互換の /v1/chat/completions 経由で400 以上の LLM モデルを利用可能 — GPT、Claude、Gemini、DeepSeek、Grok、Llama など
• スマートルーター — model: "auto" を指定すると、ゲートウェイがタスクを分類し、そのタスクに対応できる最も安価なモデルを選びます
• 画像生成 — gpt-image-2 経由の /v1/images/generations（0.05 ドル）
• テキスト読み上げ — 自然な音声を利用できる /v1/audio/speech（0.05 ドル）
• 新しい MCP ツール 3 個 — chat、generate_image、text_to_speech

購入者向けの流れ：検出 → 試用 → 支払い → 保持

一連の手順については、購入者向けクイックスタートをご利用ください。次に行うことは、認証情報不要の検出チェックを実行することです。

python3 examples/mcp_discovery_buyer_proof.py

次に、同じ購入者向けの流れに従います。

1. 検出: MCP 検出の証明で、ホスト型 MCP サーバーと無料ツールカタログを確認します。
2. 無料で試用: 無料 SDK の証明で、実際の価格結果を取得します。
3. 有料チャレンジを確認: 有料 SDK の証明で、ライブの 402 条件をデコードします。署名や支払いの決済は行いません。
4. 成果を購入: 返された x402 条件に基づいて支払い、同じリクエストを再試行し、返された有料結果を保持します。結果の制限と出所については、token-risk、market-pulse、research-brief の各コントラクトをご覧ください。
5. 証拠を保持: 元のチャレンジ、有料レスポンス、ウォレットの承認またはトランザクション参照を使って、既存のレシートビルダーを実行します。

4 つの証明にはそれぞれ異なる制限があります。検出と無料 SDK の証明は支出なしでアクセスできることを検証します。有料 SDK の証明が検証するのはチャレンジの形式のみです。レシートビルダーは購入者が保持する証拠をハッシュ化しますが、決済の成立は検証しません。いずれも利用、決済の成立、収益について主張するものではありません。

アクティベーション測定の定義については、アクティベーション指標をご覧ください。ライブファネルを調査するには、python3 examples/check_activation_funnel.py を実行してください。

購入者の流れ：発見 → 試用 → 支払い → 継続利用

全体の流れについては、購入者向けクイックスタートをご覧ください。次に行うことは、認証情報なしで検出チェックを実行することです。

python3 examples/mcp_discovery_buyer_proof.py

その後、同じ購入者ジャーニーに沿って進めます。

1. 発見： MCP 検出の証明で、ホスト型 MCP サーバーと無料ツールカタログを確認します。
2. 無料で試用： 無料 SDK の証明で、実際の価格結果を取得します。
3. 有料チャレンジを確認： 有料 SDK の証明で、現在の 402 条件をデコードします。署名も決済も行いません。
4. 成果を購入： 返された x402 条件に従って支払い、同じリクエストを再試行し、返された有料結果を保存します。結果の制限と出所については、token-risk、market-pulse、research-briefの契約をご覧ください。
5. 証拠を保存： 元のチャレンジ、有料レスポンス、およびウォレット認証またはトランザクション参照を使って、既存のレシートビルダーを実行します。

4 つの証明にはそれぞれ異なる制限があります。検出と無料 SDK は、支出なしでアクセスできることを確認します。有料 SDK の証明は、チャレンジの形式のみを確認します。レシートビルダーは購入者が保持する証拠のハッシュを作成しますが、決済の成立は検証しません。いずれも、利用、決済の成立、収益について主張するものではありません。

エンドポイント

無料（支払い不要）

エンドポイント	説明
GET /v1/prices?symbols=BTC,ETH	現在の暗号資産価格（CoinGecko）
GET /v1/trending	市場活動に基づくトレンドトークン
GET /v1/global	世界全体の時価総額、取引高、BTC ドミナンス
GET /v1/fear-greed	暗号資産の恐怖・強欲センチメント指数
GET /v1/gas	Base/Ethereum の現在のガス価格
GET /v1/predictions	AI が生成した市場予測
GET /v1/news	最新の暗号資産ニュース見出し
GET /v1/social/trending	トレンドのソーシャルセンチメントトピック
GET /v1/geo?ip=1.2.3.4	IP ジオロケーション検索
GET /v1/swap/quote?from=&to=&amount=	DEX スワップ見積もり（0x 連携）
GET /v1/policies	紛争解決ポリシーテンプレートの一覧
GET /v1/trade/hyperliquid/bootstrap	Hyperliquid エージェント署名のブートストラップ（approveAgent フロー）
POST /v1/trade/hyperliquid/order	エージェント署名済み HL 注文の転送（ポリシーによる制御）
POST /v1/trade/hyperliquid/cancel	エージェント署名済み HL キャンセルの転送
GET /v1/trade/hyperliquid/order	HL 注文ステータス（クエリ：user、oid）
GET /v1/trade/hyperliquid/order/{id}	HL 注文ステータス（パスパラメーター）
GET/PUT /v1/trade/hyperliquid/policy	実行制限（最大想定元本、コイン許可リスト、キルスイッチ）
POST /v1/trade/hyperliquid/paper/order	エージェントのトレーニング用ペーパー／シミュレーション注文
POST /v1/trade/hyperliquid/eval/order	ポリシーの合否評価（トレーニング用ジム）
GET /health	API ヘルスチェック

取引 API — 取引所への入り口（無料 — x402 対象外）

AgentServices は /v1/trade/{venue}/… で取引所の取引窓口を構築しています。最初に Hyperliquid を提供し、今後、さらに多くの取引所と取引所に依存しない /v1/trade/execute ルーターを追加します。

各窓口はポリシーによる制御と転送を行うものであり、より賢いルーターではありません。取引所に直接発注するより約定が有利になるとは主張しません。発注時の実行は無料です（注文処理経路に x402 はありません）。ビルダーフィーは省略しているため、当社経由でルーティングしても、直接発注するより費用が高くなることはありません。

取引所の API キーを収集することはありません。 エージェントは HL 承認済みのエージェントウォレットを使って、ローカルで注文に署名します（メインウォレットでの approveAgent が、人間による初回設定手順です）。AgentServices はポリシーを確認し（最大想定元本、コインの許可リスト、キルスイッチ）、署名済みのペイロードを転送します。

リクエストボディでは market_type に spot、perp、future を指定できます。現在、Hyperliquid が対応しているのは perp と spot です。未対応のタイプを指定すると、機械判読可能な market_type_not_supported エラーが返されます。

MCP ツール	HTTP 相当
trade_hyperliquid_order	POST /v1/trade/hyperliquid/order
trade_hyperliquid_cancel	POST /v1/trade/hyperliquid/cancel
trade_hyperliquid_order_status	GET /v1/trade/hyperliquid/order
trade_hyperliquid_get_policy / trade_hyperliquid_set_policy	GET/PUT /v1/trade/hyperliquid/policy
trade_hyperliquid_paper_order	POST /v1/trade/hyperliquid/paper/order
trade_hyperliquid_eval_order	POST /v1/trade/hyperliquid/eval/order

従来の hl_* MCP ツール名もエイリアスとして引き続き使用できます。approveAgent の署名方式については、GET /v1/trade/hyperliquid/bootstrap を参照してください。

ロードマップ： 追加の取引所向けに /v1/trade/{venue}、今後、取引所に依存しないルーティング向けに /v1/trade/execute を提供します。

有料 — データ API（x402）

エンドポイント	価格	説明
GET /v1/indicators/BTC	$0.02	テクニカル指標（RSI、MACD、ボリンジャーバンド、ATR、サポート／レジスタンス）
GET /v1/yields	$0.02	TVL 上位の DeFi イールドプール
GET /v1/metadata?url=	$0.01	URL メタデータの抽出と展開
GET /v1/search?q=	$0.01	暗号資産／市場情報のウェブ検索
GET /v1/onchain/:address	$0.02	任意のアドレスのオンチェーン分析
GET /v1/onchain/:address/tokens	$0.03	任意のアドレスのトークン保有状況

有料 — 分析 API（x402）

エンドポイント	価格	説明
GET /v1/token-risk/{token}	$0.03	スナップショットに基づくボラティリティ、流動性の代理指標、時価総額のリスクスコア
GET /v1/crypto-signals	$0.04	複数の指標を集約した売買シグナル
GET /v1/yield-comparison	$0.03	リスク調整後リターンによるプロトコル間の利回り比較
GET /v1/hn-sentiment	$0.02	技術トピックに関する Hacker News のセンチメント分析
GET /v1/npm-stats/:package	$0.02	NPM パッケージのダウンロード統計とトレンド
GET /v1/github-trending	$0.02	言語／トピック別の GitHub トレンドリポジトリ
GET /v1/marketing-intel	$0.05	競合他社、コンテンツの不足領域、広告コピーに関するマーケティングインテリジェンス

有料 — 統合インテリジェンス（x402）

エンドポイント	価格	説明
GET /v1/research?q=	$0.05	詳細調査：検索、抽出、統合を 1 回の呼び出しで実行
GET /v1/portfolio?symbol=BTC	$0.10	ポートフォリオインテリジェンス：価格、シグナル、リスク、センチメント、評価
GET /v1/defi-strategy	$0.25	DeFi 戦略レポート：上位の利回り、TVL、比較、リスクフラグ
GET /v1/market-pulse	$0.05	市場の動向：恐怖・強欲指数、トレンド、ニュース、ソーシャル、クジラ、グローバル情報
GET /v1/onchain-overview	$0.15	オンチェーン概要：クジラ、取引所フロー、ステーブルコインのフロー、相関、DeFi TVL

有料 — AI 推論（x402）

エンドポイント	価格	説明
POST /v1/inference	$0.03	LLM 推論（gpt-5.4/5.4-mini/5.5）— チャット補完
POST /v1/complete	$0.03	テキスト補完（CodexSale プロキシ）

有料 — 紛争解決（x402）

エンドポイント	価格	説明
POST /v1/disputes	$0.05	AI を活用した紛争解決（7 種類のポリシーテンプレート）

---

ユースケース — エージェントで構築できるもの

ポートフォリオモニター

# ALL-IN-ONE: Get portfolio intelligence in a single call ($0.10)
# Returns: price + technical signal + risk score + market sentiment + verdict
curl "https://agentservices.to/v1/portfolio?symbol=BTC"

# Or build it yourself from individual endpoints:
# Get current prices (FREE)
curl https://agentservices.to/v1/prices?symbols=BTC,ETH,SOL

# Get technical signals for entry/exit ($0.04)
curl https://agentservices.to/v1/crypto-signals

# Check snapshot-based token risk before buying ($0.03)
# Use a CoinGecko-compatible identifier for portable direct HTTP calls.
curl https://api.agentservices.to/v1/token-risk/pepe
# Contract and payment-receipt guidance: docs/token-risk-outcome-contract.md

DeFi 利回りオプティマイザー

# ALL-IN-ONE: Get DeFi strategy report ($0.25)
# Returns: top yields + protocol TVL + cross-chain comparison + risk flags
curl "https://agentservices.to/v1/defi-strategy"

# Get all yield pools ranked by TVL ($0.02)
curl https://agentservices.to/v1/yields

# Compare yields with risk-adjusted returns ($0.03)
curl https://agentservices.to/v1/yield-comparison

# Check on-chain position for any wallet ($0.02)
curl https://agentservices.to/v1/onchain/0x9863aB6242663FCc84c33632741711dB78f8Fd15

マーケットインテリジェンスエージェント

# ALL-IN-ONE: Get market pulse report ($0.05)
# Returns: fear-greed + trending + news + social + whales + global market
curl "https://agentservices.to/v1/market-pulse"

# Get market sentiment (FREE)
curl https://agentservices.to/v1/fear-greed

# Search for latest news on any topic ($0.01)
curl "https://agentservices.to/v1/search?q=base+chain+ecosystem"

# Get trending tokens (FREE)
curl https://agentservices.to/v1/trending

# Get marketing intelligence report ($0.05)
curl "https://agentservices.to/v1/marketing-intel?competitor=blockrun&topic=x402"

テクニカル分析ボット

# Full technical indicator suite ($0.02)
curl https://agentservices.to/v1/indicators/BTC
# Returns: RSI, MACD, Bollinger Bands, ATR, Support/Resistance levels

# AI-generated market predictions (FREE)
curl https://agentservices.to/v1/predictions

# Combine with on-chain analytics ($0.03)
curl https://agentservices.to/v1/onchain/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/tokens

開発者向けリサーチエージェント

# GitHub trending repos ($0.02)
curl "https://agentservices.to/v1/github-trending?language=python&since=weekly"

# NPM package stats ($0.02)
curl https://agentservices.to/v1/npm-stats/react

# Hacker News sentiment ($0.02)
curl "https://agentservices.to/v1/hn-sentiment?q=AI+agents"

AI チャット／推論

# Chat completions via x402 ($0.03)
curl -X POST https://agentservices.to/v1/inference \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.4-mini","messages":[{"role":"user","content":"Explain x402 in 3 sentences"}]}'

オンチェーン分析

# ALL-IN-ONE: Get full on-chain overview ($0.15)
# Returns: whale movements + exchange flows + stablecoin flows + correlation matrix + DeFi TVL
curl "https://agentservices.to/v1/onchain-overview"

# On-chain analytics for any wallet ($0.02)
curl https://agentservices.to/v1/onchain/0x9863aB6242663FCc84c33632741711dB78f8Fd15

# Token holdings for any wallet ($0.03)
curl https://agentservices.to/v1/onchain/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/tokens

---

クイックスタート

curl を使用する

# Free — no payment needed
curl https://agentservices.to/v1/prices?symbols=BTC,ETH

# Paid — returns HTTP 402 with payment instructions in the header
curl -i https://agentservices.to/v1/indicators/BTC
# Response includes x402 payment envelope: network, amount, payTo address
# Agent pays via x402 client, retries with X-Payment header, gets data

MCP サーバーとして使用する（Claude Desktop、Cursor など）

{
  "mcpServers": {
    "agentservices": {
      "url": "https://agentservices.to/mcp",
      "transport": "streamable-http"
    }
  }
}

13 種類以上の MCP ツールを利用できます：crypto_prices、trending_tokens、global_market、gas_prices、market_predictions、crypto_news、social_trending、technical_indicators、defi_yields、search_web、token_risk、crypto_signals、onchain_analytics、deep_research、portfolio_intelligence、defi_strategy、market_pulse、onchain_overview

Python で使用する

import httpx

# Free endpoints
resp = httpx.get("https://agentservices.to/v1/prices?symbols=BTC,ETH")
prices = resp.json()

# Paid endpoints — use x402 client to handle payment
from x402.client import x402Client
client = x402Client()
result = client.get("https://agentservices.to/v1/indicators/BTC")
# Client handles 402 → pays USDC → retries with payment proof → returns data

JavaScript／TypeScript で使用する

// Free endpoints
const prices = await fetch("https://agentservices.to/v1/prices?symbols=BTC,ETH").then(r => r.json());

// Paid endpoints — use @x402/facilitator
import { wrapFetchWithPayment } from "@x402/facilitator";
const paidFetch = wrapFetchWithPayment(fetch);
const indicators = await paidFetch("https://agentservices.to/v1/indicators/BTC").then(r => r.json());

紛争解決エンジン

AgentServices には、7 種類のポリシーテンプレートを備えた AI 活用型の紛争解決システムが含まれています：

ポリシー	ユースケース
freelance-delivery	フリーランサーとクライアント間の納品に関する紛争
milestone-payment	マイルストーンベースのプロジェクト支払いに関する紛争
sla-monitoring	サービスレベル契約の違反
api-quality	API の応答品質／稼働時間に関する紛争
bug-bounty	バグバウンティの有効性に関する紛争
scope-dispute	プロジェクトのスコープ拡大に関する紛争
physical-commerce	物理商品の取引に関する紛争

人間向けの課金手段（ChatGPT／Claude）

ウォレットエージェントは引き続き REST 上で x402 を通じて支払います。変更はありません。ChatGPT Developer Mode または Claude のカスタムコネクターから接続する人間は、MCP 上で Google OAuth + Stripe のプリペイドクレジットを利用できます。

決済手段	対象	方法
x402	ウォレットエージェント	認証なしの REST → HTTP 402 → Base 上の USDC
クレジット	ログイン済みの人間	MCP 上の Google OAuth → プリペイド残高から同じ USD 価格分を差し引き

ChatGPT 用 MCP URL： https://agentservices.to/mcp

環境変数

.env.example をコピーしてください。人間向けの接続手段を有効にするには、次の環境変数が必要です：

変数	用途
GOOGLE_CLIENT_ID	Google OAuth クライアント ID
GOOGLE_CLIENT_SECRET	Google OAuth クライアントシークレット
OAUTH_JWT_SECRET	MCP ベアラートークンの署名（または SESSION_SECRET を使用）
STRIPE_SECRET_KEY	Stripe API シークレットキー
STRIPE_WEBHOOK_SECRET	checkout.session.completed ウェブフックの検証
STRIPE_PRICE_CREDITS_10	$10 パック用の Stripe Price ID（省略時はハードコードされた値を使用）
PUBLIC_BASE_URL	正規ホスト。例：https://agentservices.to

プリペイドクレジット残高は Stripe Customer Balance に保存されます（Google の sub ごとに Stripe Customer を 1 つ作成）。Redis、Postgres、その他のデータベースは不要です。

Google／Stripe の変数が設定されていない場合、API は x402 のみのモードで起動します。

Google Cloud Console のリダイレクト URI

次の両方のホストを追加してください：

• https://agentservices.to/oauth/google/callback
• https://api.agentservices.to/oauth/google/callback

Stripe ウェブフック

Stripe の送信先を次のように設定してください：

• https://agentservices.to/billing/webhook
• https://api.agentservices.to/billing/webhook

イベント：checkout.session.completed

検出と掲載

• x402 Discovery — 稼働中
• MCP Registry — to.agentservices/agentservices として掲載
• CDP Bazaar — 拡張機能を有効化済み
• awesome-x402 — PR を提出済み

技術スタック

• FastAPI（Python 3.11+）
• x402 v2 決済ミドルウェア（Coinbase CDP facilitator）
• Base Mainnet 上の USDC（EIP-3009 によるガス代不要の送金）
• Vercel にデプロイ（agentservices.to + api.agentservices.to、main から自動デプロイ）

Coinbase AgentKit の統合

AgentServices には、組み込みの Coinbase AgentKit アクションプロバイダー（agentkit/ ディレクトリ）が含まれています。これにより、あらゆる AgentKit エージェントが、型定義とドキュメント付きのアクションを使って AgentServices API を利用できます。

from coinbase_agentkit import AgentKit, AgentKitConfig
from agentkit import agentservices_action_provider

agent_kit = AgentKit(AgentKitConfig(
    wallet_provider=wallet_provider,
    action_providers=[agentservices_action_provider()]
))

無料エンドポイント（価格、恐怖・強欲指数、トレンド、ガス）と有料エンドポイント（インジケーター、DeFi 利回り、ポートフォリオインテリジェンス、リサーチ、オンチェーン分析、AI 推論など）を網羅する18 個のアクションがあります。詳しくは agentkit/README.md をご覧ください。

ライセンス

MIT — 自由に構築、フォーク、統合できます。

リンク

• API： agentservices.to
• MCP： agentservices.to/mcp
• ディスカバリー： agentservices.to/.well-known/x402
• GitHub： github.com/vbkotecha/agentservices-api
• x402 Protocol： x402.org
• Base： base.org