Ten small tools for agents, one paid call at a time

Ten pay-per-call tools for AI agents, no API key: chain head and gas on five EVM chains, NFT owner, holdings, balances and metadata, Chainlink crypto prices, any web page as markdown, weather anywhere, and ECB exchange rates. USDC on Base via x402, from $0.001 a call.

endpointwhat it answersprice
GET /blockLatest block and its age on five EVM chains$0.001 per call
GET /gasGas tiers and transfer cost in USD on five EVM chains, cheapest first$0.001 per call
GET /nft/tokensToken ids an address holds in one ERC-721 collection$0.002 per call
GET /nft/metadataResolved metadata JSON, image and attributes for any ERC-721 or ERC-1155 token$0.002 per call
GET /nft/ownerCurrent owner of an ERC-721 token$0.001 per call
GET /nft/balanceERC-1155 balances of an address for up to 50 token ids$0.001 per call
GET /priceLive Chainlink oracle prices for up to 20 crypto assets in USD$0.001 per call
GET /readFetch a public web page and return clean markdown or plain text with its title and metadata$0.001 per call
GET /weatherCurrent weather and a 3-day forecast for a place name or latitude and longitude$0.001 per call
GET /fxLatest or historic ECB reference exchange rates with optional amount conversion$0.001 per call

How paying works

Without payment every endpoint answers 402 Payment Required with a PAYMENT-REQUIRED header. An x402 client (for example @x402/fetch, AgentCash, or any Bazaar-aware agent) signs a USDC authorization and retries with PAYMENT-SIGNATURE. Settlement runs only after a successful response: bad input, nothing found, a blocked URL or an upstream outage is not charged.

GET /block: Latest block and its age on five EVM chains

$0.001 per call

Latest block on Base, Ethereum, Arbitrum, Optimism and Polygon in one call: number, hash, timestamp, age in seconds, transaction count, gas used and limit, base fee. Read live with RPC failover; per-chain status. Not charged for bad input or when every chain fails. No API key.

GET https://x402-toolbox.vercel.app/block?chains=base%2Cethereum
paramrequiredmeaning
chainsnoComma list, any of: base,ethereum,arbitrum,optimism,polygon. Default: all five.
Example response
{
  "fetchedAt": "2026-11-20T23:39:15.745Z",
  "chainsOk": 1,
  "chainsFailed": 0,
  "chains": [
    {
      "chain": "base",
      "chainId": 8453,
      "status": "ok",
      "number": "60137911",
      "hash": "0x38bdfce10b68f89e05043c4ac3a101913d4ed1777aafce5e01f059be2a1f9def",
      "timestamp": "2026-11-20T23:39:17.000Z",
      "ageSeconds": 0,
      "txCount": 21,
      "gasUsed": "2661978",
      "gasLimit": "40000000",
      "baseFeePerGas": "5000000"
    }
  ]
}

Not charged: 400 bad input, 502 every requested chain unavailable.

GET /gas: Gas tiers and transfer cost in USD on five EVM chains, cheapest first

$0.001 per call

Gas oracle for Base, Ethereum, Arbitrum, Optimism and Polygon: next base fee, slow, standard and fast priority-fee tiers (median of the last 10 blocks), max fee per gas, and the cost of a 21000-gas transfer in native coin and USD via Chainlink. Sorted cheapest first. Not charged for bad input or when every chain fails. No API key.

GET https://x402-toolbox.vercel.app/gas?chains=base%2Cethereum
paramrequiredmeaning
chainsnoComma list, any of: base,ethereum,arbitrum,optimism,polygon. Default: all five.
Example response
{
  "fetchedAt": "2026-11-20T23:39:15.821Z",
  "chainsOk": 1,
  "chainsFailed": 0,
  "chains": [
    {
      "chain": "base",
      "chainId": 8453,
      "status": "ok",
      "nativeSymbol": "ETH",
      "nextBaseFeeWei": "5000000",
      "nextBaseFeeGwei": 0.005,
      "gasPriceWei": "6000000",
      "gasPriceGwei": 0.006,
      "tiers": {
        "slow": {
          "tipWei": "125000",
          "tipGwei": 0.000125,
          "maxFeePerGasWei": "10125000",
          "maxFeePerGasGwei": 0.010125
        },
        "standard": {
          "tipWei": "1000000",
          "tipGwei": 0.001,
          "maxFeePerGasWei": "11000000",
          "maxFeePerGasGwei": 0.011
        },
        "fast": {
          "tipWei": "1202500",
          "tipGwei": 0.0012025,
          "maxFeePerGasWei": "11202500",
          "maxFeePerGasGwei": 0.0112025
        }
      },
      "transferCost": {
        "symbol": "ETH",
        "wei": "126000000000",
        "formatted": "0.000000126",
        "gas": 21000
      },
      "note": "OP-stack chain: the L1 data fee (posting the transaction to Ethereum) is charged on top of this execution cost.",
      "nativeUsd": 1623.82852773,
      "transferCostUsd": 0.0002046
    }
  ]
}

