Skip to main content
Glama
romudille-bit

AgentPay x402 — Economic-intelligence layer for AI Agents

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MAX_SPENDNoThe maximum USDC budget cap allowed for the session (e.g., '0.05').0.05
STELLAR_NETWORKNoThe Stellar network to connect to ('testnet' or 'mainnet').testnet
STELLAR_SECRET_KEYYesYour Stellar secret key (starting with 'S') used to fund tool calls via USDC.
AGENTPAY_GATEWAY_URLNoThe URL of the AgentPay gateway.https://gateway-production-2cc2.up.railway.app

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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. Returns: slow_gwei, standard_gwei, fast_gwei, base_fee_gwei, estimated confirmation times Example response: {"slow_gwei": 1.5, "standard_gwei": 2.0, "fast_gwei": 3.0, "base_fee_gwei": 1.2, "source": "etherscan"}

Price: $0.000 USDC per call

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. 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

open_interest

Get total open interest in perpetual futures for a given asset, including 1h and 24h change percentages, long/short ratio, and per-exchange breakdown. Pairs with funding_rates to complete the derivatives picture.

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. 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.0, "oi_change_1h_pct": 1.2, "oi_change_24h_pct": 12.4, "long_short_ratio": 1.08, "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"}

Price: $0.000 USDC per call

orderbook_depthA

Get real bid/ask depth and slippage estimates at $10k, $50k, and $250k notional for a trading pair. Returns best bid/ask, spread percentage, and how much slippage to expect at each trade size.

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. 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"}

Price: $0.000 USDC per call

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. 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

fear_greed_indexA

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. 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

crypto_newsA

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. 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

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. Returns: tvl, change_1h, change_1d, change_7d, chains[], category for the protocol (or top 10 list) Example response: {"protocol": "aave", "tvl": 23800000000.0, "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

yield_scannerA

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. 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.0, "chain": "Ethereum", "risk_level": "low"}, {"protocol": "aave-v3", "apy": 5.21, "tvl_usd": 1840000000.0, "chain": "Ethereum", "risk_level": "low"}, {"protocol": "compound-v3", "apy": 4.87, "tvl_usd": 920000000.0, "chain": "Ethereum", "risk_level": "low"}], "source": "defillama"}

Price: $0.000 USDC per call

whale_activityA

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. Returns: large_transfers[] with from, to, amount, usd_value, minutes_ago; total_volume_usd Example response: {"token": "USDC", "large_transfers": [{"from": "0xabc...1234", "to": "0xdef...5678", "amount": 5000000.0, "usd_value": 5000000.0, "minutes_ago": 12}, {"from": "0x111...aaaa", "to": "0x222...bbbb", "amount": 2500000.0, "usd_value": 2500000.0, "minutes_ago": 34}], "total_volume_usd": 7500000.0, "source": "etherscan"}

Price: $0.000 USDC per call

token_market_dataA

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. 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.0, "volume_change_24h_pct": -8.3, "market_cap_usd": 249800000000.0, "ath_usd": 4878.26, "price_change_24h_pct": -3.91, "source": "coingecko"}

Price: $0.000 USDC per call

token_securityA

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. 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.0, "sell_tax": 0.0, "holder_count": 842341, "is_mintable": false, "can_take_back_ownership": false, "source": "goplus"}

Price: $0.000 USDC per call

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. 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

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. 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.0}, {"protocol": "Aave V3", "revenue_usd": 987200.0}], "generated_at": "2026-03-22T00:00:00Z", "source": "dune"}

Price: $0.000 USDC per call

url_readerA

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. 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

web_search

Search the web and return the top 5 results with their full content as clean markdown. Better than DIY because zero setup and results include page content, not just links.

Use when: You need to find current information on any topic — news, documentation, prices, events, or anything else on the web. Returns: results[] with url, title, description, content; query; count Example response: {"query": "ETH gas fees today", "count": 5, "results": [{"url": "https://etherscan.io/gastracker", "title": "Ethereum Gas Tracker", "description": "Real-time Ethereum gas price tracker", "content": "Current gas: 2 Gwei..."}], "source": "jina_search"}

Price: $0.000 USDC per call

session_createA

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. 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

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. Returns: recommendation (with ready_to_pay), survivors[], 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": [], "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 queries \u2192 117 listings \u2192 collapsed 73 sybil listings \u2192 41 real providers"}

Price: $0.01 USDC per call

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. 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.0, "eth_price_usd": 3450.0, "gas_standard_gwei": 5.2, "timestamp": "2026-05-26T12:00:00Z", "source": "yahoo_finance+coingecko+etherscan"}

Price: $0.000 USDC per call

pre_trade_checkA

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 optional contract security into a single ok/caution/avoid verdict with a per-factor breakdown. Replaces four API integrations and the judgment layer on top of them. Raw component data embedded so you can apply your own thresholds.

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. 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, "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": 3.2, "reason": "positioning unremarkable"}, "security": {"level": "skipped", "reason": "no token_address provided"}}}

Price: $0.01 USDC per call

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/romudille-bit/agentpay'

If you have feedback or need assistance with the MCP directory API, please join our Discord server