← all AgentPay tools

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

When agents use this

You need a combined macro + crypto market overview in one call: S&P 500, Treasury yield, BTC, ETH, and Ethereum gas.

Parameters

None — call with an empty parameters object.

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

Call it — HTTP (x402)

curl -X POST https://agentpay.tools/tools/market_snapshot/call \
  -H 'Content-Type: application/json' \
  -d '{"parameters": {}, "agent_address": "<your wallet or any identifier>"}'

Call it — Python SDK

from agentpay import quickstart  # pip install agentpay-x402

s = quickstart(max_spend=0.10)   # hard budget cap; mints a wallet, no funding needed
r = s.call("market_snapshot", {})
print(r.data)                    # + r.cost, r.tx, r.network — full receipt

Call it — MCP

npx -y @romudille/agentpay-mcp   # keyless; exposes market_snapshot to any MCP agent runtime