Not charged: 400 bad input, 502 every requested chain unavailable.

GET /nft/tokens: Token ids an address holds in one ERC-721 collection

$0.002 per call

Lists the token ids an address holds in one ERC-721 collection (up to 200), with balance, collection name and symbol, read live on Base, Ethereum, Arbitrum, Optimism or Polygon. Needs an ERC721Enumerable contract. Not charged for bad input, a non-enumerable contract, a non-ERC-721 address or a chain outage. No API key.

GET https://x402-toolbox.vercel.app/nft/tokens?owner=0x46EFbAedc92067E6d60E84ED6395099723252496&contract=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&chain=ethereum&limit=100
paramrequiredmeaning
owneryesWallet address to list holdings for
contractyesERC-721 collection contract address
chainnoOne chain, any of: base,ethereum,arbitrum,optimism,polygon. Default: ethereum.
limitnoMax token ids to return, 1-200 (default 100)
Example response
{
  "owner": "0x46EFbAedc92067E6d60E84ED6395099723252496",
  "contract": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
  "chain": "ethereum",
  "balance": "1",
  "tokenIds": [
    "1"
  ],
  "truncated": false,
  "name": "BoredApeYachtClub",
  "symbol": "BAYC"
}

Not charged: 400 bad input, 422 contract is not ERC-721 or not enumerable, 502 chain unavailable.

GET /nft/metadata: Resolved metadata JSON, image and attributes for any ERC-721 or ERC-1155 token

$0.002 per call

Resolves an NFT to its metadata in one call: reads tokenURI or uri on-chain, fetches ipfs, arweave, data and http URIs (SSRF-safe), and returns name, description, image gateway URL, attributes, owner and collection name. ERC-721 and ERC-1155. Not charged for bad input, a missing token, an unreachable metadata URL or a chain outage. No API key.

GET https://x402-toolbox.vercel.app/nft/metadata?contract=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&tokenId=1&chain=ethereum
paramrequiredmeaning
contractyesNFT contract address
tokenIdyesToken id, decimal or 0x hex
chainnoOne chain, any of: base,ethereum,arbitrum,optimism,polygon. Default: ethereum.
Example response
{
  "contract": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
  "tokenId": "1",
  "chain": "ethereum",
  "standard": "erc721",
  "collectionName": "BoredApeYachtClub",
  "symbol": "BAYC",
  "owner": "0x46EFbAedc92067E6d60E84ED6395099723252496",
  "tokenUri": "ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/1",
  "metadataUrl": "https://ipfs.io/ipfs/QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/1",
  "metadata": {
    "name": null,
    "description": null,
    "image": "ipfs://QmPbxeGcXhYQQNgsC6a36dDyYUcHgMLnGKnF8pVFmGsvqi",
    "imageUrl": "https://ipfs.io/ipfs/QmPbxeGcXhYQQNgsC6a36dDyYUcHgMLnGKnF8pVFmGsvqi",
    "animationUrl": null,
    "externalUrl": null,
    "attributes": [
      {
        "trait_type": "Mouth",
        "value": "Grin"
      },
      {
        "trait_type": "Fur",
        "value": "Robot"
      }
    ]
  },
  "raw": {
    "image": "ipfs://QmPbxeGcXhYQQNgsC6a36dDyYUcHgMLnGKnF8pVFmGsvqi",
    "attributes": [
      {
        "trait_type": "Mouth",
        "value": "Grin"
      },
      {
        "trait_type": "Fur",
        "value": "Robot"
      }
    ]
  },
  "rawTruncated": false
}

Not charged: 400 bad input, 404 token has no tokenURI or uri, 422 metadata URL refused by the SSRF guard, 502 chain or metadata host unavailable.

GET /nft/owner: Current owner of an ERC-721 token

$0.001 per call

Current owner of one ERC-721 token, checksummed, with collection name, symbol and tokenURI, read live on Base, Ethereum, Arbitrum, Optimism or Polygon. Not charged for bad input, a token that does not exist or a contract that is not ERC-721, or a chain outage. No API key.

