AgentPay — trust routing + spend caps for x402 agents

io.github.romudille-bit由 GitHub 帳號 romudille-bit 發布v2.8.0更新於 Nov 3, 2026

面向x402代理的買方信任預言機與限額工作階段：verified_route、收據、17個免費工具。

AI 翻譯由 AI 模型根據下方的原文描述翻譯，可能有誤。

原文描述

Buyer-side trust oracle + capped sessions for x402 agents: verified_route, receipts, 17 free tools.

發布方自己的服務：AgentPay — Pay-per-call AI Microservices

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取金融AI 與機器學習

概覽

AgentPay — trust routing + spend caps for x402 agents 的託管 MCP 服務（agentpay.tools）；無需登入；Streamable HTTP；23 個工具。

暫無 AI 概覽：以下資訊來自註冊中心條目和服務本身。

端點
agentpay.tools
最近檢查

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 AgentPay — trust routing + spend caps for x402 agents，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.romudille-bit%2Fagentpay/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "agentpay-trust-routing-spend-caps-for-x4": {
      "type": "http",
      "url": "https://agentpay.tools/mcp"
    }
  }
}

README

AgentPay

[Tests] [PyPI] [Python] [License: MIT] [MCP] [Live gateway] [x402-list] [Audited by AddonAudit]

Most agent-payment tools are a wallet — they move money. AgentPay is the layer that decides whether to spend it at all.

AgentPay is the economic intelligence layer for MCP servers and AI agents.

Agents spend money. Most don't know how much, or why, until the session ends and the bill arrives.

AgentPay gives agents economic intelligence — the ability to reason about cost while they work, not after.

It starts with a budget. Every session opens with a hard cap enforced at the payment layer — not in code a model can ignore, but at the point where money moves. The agent knows from the first call exactly what it has to spend.

Before calling a tool, it knows what that call costs. Mid-task, it can check what's left and route to a cheaper alternative if the math doesn't work. When the session ends, a receipt captures every call, every cost, every decision — not a debug log, but proof of economic accountability.

The developer sees all of it: spending patterns per agent, anomaly flags when something loops or spikes, policy controls that enforce exactly which tools an agent can use and how much it can spend on each.

The result is an agent that doesn't just have a budget. It knows how to use one.

Start free: 20 tools (17 free), no USDC needed, no wallet setup required.
Live gateway: https://agentpay.tools
Settles in: USDC on Base and Stellar, sBTC on Stacks mainnet (walkthrough)

Install

bash
pip install agentpay-x402            # core (Stellar + Stacks/sBTC)pip install "agentpay-x402[base]"    # + pay tools that settle on Basepip install "agentpay-x402[stacks]"  # same as core, spelled out — pay in sBTC on Stacks

Quickstart — 3 lines, zero setup

17 free tools. No USDC, no wallet, no API keys, no human. quickstart() registers an agent, mints a wallet, and returns a ready, budget-capped session.

python
from agentpay import quickstart
s = quickstart()                                   # registers + mints a walletprint(s.call("token_price", {"symbol": "ETH"})["result"]["price_usd"])print(s.spending_summary())                        # receipt: every call, cost, tx

Set a hard budget, or bring your own funded wallet to pay for tools:

python
s = quickstart(max_spend="0.50")                   # cap this run at $0.50s = quickstart(secret_key="S...", base_key="0x...")  # your wallet (Stellar + Base)

Every call is session-tracked, and the cap is enforced before any payment is signed.

20 Tools (17 Free + 3 Paid)

Every call is session-tracked — you get a receipt showing every tool called, every cost, and every timestamp.

ToolParametersReturns
url_readerurlClean markdown content of any web page
web_searchqueryTop 5 results with full content
market_snapshot—S&P 500, Treasury yield, BTC, ETH, gas in one call
token_pricesymbol (BTC, ETH, SOL…)price_usd, change_24h_pct, market_cap_usd
gas_tracker—slow/standard/fast gwei, base_fee_gwei
fear_greed_indexlimit (days of history, default 1)value 0–100, value_classification, history[]
token_market_datatoken_a, token_bvolume_24h_usd, market_cap_usd, price_usd
wallet_balanceaddress, chain (ethereum/stellar)token balances
whale_activitytoken, min_usd (default 100k)large_transfers[] (full from/to + tx_hash), total_volume_usd
defi_tvlprotocol (optional, e.g. "uniswap")tvl, change_1d, change_7d, chains[]
token_securitycontract_address, chainrisk_level, is_honeypot, buy_tax, sell_tax
open_interestsymbol (BTC, ETH…)total_oi_usd, oi_change_1h/24h_pct, long_short_ratio
orderbook_depthsymbol (e.g. ETHUSDT)best_bid/ask, spread_pct, slippage at $10k/$50k/$250k
funding_ratesasset (optional)funding_rate_pct, annualized_rate_pct, sentiment per exchange
crypto_newscurrencies (e.g. "ETH,BTC"), filterheadlines[] with title, url, sentiment, score
yield_scannertoken, chain (optional), min_tvltop 10 pools by APY with protocol, tvl_usd, risk_level
dune_queryquery_id, limit, fast_onlyrows[], columns[], row_count from Dune Analytics
session_createagent_address, max_spend, labelsession_id, budget config, gateway_url, receipt — $0.01
pre_trade_checksymbol, size_usd, side, venue?, token_address?one-call trade verdict (ok/caution/avoid): slippage at YOUR size, side-aware funding carry, OI crowding, optional security; Stacks tokens add the Bitflow venue (price impact at size, route, pool TVL) — $0.01
verified_routeneed, budget_usd?, chain?buyer-side trust oracle: sweeps the x402 marketplace, collapses sybil/factory clusters, ranks real providers by usage × delivery scores → one vetted recommendation + ready_to_pay challenge — $0.01

