{"uid":"cap_TdtNjIK6cIztsYLS5o5Yp","slug":"x402-zip-code-geolocation-lookup-e60a4beb","name":"x402 ZIP Code Geolocation Lookup","description":"66 pay-per-call APIs: AI text/image generation ($0.01), Polymarket odds, crypto prices, DeFi yields, FX rates, weather, IP/geo, FBI wanted, SEC tickers, clinical trials, 250M academic papers, Stack Overflow, meme-coin launchpads (pump.fun, Clanker, Four.meme, SunPump), tokenized stocks, Solana top 100, and 40+ more. $0.005/call standard. USDC on Base and Solana via x402.","url":"https://workspace-x402-paywall.onrender.com/geo/zip?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["country","code"],"properties":{"code":{"type":"string","description":"Requires a postal code string, e.g. 90210"},"country":{"type":"string","description":"Requires a 2-letter ISO country code string, e.g. us"}}}},"additionalProperties":false}}},"responseSchema":{"type":"object"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tvulvnPdsjqsV9cQ4YX00","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns geographic data (city, state, coordinates, etc.) for a given ZIP/postal code and country, paid per-call via USDC on Base or Solana.","exampleAgentPrompt":"What city and state does ZIP code 90210 belong to in the US?","exampleUseCases":[{"title":"Validate customer shipping address ZIP","prompt":"I have a customer ZIP code 10001 — can you tell me what city and state that corresponds to in the US so I can verify the shipping address?"},{"title":"Enrich user profile with location","prompt":"A user signed up with ZIP code 60614 in the US — look up the city, state, and coordinates so I can fill in their location profile."},{"title":"Resolve postal code for Canadian address","prompt":"Can you look up what city and region the Canadian postal code M5V belongs to?"}],"resultDescription":"A JSON object containing geographic information for the given ZIP/postal code, potentially including city name, state or region, country, latitude, longitude, and timezone — with optional field filtering via the fields parameter.","failureModes":["Invalid or nonexistent ZIP code returns error or empty result","Unsupported country code returns no data","Missing required parameters (code or country) returns 400-style error","Payment failure (insufficient USDC balance) blocks the call with 402 response","Network timeout from Render hosting during high load"],"whenToPreferThis":"Choose this endpoint when you need a quick, cheap ($0.005 USDC) pay-per-call ZIP/postal code to location lookup without a subscription, especially in an agent or micro-workflow context that already handles x402 USDC payments on Base or Solana. Prefer it over free geocoding APIs when you need no API key management and want metered, on-demand access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:40:59.986Z","isFirstParty":false,"canonicalSlug":"x402-zip-code-geolocation-lookup-e60a4beb"}