GET https://x402-toolbox.vercel.app/nft/owner?contract=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&tokenId=1&chain=ethereum
paramrequiredmeaning
contractyesERC-721 contract address
tokenIdyesToken id, decimal or 0x hex
chainnoOne chain, any of: base,ethereum,arbitrum,optimism,polygon. Default: ethereum.
Example response
{
  "contract": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
  "tokenId": "1",
  "chain": "ethereum",
  "owner": "0x46EFbAedc92067E6d60E84ED6395099723252496",
  "collectionName": "BoredApeYachtClub",
  "symbol": "BAYC",
  "tokenUri": "ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/1"
}

Not charged: 400 bad input, 404 token does not exist or contract is not ERC-721, 502 chain unavailable.

GET /nft/balance: ERC-1155 balances of an address for up to 50 token ids

$0.001 per call

ERC-1155 balances of one address for 1-50 token ids of a single contract, read in one batched call on Base, Ethereum, Arbitrum, Optimism or Polygon. Returns per-id balance and the total. Not charged for bad input, a contract that is not ERC-1155, or a chain outage. No API key.

GET https://x402-toolbox.vercel.app/nft/balance?owner=0x1d10a37327ec3a0a64925aCeD29bFB5623df54f5&contract=0x81A22628CB0a69e6391612D9Fa21B9A18Cf5C16C&ids=4%2C5&chain=ethereum
paramrequiredmeaning
owneryesWallet address to read
contractyesERC-1155 contract address
idsyesComma list of 1-50 token ids, decimal or 0x hex
chainnoOne chain, any of: base,ethereum,arbitrum,optimism,polygon. Default: ethereum.
Example response
{
  "owner": "0x1d10a37327ec3a0a64925aCeD29bFB5623df54f5",
  "contract": "0x81A22628CB0a69e6391612D9Fa21B9A18Cf5C16C",
  "chain": "ethereum",
  "balances": [
    {
      "id": "4",
      "balance": "250"
    },
    {
      "id": "5",
      "balance": "250"
    }
  ],
  "total": "500"
}

Not charged: 400 bad input, 422 contract is not ERC-1155, 502 chain unavailable.

GET /price: Live Chainlink oracle prices for up to 20 crypto assets in USD

$0.001 per call

Live USD prices for BTC, ETH, LINK, SOL, USDC and ~20 more, read straight from Chainlink aggregator contracts on Ethereum: price, decimals, round id, last update time and age in seconds. Not charged for bad input, an unsupported symbol, or when every feed read fails. No API key.

GET https://x402-toolbox.vercel.app/price?symbols=BTC%2CETH%2CLINK
paramrequiredmeaning
symbolsyesComma list of 1-20 symbols, e.g. BTC,ETH,LINK. Supported: BTC,ETH,LINK,USDC,USDT,DAI,SOL,BNB,MATIC,POL,AVAX,UNI,AAVE,ARB,MKR,SNX,CRV,COMP,stETH
quotenoQuote currency. Only USD is supported (default).
Example response
{
  "quote": "USD",
  "source": "chainlink",
  "chain": "ethereum",
  "fetchedAt": "2026-11-20T23:39:23.139Z",
  "prices": [
    {
      "status": "ok",
      "symbol": "LINK",
      "price": 8.54503,
      "priceRaw": "854503000",
      "decimals": 8,
      "updatedAt": "2026-11-20T23:28:35.000Z",
      "ageSeconds": 648,
      "roundId": "129127208515966897268",
      "feed": "0x2c1d072e956AFFC0D435Cb7AC38EF18d24d9127c",
      "description": "LINK / USD"
    }
  ]
}

Not charged: 400 bad input or unsupported symbol, 502 every feed read failed.

GET /read: Fetch a public web page and return clean markdown or plain text with its title and metadata

$0.001 per call

Fetch a public http(s) page and return clean markdown or plain text plus title, description, canonical, language, og:image, word and link counts. Honours robots.txt. Social networks, Amazon and Google are refused. Not charged on bad input, 404, blocked URL, robots disallow, unsupported content type or upstream failure. No API key.