Session Intelligence

This is the economic intelligence layer in practice. The Session gives your agent — and you — real visibility into what happened, what it cost, and why.

python
from agentpay import quickstart, BudgetExceeded
# quickstart() registers + mints a wallet; the returned session is also a# context manager, so you can `with` it for a printed receipt on exit.# Budget caps are exact: max_spend=0.10 (float) == "0.10" (str).with quickstart(max_spend=0.10) as session:
    # Price an entire multi-tool plan BEFORE spending anything (free, no wallet)    plan = session.estimate_plan(["token_price", "pre_trade_check", "session_create"])    plan["total_usdc"], plan["fits_budget"]   # per-step costs + cheaper alternatives inside
    # Reason about cost before committing (use the *_usd Decimals for comparisons)    if session.would_exceed(session.tool_cost_usd("dune_query")):        alt = session.suggest_cheaper("dune_query")   # {"name": ..., "price": ...}
    # Call a tool — budget enforced before any payment is signed    r = session.call("token_price", {"symbol": "ETH"})    r.data["price_usd"]    # inner tool output  (r["result"]["price_usd"] still works)    r.cost                 # payment amount, e.g. "0"    r.network              # settlement chain, e.g. "stellar-mainnet" / "base"
    session.remaining_usd()   # Decimal('0.10')
    # For an external x402 tool that offers several chains, pick one:    # session.call("https://some-x402-tool/endpoint", {}, chain="base")
    # Full receipt — every call, cost, tx hash, and settlement chain    print(session.spending_summary())    # {    #   "calls": 1, "spent": "$0", "remaining": "$0.1", "budget": "$0.1",    #   "breakdown": [    #     {"tool": "token_price", "cost": "Free", "tx_hash": "", "network": "stellar-mainnet"}    #   ]    # }

Policy parameters

Control exactly what your agent is allowed to do:

python
from agentpay import AgentWallet, Session
wallet = AgentWallet(secret_key="S...", network="mainnet")   # or quickstart()'s minted walletwith Session(wallet,             gateway_url="https://agentpay.tools",             max_spend=0.10,             allowed_tools=["token_price", "gas_tracker", "web_search"],             max_per_tool={"dune_query": 0.02},             rate_limit=10,                # max 10 calls/min             prefer_chain="base",          # Base is the default; "stellar" or "stacks" to override             allowed_recipients=["0x…", "SP…"],   # only these payees may be paid (any rail)             max_per_call="0.02",          # no single payment above this             approve_above="0.01",         # payments above this need the approver's yes             approver=lambda req: ask_human(req)) as session:    ...

BudgetExceeded fires before any payment goes out if a tool would push you over the cap, isn't on the allowlist, or exceeds its per-tool limit. The recipient allowlist, per-call maximum and approval gate are checked against the 402 itself — the payee and amount that would actually be signed — on every rail, and raise PolicyRejected / ApprovalRequired (both BudgetExceeded subclasses) with nothing signed. Every refusal is listed under spending_summary()["anomalies"], alongside flags for repeated identical paid calls, a single call taking half the cap, and unconfirmed legs. budget_policy() picks the cap itself from an explicit value, an env var, a rule (share of balance) or a prompt, clamped to what the wallet holds — wallet.get_sbtc_balance_usd(rate) gives that ceiling for an sBTC payer.

Example: Market intelligence agent

Five free tools, one session, full receipt.

python
from agentpay import quickstart
with quickstart() as session:
    snapshot = session.call("market_snapshot", {})    rates    = session.call("funding_rates",    {"asset": "ETH"})    oi       = session.call("open_interest",    {"symbol": "ETH"})    fg       = session.call("fear_greed_index", {})    whales   = session.call("whale_activity",   {"token": "ETH", "min_usd": 500_000})
    m = snapshot["result"]    print(f"S&P:       {m['sp500_price']:,.0f}  ({m['sp500_change_pct']:+.2f}%)")    print(f"ETH:       ${m['eth_price_usd']:,.0f}")    print(f"Gas:       {m['gas_standard_gwei']} gwei")
    avg_rate = sum(e["funding_rate_pct"] for e in rates["result"]["rates"]) / len(rates["result"]["rates"])    print(f"Funding:   {avg_rate:+.4f}%/8h")    print(f"OI 24h:    {oi['result']['oi_change_24h_pct']:+.2f}%")    print(f"Sentiment: {fg['result']['value_classification']}")    print(f"Whale vol: ${whales['result']['total_volume_usd']:,.0f}")
    print(session.spending_summary())

Use it in your agent

Agent Skills (one command, any agent)

bash
npx skills add romudille-bit/agentpay

Installs the agentpay-route skill (find, judge, and pay for the best paid x402 tool within a budget) and agentpay-session (hard spend cap + verifiable receipts) into Claude Code, Codex, Droid, OpenCode, or any skills-CLI-compatible runtime. Pair with the MCP below for keyless routing out of the box; add AGENTPAY_BASE_KEY + AGENTPAY_MAX_SPEND for capped, in-place paid calls.

Claude Code plugin (one command)

/plugin marketplace add romudille-bit/agentpay/plugin install agentpay@agentpay

Installs the agentpay-route skill — your agent finds, judges, and pays for the best paid x402 tool within a budget — plus the 17 free tools. No keys needed to route.

MCP server (any runtime)

Self-contained — pure Node, no Python, no repo, no keys to start:

