{"name":"AgentPay","description":"The trust layer for AI agents that pay per call — verified delivery before the payment, a capped session during it, and a verifiable receipt after; agents price a plan before spending and route to a tool that is known to deliver. 17 tools free to start. USDC on Base or Stellar (standard x402), sBTC or STX on Stacks (any Stacks x402 client), no keys.","url":"https://agentpay.tools","version":"1.0","onboarding":{"register":"https://agentpay.tools/v1/agent/register","register_cost":"0","register_network":"stellar (free-tier identity; pay with any standard x402 client on Base or Stellar, or a Stacks x402 client for sBTC/STX)","discover_tools":"https://agentpay.tools/tools","call_tool":"https://agentpay.tools/tools/{name}/call","paid_session":"https://agentpay.tools/v1/session/create","sdk":"pip install agentpay-x402","sdk_quickstart":"from agentpay import quickstart; s = quickstart(); s.call('token_price', {'symbol':'ETH'})"},"capabilities":{"tools":true,"budget_sessions":true,"session_receipts":true,"payments":"x402-v2","networks":["stellar-mainnet","base-mainnet","stacks-mainnet"],"free_tools":17,"paid_tools":3},"contact":"https://github.com/romudille-bit/agentpay","tools":[{"name":"token_price","description":"Get the current USD price of any cryptocurrency token","price_usdc":"0.000","category":"data","call_endpoint":"https://agentpay.tools/tools/token_price/call","triggers":["price","how much is","what is btc","token value","crypto price","usd","market price","worth"],"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"},{"name":"gas_tracker","description":"Get current Ethereum gas prices (slow, standard, fast)","price_usdc":"0.000","category":"data","call_endpoint":"https://agentpay.tools/tools/gas_tracker/call","triggers":["gas","gwei","transaction fee","ethereum fee","network congestion","gas price","eth fee"],"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"},{"name":"yield_scanner","description":"Find best DeFi yield opportunities across protocols for a given token","price_usdc":"0.000","category":"defi","call_endpoint":"https://agentpay.tools/tools/yield_scanner/call","triggers":["yield","apy","earn","interest","lending","staking","defi returns","best rate"],"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"},{"name":"open_interest","description":"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.","price_usdc":"0.000","category":"defi","call_endpoint":"https://agentpay.tools/tools/open_interest/call","triggers":["open interest","oi","long short ratio","futures positioning","perp oi","market positioning","leverage"],"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"},{"name":"orderbook_depth","description":"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.","price_usdc":"0.000","category":"data","call_endpoint":"https://agentpay.tools/tools/orderbook_depth/call","triggers":["slippage","orderbook","market depth","liquidity","can i sell","execution cost","bid ask","spread","fill price"],"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"},{"name":"wallet_balance","description":"Get the token balances for any Ethereum or Stellar wallet address","price_usdc":"0.000","category":"data","call_endpoint":"https://agentpay.tools/tools/wallet_balance/call","triggers":["wallet","balance","holdings","portfolio","address","how much does","tokens in wallet"],"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"},{"name":"fear_greed_index","description":"Crypto Fear & Greed Index (0=extreme fear, 100=extreme greed) with optional history","price_usdc":"0.000","category":"data","call_endpoint":"https://agentpay.tools/tools/fear_greed_index/call","triggers":["fear","greed","sentiment","market mood","investor sentiment","bullish","bearish","panic","fomo"],"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[]"},{"name":"crypto_news","description":"Latest crypto news and community sentiment from r/CryptoCurrency for any token","price_usdc":"0.000","category":"data","call_endpoint":"https://agentpay.tools/tools/crypto_news/call","triggers":["news","headlines","what's happening","latest","trending","community","reddit","narrative","buzz"],"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"},{"name":"defi_tvl","description":"DeFi protocol Total Value Locked from DeFiLlama. Returns top 10 or a specific protocol.","price_usdc":"0.000","category":"defi","call_endpoint":"https://agentpay.tools/tools/defi_tvl/call","triggers":["tvl","total value locked","defi","protocol","aave","uniswap","lido","compound","locked funds"],"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)"},{"name":"token_market_data","description":"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.","price_usdc":"0.000","category":"data","call_endpoint":"https://agentpay.tools/tools/token_market_data/call","triggers":["liquidity","volume","dex","trading volume","slippage","market depth","uniswap","all-time high","ath"],"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"},{"name":"token_security","description":"Scan any token contract for honeypot, rug pull, and security risks","price_usdc":"0.000","category":"security","call_endpoint":"https://agentpay.tools/tools/token_security/call","triggers":["rug","honeypot","safe","scam","contract risk","token security","is this safe","audit"],"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"},{"name":"funding_rates","description":"Get perpetual futures funding rates across Binance, Bybit, and OKX","price_usdc":"0.000","category":"defi","call_endpoint":"https://agentpay.tools/tools/funding_rates/call","triggers":["funding rate","perp","perpetual","long","short","futures","leverage sentiment"],"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"},{"name":"dune_query","description":"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.","price_usdc":"0.000","category":"data","call_endpoint":"https://agentpay.tools/tools/dune_query/call","triggers":["dune","onchain","sql","analytics","custom query","blockchain data","onchain metrics","protocol stats"],"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"},{"name":"url_reader","description":"Convert any URL to clean, LLM-ready markdown. Strips ads, nav, and boilerplate — returns just the content. No API key needed.","price_usdc":"0.000","category":"data","call_endpoint":"https://agentpay.tools/tools/url_reader/call","triggers":["read url","fetch page","scrape","extract content","read article","get page","url to text","website content"],"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"},{"name":"web_search","description":"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.","price_usdc":"0.000","category":"data","call_endpoint":"https://agentpay.tools/tools/web_search/call","triggers":["search","look up","find","google","web search","what is","latest news","who is","current"],"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"},{"name":"session_create","description":"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.","price_usdc":"0.01","category":"session","call_endpoint":"https://agentpay.tools/tools/session_create/call","triggers":["start session","open session","register agent","budget cap","session create","agentpay session"],"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)"},{"name":"market_snapshot","description":"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.","price_usdc":"0.000","category":"data","call_endpoint":"https://agentpay.tools/tools/market_snapshot/call","triggers":["market overview","market snapshot","macro","big picture","market summary","overall market","sp500","s&p","bitcoin and stocks"],"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"},{"name":"pre_trade_check","description":"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).","price_usdc":"0.01","category":"trading","call_endpoint":"https://agentpay.tools/tools/pre_trade_check/call","triggers":["pre trade check","should I trade","is this trade sane","trade check","entry check","before I buy","slippage and funding","trade readiness"],"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"},{"name":"verified_route","description":"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.","price_usdc":"0.01","category":"routing","call_endpoint":"https://agentpay.tools/tools/verified_route/call","triggers":["verified route","which tool","is this tool real","vet tool","trustworthy x402","find a real tool","avoid scam tool","best x402 tool","trust score","vetted route"],"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[] (each with typed evidence[]), catalog{scanned, real_providers, sybil_collapsed, biggest_factory}, vetting summary"},{"name":"whale_activity","description":"Detect recent large wallet movements for a token (whale tracking)","price_usdc":"0.000","category":"monitoring","call_endpoint":"https://agentpay.tools/tools/whale_activity/call","triggers":["whale","large transfer","big move","institutional","smart money","accumulation","dump","sell-off"],"use_when":"You need to detect large token transfers that may signal institutional moves, accumulation, or sell-offs.","returns":"large_transfers[] with from, to (full addresses), amount, usd_value, minutes_ago, tx_hash; total_volume_usd"}]}