{"version":1,"name":"Agent Data Desk","resources":["https://x402-seller.zshnfaizal.workers.dev/v1/weather","https://x402-seller.zshnfaizal.workers.dev/v1/defi/yields","https://x402-seller.zshnfaizal.workers.dev/v1/token/balance","https://x402-seller.zshnfaizal.workers.dev/v1/markdown"],"instructions":"# Agent Data Desk\n\n> Pay-per-call data APIs for AI agents. USDC on Base mainnet via the x402 protocol (v2). No API keys, no signup, no rate-limit tiers: each request is paid on the wire.\n\n## Endpoints (all GET, all paid per call)\n\n- `GET /v1/weather?city=Chicago` — $0.005 — Current weather, next-24h forecast summary and air quality for any city or lat/lon\n  - `city`: City name, e.g. Chicago or 'Paris, FR'. Required unless lat+lon are given.\n  - `lat`: Latitude (-90..90). Use with lon instead of city.\n  - `lon`: Longitude (-180..180). Use with lat instead of city.\n  - `units`: Primary unit system for the compact fields. Both C and F are always included for temperature. One of: metric, imperial.\n- `GET /v1/defi/yields?chain=base&min_tvl=1000000&limit=5` — $0.002 — Top DeFi yield pools by APY, filtered by chain and minimum TVL (DefiLlama)\n  - `chain`: Chain name as used by DefiLlama (case-insensitive): base, ethereum, arbitrum, optimism, polygon, bsc, solana, avalanche... Omit for all chains.\n  - `min_tvl`: Minimum pool TVL in USD. Default 100000 with a chain, 1000000 without.\n  - `limit`: Max pools to return (1-100).\n  - `project`: Only pools from this DefiLlama project slug, e.g. aave-v3, morpho-blue.\n  - `symbol`: Only pools whose symbol contains this text, e.g. USDC.\n  - `stablecoin`: true = only pools DefiLlama flags as stablecoin pools.\n  - `max_apy`: Drop pools with APY above this percent (outlier guard). Default 1000; 0 disables.\n- `GET /v1/token/balance?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&token=usdc&chain=base` — $0.002 — Native ETH or ERC-20 balance for an address on Base or Ethereum\n  - `address`: 0x-prefixed 20-byte address to query.\n  - `token`: 'eth' for native balance, an alias (usdc, usdt, dai, weth, cbbtc) or a 0x contract address.\n  - `chain`: undefined One of: base, ethereum.\n- `GET /v1/markdown?url=https%3A%2F%2Fexample.com` — $0.01 — Fetch a public web page and return it as clean, LLM-ready markdown\n  - `url`: Absolute http(s) URL of a public page.\n  - `format`: json = {url, final_url, title, markdown, truncated}; md = raw text/markdown body. One of: json, md.\n\n## How to pay\n\nx402 protocol v2, scheme \"exact\" on Base mainnet (eip155:8453), asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (6 decimals), payTo 0x42095BE171140E9F4d03Fdf4dc079844C959FCf4.\n1) GET the endpoint with no payment -> HTTP 402 with a base64 JSON \"PAYMENT-REQUIRED\" header (the JSON body mirrors it and adds _agent_hint).\n2) Sign an EIP-3009 transferWithAuthorization for the quoted \"amount\" to \"payTo\" (no gas, no ETH needed) and retry with the \"PAYMENT-SIGNATURE\" header (base64 JSON payment payload).\n3) Receive HTTP 200 + the data + a \"PAYMENT-RESPONSE\" header with the settlement receipt (tx hash). Failed handlers (4xx/5xx) are never charged.\nAny x402 v2 client works: @x402/fetch (TypeScript), x402 (Python), or the Coinbase AgentKit / Bazaar clients.\n\n## Machine-readable\n\n- OpenAPI (x-payment-info): https://x402-seller.zshnfaizal.workers.dev/openapi.json\n- x402 manifest: https://x402-seller.zshnfaizal.workers.dev/.well-known/x402\n- Health: https://x402-seller.zshnfaizal.workers.dev/healthz\n\n## Notes\n\n- Errors (4xx/5xx) are never settled; only 200 responses are charged.\n- Weather/air quality from Open-Meteo, yields from DefiLlama, balances from public JSON-RPC, markdown from a server-side fetch of the page. Upstream data is passed through with light shaping; verify before acting on it.\n","x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x42095BE171140E9F4d03Fdf4dc079844C959FCf4","facilitator":"https://facilitator.payai.network"},"openapi":"https://x402-seller.zshnfaizal.workers.dev/openapi.json","llms":"https://x402-seller.zshnfaizal.workers.dev/llms.txt"}