bash
npx -y @romudille/agentpay-mcp
json
{  "mcpServers": {    "agentpay": {      "command": "npx",      "args": ["-y", "@romudille/agentpay-mcp"]    }  }}

Exposes the 17 free tools plus verified_route (buyer-side trust oracle — free preview keyless, full paid payload in wallet mode), route (legacy alias) and estimate_plan (price a multi-tool plan before spending). Listed on Glama.

Wallet mode (v2.4.0): add an EVM key and paid tools settle in-place — gasless EIP-3009 on Base (no ETH needed; nothing broadcast client-side, a rejected call moves no USDC) under a hard session cap:

json
{  "mcpServers": {    "agentpay": {      "command": "npx",      "args": ["-y", "@romudille/agentpay-mcp"],      "env": {        "AGENTPAY_BASE_KEY": "0x<EVM private key>",        "AGENTPAY_MAX_SPEND": "0.10"      }    }  }}

Fund the key's address with USDC on Base mainnet; every paid call counts against AGENTPAY_MAX_SPEND and is refused past the cap — the budget story, enforced inside the MCP itself. Use a dedicated small-balance key.

Buyer-side routing — find & pay for the best tool, within a budget

When an agent needs a paid tool, AgentPay discovers the options across the x402 marketplace, drops the fake/empty stubs, ranks by real usage (not price), and recommends the cheapest one that actually works — within a budget. The agent pays the provider directly (peer-to-peer, no custody) and keeps a verifiable receipt.

bash
agentpay-route "funding rates" --budget 0.01   # ranked candidates + a recommendation

Paid tools: session_create, pre_trade_check, verified_route ($0.01 each)

Three tools cost money today. session_create opens a budget-capped session with a hard max_spend limit — for autonomous agents that need spend enforcement across multiple calls. pre_trade_check is the first outcome bundle: one call returns an ok/caution/avoid trade verdict from live orderbook slippage at your size, side-aware funding carry, open-interest crowding, and an optional contract security scan — with the per-factor breakdown and raw components embedded. For Stacks tokens it prices the swap on Bitflow instead of a CEX book: price impact at your size from a live route quote, the pools it crosses and their TVL (see docs/bitflow-venue.md). verified_route is the buyer-side trust oracle: "I need X, budget $Y — which x402 tool is real?" It sweeps the whole marketplace, collapses sybil/factory clusters, keeps only providers relevant to your need, ranks them by real unique-payer usage × the Prober's paid delivery scores, and returns one vetted recommendation with a ready-to-pay challenge. All 17 data tools remain free.

Price any plan before spending a cent (free, no wallet): POST /v1/plan/estimate, or session.estimate_plan([...]) from the SDK.

When metered inference ships, it works through the same Session interface — your agent checks cost, decides if it's worth it, and pays in USDC on Base or Stellar, or sBTC on Stacks (via the SDK).

python
# Future — inference as a Session toolremaining = session.remaining()infer_cost = session.tool_cost("inference")   # e.g. "$0.02"
if remaining >= infer_cost:    result = session.call("inference", {"prompt": "...", "model": "claude-haiku"})else:    result = session.call("url_reader", {"url": summary_url})  # cheaper path

To fund a wallet for session_create: send USDC to a Stellar wallet (S... key, issuer GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN) or a Base wallet (0x..., contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913).

Eating our own dog food

AgentPay's flagship analyst agent (agents/analyst/) runs daily on these exact rails as a real customer: it prices its plan with estimate_plan, gathers free intel, buys pre_trade_check verdicts on the majors under a hard $0.25 cap, and publishes a market note with an on-chain-verifiable receipt. The first best customer is the house.

Architecture

AgentPay is an x402 payment gateway and economic intelligence layer — agents call tools within a hard budget cap, pay USDC on-chain when tools cost money, and accumulate a full session receipt as they work. Free tools skip the payment step entirely; the session tracking and cost awareness are always on.

Chain support & x402 interop

Base settles via the standard x402 exact scheme (gasless EIP-3009 through the CDP facilitator) — any standard x402 client can pay AgentPay on Base, no AgentPay SDK required.

Stellar settles via the standard x402 exact scheme too: Soroban USDC, auth entries signed by the payer, verified and submitted by the Built on Stellar (OpenZeppelin) facilitator with the network fee sponsored — any standard @x402/stellar client can pay AgentPay on Stellar (see docs/stellar-standard-scheme.md). The AgentPay SDK (pip install agentpay-x402) and manual payers can also use the classic payment + text memo path, verified directly on Horizon. Circle CCTP bridges USDC 1:1 between Stellar and Base.

agent (Python SDK)    │    │  POST /tools/{name}/call    │  ← 200 {result: ...}              ← free tools return directly    │  ← 402 {payment_id, amount, ...}  ← paid tools (session_create, pre_trade_check, verified_route)    │  → USDC on Base (~2s, standard x402) or Stellar (~3–5s, SDK classic+memo)    │  → retry with X-Payment header    │  ← 200 {result: ...}    ▼gateway (FastAPI on Railway)    │    ├── registry/registry.py   — 20-tool catalog (17 free; session_create, pre_trade_check, verified_route — $0.01 each)    ├── gateway/routes/plan.py — POST /v1/plan/estimate (free pre-flight plan pricing)    ├── gateway/radar.py       — Arbitrum x402 Radar discovery + settlement verify (see RADAR.md)    ├── gateway/stellar.py     — Stellar payment verification via Horizon    ├── gateway/base.py        — Base payment verification via JSON-RPC    └── gateway/services/tools_runtime.py — real API dispatchers            ├── Jina Reader       url_reader            ├── Jina Search       web_search            ├── Yahoo+CoinGecko   market_snapshot            ├── CoinGecko         token_price, token_market_data            ├── Etherscan V2      gas_tracker, whale_activity, wallet_balance            ├── DeFiLlama         defi_tvl, yield_scanner            ├── alternative.me    fear_greed_index            ├── Reddit            crypto_news            ├── Dune Analytics    dune_query            ├── GoPlus            token_security            └── Binance+Bybit+OKX funding_rates, open_interest, orderbook_depth