GET https://x402-toolbox.vercel.app/read?url=https%3A%2F%2Fexample.com&format=markdown
paramrequiredmeaning
urlyesPublic http(s) page URL
formatnomarkdown (default) or text
maxCharsnoCut the content at this many characters (default 20000, max 100000)
Example response
{
  "url": "https://example.com",
  "finalUrl": "https://example.com/",
  "status": 200,
  "title": "Example Domain",
  "description": null,
  "canonical": null,
  "lang": "en",
  "image": null,
  "content": "This domain is for use in documentation examples without needing permission. This is not a service; avoid relying on it for testing and monitoring purposes.",
  "contentChars": 156,
  "truncated": false,
  "wordCount": 25,
  "links": 0,
  "fetchedAt": "2026-11-20T23:36:23.442Z"
}

Not charged: 400 bad input, 404 page not found at the source, 422 URL blocked, robots.txt disallows it, or content type not supported, 502 the page could not be fetched.

GET /weather: Current weather and a 3-day forecast for a place name or latitude and longitude

$0.001 per call

Current conditions (temperature, humidity, wind, cloud, pressure, rain next hour) and a 3-day daily forecast for a place name or lat/lon anywhere. Metric or imperial units. Data from MET Norway, geocoding from OpenStreetMap. Not charged on bad input, unknown place or upstream failure. No API key.

GET https://x402-toolbox.vercel.app/weather?place=Cincinnati&units=imperial
paramrequiredmeaning
placenoPlace name, e.g. "Cincinnati, OH" (use this or lat and lon)
latnoLatitude -90 to 90
lonnoLongitude -180 to 180
unitsnometric (default) or imperial
Example response
{
  "location": {
    "lat": 39.1013,
    "lon": -84.5127,
    "name": "Cincinnati, Hamilton County, Ohio, United States",
    "elevation": 150
  },
  "current": {
    "time": "2026-11-20T23:00:00Z",
    "temperature": 55.4,
    "humidity": 70.4,
    "windSpeed": 5.4,
    "windDirection": 111.2,
    "cloudCover": 0,
    "pressure": 1025.2,
    "precipitationNextHour": 0,
    "symbol": "clearsky_night"
  },
  "daily": [
    {
      "date": "2026-11-20",
      "tempMin": 55.4,
      "tempMax": 55.4,
      "precipitation": 0,
      "symbol": "clearsky_night"
    },
    {
      "date": "2026-11-21",
      "tempMin": 40.5,
      "tempMax": 64.8,
      "precipitation": 0,
      "symbol": "clearsky_night"
    },
    {
      "date": "2026-11-22",
      "tempMin": 42.6,
      "tempMax": 66.2,
      "precipitation": 0,
      "symbol": "partlycloudy_night"
    }
  ],
  "units": {
    "temperature": "F",
    "windSpeed": "mph",
    "precipitation": "in",
    "pressure": "hPa",
    "humidity": "%",
    "cloudCover": "%",
    "windDirection": "degrees",
    "elevation": "m"
  },
  "updatedAt": "2026-11-20T23:21:42Z",
  "attribution": "Weather data from MET Norway (CC BY 4.0); place names from OpenStreetMap Nominatim (ODbL)"
}

Not charged: 400 bad input, 404 place not found, 502 weather or geocoding upstream failed.

GET /fx: Latest or historic ECB reference exchange rates with optional amount conversion

$0.001 per call

European Central Bank reference rates: latest or any date since 1999-01-04, any base, optional symbols list and amount to convert. About 30 currencies, published once per working day. Returns the publication date actually used. Not charged on bad input, no data for the date, or upstream failure. No API key.

GET https://x402-toolbox.vercel.app/fx?base=USD&symbols=EUR%2CJPY&amount=100
paramrequiredmeaning
basenoBase currency code (default USD)
symbolsnoComma list of target codes, e.g. EUR,JPY (default all)
amountnoAmount of the base currency to convert
datenoYYYY-MM-DD, 1999-01-04 or later (default latest)
Example response
{
  "base": "USD",
  "date": "2026-11-20",
  "requestedDate": null,
  "rates": {
    "EUR": 0.90992,
    "JPY": 158.64
  },
  "amount": 100,
  "converted": {
    "EUR": 90.992,
    "JPY": 15864
  },
  "source": "European Central Bank reference rates via Frankfurter",
  "note": "ECB publishes once per working day around 16:00 CET"
}

Not charged: 400 bad input or unsupported currency, 404 no rates for that date, 502 rate source failed.

Payment details

networkeip155:8453 (Base mainnet)
assetUSDC
pay to0x2a15C6A98324e179dD9adf87bDD59F9C77f19d12
schemeexact, x402 v2, Coinbase CDP facilitator