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.
| endpoint | what it answers | price |
|---|---|---|
GET /block | Latest block and its age on five EVM chains | $0.001 per call |
GET /gas | Gas tiers and transfer cost in USD on five EVM chains, cheapest first | $0.001 per call |
GET /nft/tokens | Token ids an address holds in one ERC-721 collection | $0.002 per call |
GET /nft/metadata | Resolved metadata JSON, image and attributes for any ERC-721 or ERC-1155 token | $0.002 per call |
GET /nft/owner | Current owner of an ERC-721 token | $0.001 per call |
GET /nft/balance | ERC-1155 balances of an address for up to 50 token ids | $0.001 per call |
GET /price | Live Chainlink oracle prices for up to 20 crypto assets in USD | $0.001 per call |
GET /read | Fetch a public web page and return clean markdown or plain text with its title and metadata | $0.001 per call |
GET /weather | Current weather and a 3-day forecast for a place name or latitude and longitude | $0.001 per call |
GET /fx | Latest 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
| param | required | meaning |
|---|---|---|
chains | no | Comma 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
| param | required | meaning |
|---|---|---|
chains | no | Comma 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
| param | required | meaning |
|---|---|---|
owner | yes | Wallet address to list holdings for |
contract | yes | ERC-721 collection contract address |
chain | no | One chain, any of: base,ethereum,arbitrum,optimism,polygon. Default: ethereum. |
limit | no | Max 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
| param | required | meaning |
|---|---|---|
contract | yes | NFT contract address |
tokenId | yes | Token id, decimal or 0x hex |
chain | no | One 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
| param | required | meaning |
|---|---|---|
contract | yes | ERC-721 contract address |
tokenId | yes | Token id, decimal or 0x hex |
chain | no | One 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
| param | required | meaning |
|---|---|---|
owner | yes | Wallet address to read |
contract | yes | ERC-1155 contract address |
ids | yes | Comma list of 1-50 token ids, decimal or 0x hex |
chain | no | One 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
| param | required | meaning |
|---|---|---|
symbols | yes | Comma 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 |
quote | no | Quote 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
| param | required | meaning |
|---|---|---|
url | yes | Public http(s) page URL |
format | no | markdown (default) or text |
maxChars | no | Cut 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
| param | required | meaning |
|---|---|---|
place | no | Place name, e.g. "Cincinnati, OH" (use this or lat and lon) |
lat | no | Latitude -90 to 90 |
lon | no | Longitude -180 to 180 |
units | no | metric (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
| param | required | meaning |
|---|---|---|
base | no | Base currency code (default USD) |
symbols | no | Comma list of target codes, e.g. EUR,JPY (default all) |
amount | no | Amount of the base currency to convert |
date | no | YYYY-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
| network | eip155:8453 (Base mainnet) |
| asset | USDC |
| pay to | 0x2a15C6A98324e179dD9adf87bDD59F9C77f19d12 |
| scheme | exact, x402 v2, Coinbase CDP facilitator |