Stacks sBTC settlement

AgentPay settles x402 micropayments in sBTC on Stacks mainnet — budget-capped, signed client-side and never broadcast by the client (the gateway broadcasts the signed transaction, so a hostile gateway can settle at most the signed amount). Live on agentpay.tools since agentpay-x402 0.5.0:

python
from agentpay import quickstart
s = quickstart(stacks_key="<64-hex>", prefer_chain="stacks", max_spend="0.05")r = s.call("pre_trade_check", {"symbol": "BTC", "size_usd": 25000, "side": "long"})print(r.data["verdict"], r.tx)      # verdict + the sbtc-token::transfer txid
  • Fees: when the gateway's 402 offers sponsorship (the public gateway does once its relay is configured), the SDK signs a sponsored, fee-0 transaction and the relay pays the STX fee — the wallet needs only sBTC. Otherwise it pays its own fee; STACKS_SPONSORED=0 opts out, 1 requires it.
  • Walkthrough (start here): docs/stacks-walkthrough.md — install → one capped mainnet payment → the receipt verified three ways → the rules refusing before signing, with real output.
  • Mainnet reference: docs/stacks-mainnet.md — config, the one-liner, redeeming an uncertain settle, ledger verification, the pilot agent.
  • Runnable demo: examples/stacks_m1_demo.py — capped session → sBTC payment → receipt → over-cap rejection. STACKS_NETWORK=mainnet runs it on mainnet; the name is from the milestone it was written for.
  • Three-beat demo: examples/stacks_bff_demo.py — free call, a cap refusing a paid call before signing, one real $0.01 sBTC payment with the Bitflow venue, receipt (the BFF ARMY bootcamp script, Spanish comments).
  • Spending rules demo: examples/stacks_policy_demo.py — recipient allowlist, per-call maximum and approval gate refusing sBTC payments before anything is signed, then one approved settlement; refusals on the receipt.
  • Demo video: YouTube (~40s)
  • Mainnet receipts: 0x30689b5e…, 0xd1de1a79…, 0x59ce7014… — sbtc-token::transfer payer → gateway, each from a $0.05-capped session, chain-verified on agentpay.tools/ledger.
  • Milestone-1 (testnet) material, kept as delivered: docs/stacks-m1.md and the testnet proof 0xa5351bad… (PoX-5 testnet, block 82215). The testnet gateway is still up for anyone who wants to try the rail without mainnet sBTC.

Discovery

DirectoryStatus
PyPI✅ agentpay-x402
x402scout✅ indexed, health-checked every 15min
Glama MCP✅ listed
xpaysh/awesome-x402✅ listed (list dormant since Nov 2025)
Merit-Systems/awesome-agentic-commerce⏳ PR #712 open since 2026-09-16
npm✅ @romudille/agentpay-mcp
skills CLI✅ npx skills add romudille-bit/agentpay
402index.io✅ domain verified, 17 tools synced
x402-list.com✅ listed 2026-09-07 — 3 paid endpoints, 14/14 x402 compliance, measured (never self-attested) score
Coinbase Bazaar✅ indexed via REST — session_create, pre_trade_check, verified_route (Base). ⚠️ NOT in the curated set: invisible on the MCP search_resources default
Claude Code plugin✅ /plugin marketplace add romudille-bit/agentpay
MCP Registry✅ io.github.romudille-bit/agentpay v2.4.3 (official)
402audit✅ audited — score 100, verdict "proprietary"
signal402✅ auto-indexed from Bazaar (6h refresh)
x402.fuchss.app✅ listed — grade recovering since the 402-body fix
xpay.toolsdropped — redundant with Bazaar (SPA mirror)

Agent-readable endpoints:

EndpointPurpose
/.well-known/agentpay.jsonAgentPay manifest
/.well-known/agent.jsonA2A agent card
/llms.txtLLM-readable service description
/.well-known/l402-services402index.io discovery format

來源：README.md，提交 ac004f8

工具

23

session_create

Session Create

Open a budget-capped agent session on AgentPay. Pay $0.01 USDC once — get a session_id, budget config, and gateway URL. Enforces a hard max_spend cap across all subsequent tool calls via the AgentPay SDK. The entry point for agents discovering AgentPay on Base Bazaar. Use when: You want to start an AgentPay session with a hard spend cap and get a session_id for tracking. Not for: you only need a session for free tools — the SDK's quickstart() opens one at no cost; this call settles $0.01 on-chain. Returns: session_id, max_spend, agent_address, gateway_url, tools_endpoint, created_at, receipt (tx_hash + network) Example response: {"session_id":"f47ac10b-58cc-4372-a567-0e02b2c3d479","max_spend":"0.10","agent_address":"GBCVQCNFWPM3GDO4GPT4YEQ42ZHPY67QTJA3WN5ERQIKQDXKBX62SLNJ","label":null,"gateway_url":"https://agentpay.tools","tools_endpoint":"https://agentpay.tools/tools","created_at":"2026-05-27T12:00:00Z","receipt":{"tx_hash":"0xabc...def","network":"base","amount_usdc":"0.01"},"sdk_hint":"Use `from agentpay import Session` to enforce the max_spend cap client-side."} Price: $0.01 USDC per call (x402 over MCP: an unpaid call returns PaymentRequired; pay via _meta x402/payment)

輸入參數labelmax_spendagent_address

pre_trade_check

Pre Trade Check

One-call pre-trade sanity check: 'I want to long $X of SYMBOL — is now sane?' Combines live orderbook slippage at YOUR size, cross-exchange funding (carry cost), open-interest crowding, and contract security (GoPlus) into a single ok/caution/avoid verdict with a per-factor breakdown. Major ERC-20 addresses (LINK, UNI, ARB, OP, AAVE, PEPE, SHIB) resolve automatically; native assets (BTC, ETH, SOL, ...) report security n/a; an unrecognized token without token_address reads 'unknown' and caps the verdict at caution — an unscreened contract can never read 'ok'. Replaces four API integrations and the judgment layer on top of them. Raw component data embedded so you can apply your own thresholds. Stacks tokens (STX, sBTC, USDCx, stSTX, ZEST, LEO, USDh, aeUSDC, stBTC) add the Bitflow DEX venue: price impact at YOUR size from a live route quote, the pools and bins the swap crosses, and their TVL; STX and sBTC keep their CEX perp legs, DEX-only tokens report funding/OI n/a and contract risk unscreened (no GoPlus coverage on Stacks). Use when: An agent (or human) is about to enter a position and wants one verdict covering liquidity, carry, crowding, and security — instead of four raw feeds plus its own synthesis. Not for: you need a single raw factor — funding_rates, open_interest, orderbook_depth or token_security are free; you are not about to size a position. This call settles $0.01 on-chain. Returns: verdict (ok/caution/avoid), factors{liquidity,carry,crowding,security} each with level + reason, components{orderbook_depth,funding_rates,open_interest}, symbol, side, size_usd Example response: {"symbol":"ETH","side":"long","size_usd":50000,"venue":"cex","verdict":"caution","factors":{"liquidity":{"level":"ok","slippage_pct":0.011,"bucket_usd":50000,"reason":"fills within 0.011% of best ask"},"carry":{"level":"caution","median_funding_pct":0.062,"annualized_pct":67.9,"reason":"longs paying elevated funding"},"crowding":{"level":"ok","long_short_ratio":1.4,"oi_change_24h_pct

輸入參數sidevenuesymbol必填size_usdtoken_address

verified_route

Verified Route

Paid buyer-side trust oracle: 'I need X, budget $Y — which x402 tool is real?' Sweeps the WHOLE x402 marketplace across many queries (a single search shows only a slice), collapses sybil/factory clusters (one wallet stamping many fake-distinct listings → one entry), ranks the genuinely-used survivors by real unique-payer usage, and returns ONE vetted recommendation with a ready-to-pay x402 challenge. The credit-bureau check an agent cannot do itself in one query — pay $0.01 to avoid paying a scam or a dead stub. Use when: An agent is about to pay an unknown x402 tool and wants the real, used, non-sybil one under budget — not just the cheapest. Not for: you already know which AgentPay tool you need — call it directly; you only want a free preview of the marketplace ranking — the MCP's free preview (verified_route_preview on the remote server). This call settles $0.01 on-chain. Returns: recommendation (with ready_to_pay), survivors[] (each with typed evidence[]), catalog{scanned, real_providers, sybil_collapsed, biggest_factory}, vetting summary Example response: {"need":"dex pair liquidity","chain":null,"budget_usd":"1","recommendation":{"name":"Otto AI","url":"https://otto.example/dex","price_usd":"0.001","network":"eip155:8453","pay_to":"0x0e84ddedaae6a7","payers30d":200,"calls30d":3246,"quality":3851,"flags":[],"evidence":[{"type":"delivery","source":"agentpay-prober","metric":"delivery_rate","value":1,"n":12,"observed_at":"2026-09-30T13:05:00Z","ref":"/s/otto-example-dex-1a2b3c"},{"type":"third-party","source":"coinbase-bazaar","metric":"unique_payers_30d","value":200,"observed_at":"2026-10-01T12:00:00Z","ref":null}],"ready_to_pay":{"url":"https://otto.example/dex","network":"eip155:8453","price_usd":"0.001","accepts":{"scheme":"exact","network":"eip155:8453"}}},"survivors":[],"catalog":{"scanned":117,"after_vetting":114,"real_providers":41,"unique_wallets":38,"sybil_collapsed":73,"biggest_factory":{"pay_to":"0x2bb72231eed3","listings":72}},"vetting":"swept 17 q

輸入參數need必填chainbudget_usd

token_price

Token Price

Get the current USD price of any cryptocurrency token Use when: You need the current USD price, 24h change, or market cap of any cryptocurrency. Not for: you need volume, ATH or a pair quote — token_market_data; a one-call macro + crypto overview — market_snapshot; pool depth or slippage — orderbook_depth. Returns: price_usd, change_24h_pct, market_cap_usd, coin_id Example response: {"symbol":"ETH","price_usd":2069.73,"change_24h_pct":-4.04,"market_cap_usd":250330787714.19,"source":"coingecko"} Price: $0.000 USDC per call

輸入參數symbol必填

gas_tracker

Gas Tracker

Get current Ethereum gas prices (slow, standard, fast) Use when: You need to know current Ethereum gas prices before submitting a transaction or estimating costs. Not for: you need gas as part of a broader read — market_snapshot already includes standard gwei; only Ethereum mainnet gas is reported. Returns: slow_gwei, standard_gwei, fast_gwei, base_fee_gwei, estimated confirmation times Example response: {"slow_gwei":1.5,"standard_gwei":2,"fast_gwei":3,"base_fee_gwei":1.2,"source":"etherscan"} Price: $0.000 USDC per call

無需輸入參數。

yield_scanner

Yield Scanner

Find best DeFi yield opportunities across protocols for a given token Use when: You need to find the best yield/APY for a token across DeFi protocols. Not for: you need a protocol's total TVL rather than pool APYs — defi_tvl; risk_level is a heuristic, run token_security on the pool's token before depositing. Returns: list of pools with protocol, apy, tvl_usd, chain, risk_level sorted by APY descending Example response: {"token":"USDC","pools":[{"protocol":"morpho","apy":8.74,"tvl_usd":312000000,"chain":"Ethereum","risk_level":"low"},{"protocol":"aave-v3","apy":5.21,"tvl_usd":1840000000,"chain":"Ethereum","risk_level":"low"},{"protocol":"compound-v3","apy":4.87,"tvl_usd":920000000,"chain":"Ethereum","risk_level":"low"}],"source":"defillama"} Price: $0.000 USDC per call

輸入參數chaintoken必填min_tvl

open_interest

Open Interest

Get total open interest in perpetual futures for any asset, with 1h and 24h change rates. Pairs with funding_rates to complete the derivatives picture — rising OI with high funding = overcrowded position. Use when: You need to know total open interest in perpetual futures and whether it's rising or falling. Combine with funding_rates for a full derivatives picture. Not for: you need the funding cost of holding a position — funding_rates; a single trade verdict — pre_trade_check. Returns: total_oi_usd, oi_change_1h_pct, oi_change_24h_pct, long_short_ratio, per-exchange breakdown Example response: {"asset":"ETH","price_usd":2069.73,"total_oi_usd":8420000000,"oi_change_1h_pct":1.2,"oi_change_24h_pct":12.4,"long_short_ratio":1.08,"long_short_ratios":{"Binance":1.08,"OKX":1.11,"Gate.io":1.02},"long_short_spread":0.09,"exchanges":[{"exchange":"Binance","oi_contracts":4066123.5,"oi_change_1h_pct":1.2,"oi_change_24h_pct":12.4,"long_short_ratio":1.08}],"source":"binance/bybit/okx + gate/bitget (L/S)","primary":"binance"} Price: $0.000 USDC per call

輸入參數asset

orderbook_depth

Orderbook Depth

Get real bid/ask depth and slippage estimates at $10k, $50k, and $250k notional from Binance, Bybit and OKX. Use before sizing a position to know if you can execute without moving the market. Use when: You need to estimate slippage before executing a large trade. Tells you how much a $10k, $50k, or $250k order will move the market. Not for: you need market cap or 24h volume — token_market_data; a full pre-trade verdict at your size — pre_trade_check. Centralised-exchange books (Binance/Bybit/OKX) only, not DEX pools. Returns: best_bid, best_ask, spread_pct, depth with slippage_pct at $10k/$50k/$250k notional, per-exchange best prices Example response: {"asset":"ETH","pair":"ETH/USDT","best_ask":2071.5,"best_bid":2071.2,"spread_pct":0.0145,"depth":[{"notional_usd":10000,"slippage_pct":0.002,"executable":true},{"notional_usd":50000,"slippage_pct":0.008,"executable":true},{"notional_usd":250000,"slippage_pct":0.031,"executable":true}],"exchanges":[{"exchange":"Binance","best_ask":2071.5,"best_bid":2071.2},{"exchange":"Bybit","best_ask":2071.6,"best_bid":2071.1}],"source":"binance/bybit/okx"} Price: $0.000 USDC per call

輸入參數asset必填

wallet_balance

Wallet Balance

Get the token balances for any Ethereum or Stellar wallet address Use when: You need to look up the token holdings of an Ethereum or Stellar wallet address. Not for: you want a token's price or market data rather than one address's holdings — token_price / token_market_data; large transfers across many wallets — whale_activity. Ethereum addresses are 0x…, Stellar addresses G…; no other chains. Returns: list of token balances (symbol, amount) for the given address Example response: {"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chain":"ethereum","balances":[{"token":"ETH","amount":"1.234"},{"token":"USDC","contract":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","amount":"500.00"}]} Price: $0.000 USDC per call

輸入參數chain必填address必填

fear_greed_index

Fear Greed Index

Crypto Fear & Greed Index (0=extreme fear, 100=extreme greed) with optional history Use when: You need to gauge overall crypto market sentiment or mood — whether the market is fearful or greedy. Not for: you want token-specific sentiment — crypto_news (per-token headlines) or funding_rates (leveraged positioning). Returns: value (0–100), value_classification (e.g. 'Greed'), optional history[] Example response: {"value":10,"value_classification":"Extreme Fear","timestamp":1774137600,"source":"alternative.me"} Price: $0.000 USDC per call

輸入參數limit

crypto_news

Crypto News

Latest crypto news and community sentiment from r/CryptoCurrency for any token Use when: You need recent news headlines or community sentiment for one or more crypto tokens. Not for: you need general web news or documentation — web_search; a specific article's text — url_reader; a numeric sentiment gauge — fear_greed_index. Returns: headlines[] with title, url, sentiment (bullish/neutral/bearish), score, published_at Example response: {"currencies":"ETH","headlines":[{"title":"Ethereum devs confirm Pectra upgrade timeline","url":"https://reddit.com/r/CryptoCurrency/...","sentiment":"bullish","score":1842,"published_at":"2026-03-22T08:14:00Z"},{"title":"ETH gas fees drop to yearly lows","url":"https://reddit.com/r/CryptoCurrency/...","sentiment":"bullish","score":934,"published_at":"2026-03-22T06:31:00Z"}],"source":"reddit"} Price: $0.000 USDC per call

輸入參數filtercurrencies

defi_tvl

Defi Tvl

DeFi protocol Total Value Locked from DeFiLlama. Returns top 10 or a specific protocol. Use when: You need the Total Value Locked in a specific DeFi protocol or want to compare the top protocols by TVL. Not for: you want the best yield for a token — yield_scanner; protocol revenue or custom metrics — dune_query. Returns: tvl, change_1h, change_1d, change_7d, chains[], category for the protocol (or top 10 list) Example response: {"protocol":"aave","tvl":23800000000,"change_1h":0.12,"change_1d":-1.43,"change_7d":3.21,"chains":["Ethereum","Polygon","Avalanche","Base"],"category":"Lending","source":"defillama"} Price: $0.000 USDC per call

輸入參數protocol

token_market_data

Token Market Data

Get market cap, 24h volume, ATH, and price change for any token. Note: does NOT return pool depth or slippage — for pre-trade liquidity estimates, use a dedicated orderbook tool. Use when: You need 24h trading volume, market cap, or all-time high for a token pair on decentralized exchanges. Not for: you only need the spot price — token_price is lighter; you need pool depth or slippage — orderbook_depth. Returns: volume_24h_usd, market_cap_usd, price_usd, ath_usd, price_change_24h_pct Example response: {"token_a":"ETH","token_b":"USDC","price_usd":2071.45,"volume_24h_usd":312847293,"volume_change_24h_pct":-8.3,"market_cap_usd":249800000000,"ath_usd":4878.26,"price_change_24h_pct":-3.91,"source":"coingecko"} Price: $0.000 USDC per call

輸入參數token_a必填token_b必填

token_security

Token Security

Scan any token contract for honeypot, rug pull, and security risks Use when: You need to check if a token contract is safe before trading or investing. Not for: the asset is a native coin (BTC, ETH, SOL) with no contract — nothing to scan; you want liquidity or price — orderbook_depth / token_price. Ethereum and BSC contracts only. Returns: risk_level, is_honeypot, buy_tax, sell_tax, holder_count, owner_address, is_mintable, can_take_back_ownership Example response: {"contract_address":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","chain":"ethereum","risk_level":"low","is_honeypot":false,"buy_tax":0,"sell_tax":0,"holder_count":842341,"is_mintable":false,"can_take_back_ownership":false,"source":"goplus"} Price: $0.000 USDC per call

輸入參數chaincontract_address必填

funding_rates

Funding Rates

Get perpetual futures funding rates across Binance, Bybit, and OKX Use when: You need funding rates to gauge leveraged market sentiment or cost of holding a perp position. Not for: you need open interest or long/short ratio — open_interest; one verdict combining funding, OI, slippage and security for a trade — pre_trade_check. Returns: funding_rate_pct, annualized_rate_pct, sentiment (bullish/neutral/bearish) per exchange Example response: {"asset":"BTC","rates":[{"exchange":"binance","funding_rate_pct":0.012,"annualized_rate_pct":13.14,"sentiment":"bullish"},{"exchange":"bybit","funding_rate_pct":0.011,"annualized_rate_pct":12.04,"sentiment":"bullish"},{"exchange":"okx","funding_rate_pct":0.009,"annualized_rate_pct":9.85,"sentiment":"neutral"}],"source":"binance/bybit/okx"} Price: $0.000 USDC per call

輸入參數asset

dune_query

Dune Query

Run any Dune Analytics query and return live onchain results by query ID. Use fast_only=True for live bots — returns cached result instantly or raises immediately, never blocks. Use when: You need deep onchain analytics from a specific Dune query — protocol revenue, user counts, custom metrics. Not for: you have no Dune query ID — the other tools cover prices, derivatives, TVL and security without one; you need sub-second answers — set fast_only=true or use a cached tool. Returns: rows[], columns[], row_count, generated_at from the Dune Analytics query result Example response: {"query_id":3810512,"row_count":2,"columns":["protocol","revenue_usd"],"rows":[{"protocol":"Uniswap V3","revenue_usd":1243800},{"protocol":"Aave V3","revenue_usd":987200}],"generated_at":"2026-03-22T00:00:00Z","source":"dune"} Price: $0.000 USDC per call

輸入參數limitquery_id必填fast_onlyquery_parameters

url_reader

Url Reader

Convert any URL to clean, LLM-ready markdown. Strips ads, nav, and boilerplate — returns just the content. No API key needed. Use when: You need to read the content of a web page or article and get clean, structured text for further processing. Not for: you do not have a URL yet — web_search returns pages with content; the page requires a login or renders only in a browser. Returns: content (markdown), url, length, truncated flag Example response: {"url":"https://example.com","content":"# Example Domain\n\nThis domain is for use in illustrative examples...","length":1256,"truncated":false,"source":"jina_reader"} Price: $0.000 USDC per call

輸入參數url必填

market_snapshot

Market Snapshot

Fed rate, inflation proxy, S&P 500, BTC, ETH, and gas in one call. Replaces three separate API integrations with a single normalized response — the only tool that gives you macro + crypto in one shot. Use when: You need a combined macro + crypto market overview in one call: S&P 500, Treasury yield, BTC, ETH, and Ethereum gas. Not for: you need one asset in depth — token_price, gas_tracker or funding_rates; history or time series — dune_query. Returns: sp500_price, sp500_change_pct, treasury_yield_10y, btc_price_usd, eth_price_usd, gas_standard_gwei, timestamp Example response: {"sp500_price":5234.18,"sp500_change_pct":-0.42,"treasury_yield_10y":4.31,"btc_price_usd":67200,"eth_price_usd":3450,"gas_standard_gwei":5.2,"timestamp":"2026-05-26T12:00:00Z","source":"yahoo_finance+coingecko+etherscan"} Price: $0.000 USDC per call

無需輸入參數。

whale_activity

Whale Activity

Detect recent large wallet movements for a token (whale tracking) Use when: You need to detect large token transfers that may signal institutional moves, accumulation, or sell-offs. Not for: you need one address's holdings — wallet_balance; exchange order-book size rather than on-chain transfers — orderbook_depth. Ethereum ERC-20 transfers only. Returns: large_transfers[] with from, to (full addresses), amount, usd_value, minutes_ago, tx_hash; total_volume_usd Example response: {"token":"USDC","large_transfers":[{"from":"0xabababababababababababababababababababab","to":"0xcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd","amount":5000000,"usd_value":5000000,"minutes_ago":12,"tx_hash":"0x9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f9f"},{"from":"0x1111111111111111111111111111111111111111","to":"0x2222222222222222222222222222222222222222","amount":2500000,"usd_value":2500000,"minutes_ago":34,"tx_hash":"0x7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a"}],"total_volume_usd":7500000,"source":"etherscan"} Price: $0.000 USDC per call

輸入參數token必填min_usd

verified_route_preview

Verified Route (x402 trust oracle, preview)

Buyer-side trust oracle for the x402 marketplace: "I need X, budget $Y — which tool is real?" Vets Coinbase Bazaar (discover → drop stubs/factory clones → rank by real unique-payer usage → budget-gate). This MCP runs the FREE single-query PREVIEW: it returns the vetted pick (name + usage stats + why) and survivor count to PROVE a real provider exists, but WITHHOLDS the provider URL + ready-to-pay x402 challenge. To get those — plus the full multi-query sweep + usage-based sybil-collapse + trust allowlist — call verified_route ($0.01: an unpaid call returns the x402 PaymentRequired, which a wallet-carrying client pays in-band), or use the agentpay-x402 SDK. This preview never charges. Use when: "which x402 tool for X", "find a real/trustworthy paid API for X", "avoid a scam or dead stub", "vet this provider before I pay".

輸入參數need必填chainbudget_usd

route

Route (x402 marketplace routing, legacy)

Legacy alias of verified_route (kept for back-compat). Find and judge the best paid x402 tool for a need, within a budget. Discovers across Coinbase Bazaar, drops stubs (no schema / factory clones), ranks survivors by real usage (unique payers × 3 + calls + recency bonus), enforces the budget, price- tiebreaks quality-equal candidates. Returns ranked candidates + a recommendation + ready-to-pay details. Advise-only — no payment happens here. Prefer verified_route (same vetting, matches the paid tool + Bazaar listing). Use when: "which x402 tool for X", "find a paid API for X under $Y".

輸入參數need必填budget

estimate_plan

Estimate Plan (pre-flight plan pricing)

Price a multi-tool plan BEFORE spending anything. Submits the tool calls an agent intends to make to the gateway's free /v1/plan/estimate and returns per-step cost, total, a fits-budget verdict, and a cheaper alternative per paid step. No payment, no wallet needed. Use when: planning a multi-step task with paid tools, "what would this cost", "does this plan fit my budget", or before committing a Session cap.

輸入參數steps必填budget

版本歷史

4
  1. v2.8.0最新Nov 3, 2026
  2. v2.7.3Oct 3, 2026
  3. v2.7.0Sep 30, 2026
  4. v2.4.3Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。

其他 Agentpay 整合

AgentPay — Pay-per-call AI Microservices

help.agentpay官方發布者

AgentPay 透過 x402 提供 34 個按次計費的 AI 與資料微服務，以 Base 上的 USDC 結算，無需 API 金鑰。

Streamable HTTP可網頁執行
網頁搜尋與抓取34 個工具Nov 7, 2026

AgentPay Doc Tools

由 GitHub 帳號 noah-silver 發布

遠端 MCP 伺服器，按次付費提供文件與網頁小工具：PDF 轉文字、RSS/Atom/JSON 訂閱解析、網站地圖 URL 列舉。

Streamable HTTP可網頁執行
網頁搜尋與抓取3 個工具Oct 27, 2026

AgentPay Domain & Network Lookup

由 GitHub 帳號 noah-silver 發布

遠端 MCP 伺服器，按次付費提供 DNS、WHOIS/RDAP、IP 歸屬與綜合網域報告查詢。

Streamable HTTP可網頁執行
網頁搜尋與抓取4 個工具Oct 29, 2026

AgentPay Web Extract

由 GitHub 帳號 noah-silver 發布

遠端按次付費的 MCP 伺服器，抓取網頁並回傳乾淨的 Markdown、中繼資料與連結供助理使用。

Streamable HTTP可網頁執行
效率與工作流1 個工具Oct 25, 2026

AgentPay (all tools)

由 GitHub 帳號 noah-silver 發布

遠端按次計費的 MCP 伺服器，提供網頁擷取、DNS/WHOIS/IP 查詢以及 PDF、訂閱源與網站地圖工具，以 USDC 或預付額度計費。

Streamable HTTP可網頁執行
網頁搜尋與抓取8 個工具Oct 24, 2026