{ "route": "geo-geocode", "title": "US address geocode (Census)", "method": "GET", "price_usdc": 0.005, "amount_atomic": "5000", "request": { "method": "GET", "url": "https://utility.agentexchange.work/v1/geo/geocode?address=1600%20Pennsylvania%20Ave%20NW%2C%20Washington%2C%20DC%2020500", "headers": { "PAYMENT-SIGNATURE": " (or X-PAYMENT for v1)" } }, "captured_at": "2026-10-01T00:24:53.812Z", "captured_from": "live upstream, on first request; refreshed after 24 h", "response_200": { "input_address": "1600 Pennsylvania Ave NW, Washington, DC 20500", "matched": true, "count": 1, "matches": [ { "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500", "lat": 38.898703, "lon": -77.035189, "components": { "zip": "20500", "streetName": "PENNSYLVANIA", "preType": "", "city": "WASHINGTON", "preDirection": "", "suffixDirection": "NW", "fromAddress": "1600", "state": "DC", "suffixType": "AVE", "toAddress": "1648", "suffixQualifier": "", "preQualifier": "" }, "tiger_line": { "side": "L", "tigerLineId": "76225813" }, "geographies": { "state": { "fips": "11", "abbr": "DC", "name": "District of Columbia" }, "county": { "fips": "11001", "county_fips": "001", "name": "District of Columbia" }, "tract": { "geoid": "11001980000", "tract": "980000", "name": "Census Tract 9800" }, "block_group": { "geoid": "110019800001", "block_group": "1" }, "block": { "geoid": "110019800001034", "block": "1034", "layer": "2020 Census Blocks" }, "place": { "geoid": "1150000", "name": "Washington city" }, "county_subdivision": { "geoid": "1100150000", "name": "Washington city" }, "congressional_district": { "geoid": "1198", "name": "Delegate District (at Large)", "layer": "120th Congressional Districts" }, "zcta": { "zcta5": "20006" }, "metro_area": { "cbsa": "47900", "name": "Washington-Arlington-Alexandria, DC-VA-MD-WV Metro Area" }, "school_district": { "geoid": "1100030", "name": "District of Columbia Public Schools" } } } ], "source": { "provider": "US Census Bureau Geocoder (geocoding.geo.census.gov)", "url": "https://geocoding.geo.census.gov/geocoder/geographies/onelineaddress?address=1600%20Pennsylvania%20Ave%20NW%2C%20Washington%2C%20DC%2020500&benchmark=Public_AR_Current&vintage=Current_Current&layers=all&format=json", "license": "public (US Government work); benchmark Public_AR_Current, vintage Current_Current" }, "fetched_at": "2026-10-01T00:24:53.805Z", "route": "geo-geocode", "price_usdc": 0.005, "payment": { "transaction": "0x… (settlement transaction hash)", "network": "eip155:8453", "payer": "0x… (payer address)" }, "request_id": "…" }, "response_402_without_payment": { "x402Version": 2, "error": "Payment required", "resource": { "url": "https://utility.agentexchange.work/v1/geo/geocode?address=1600%20Pennsylvania%20Ave%20NW%2C%20Washington%2C%20DC%2020500", "description": "Geocodes a US street address with the US Census Bureau Geocoder: returns the matched address, lat/lon and Census geographies (state and county FIPS, tract, block group, block, place, county subdivision, congressional district, ZCTA, metro area, school district). Call it when an agent needs coordinates or FIPS codes for a US address. A no-match answer (matched:false) is a valid, charged result; empty input is refused with 400 before payment.", "mimeType": "application/json", "serviceName": "US address geocoder", "tags": [ "geocoding", "address", "census", "fips", "geo" ], "iconUrl": "https://utility.agentexchange.work/icon.png" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "5000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0xc91cE6291eDC0713ec753BAFBA002506ffb2b95c", "maxTimeoutSeconds": 300, "extra": { "name": "USD Coin", "version": "2" } } ], "extensions": { "bazaar": { "info": { "input": { "type": "http", "method": "GET", "queryParams": { "address": "1600 Pennsylvania Ave NW, Washington, DC 20500" } }, "output": { "type": "json", "example": { "input_address": "1600 Pennsylvania Ave NW, Washington, DC 20500", "matched": true, "count": 1, "matches": [ { "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500", "lat": 38.898703, "lon": -77.035189, "components": { "zip": "20500", "streetName": "PENNSYLVANIA", "city": "WASHINGTON", "state": "DC", "suffixType": "AVE", "suffixDirection": "NW", "fromAddress": "1600", "toAddress": "1648" }, "tiger_line": { "side": "L", "tigerLineId": "76225813" }, "geographies": { "state": { "fips": "11", "abbr": "DC", "name": "District of Columbia" }, "county": { "fips": "11001", "county_fips": "001", "name": "District of Columbia" }, "tract": { "geoid": "11001980000", "tract": "980000", "name": "Census Tract 9800" }, "block_group": { "geoid": "110019800001", "block_group": "1" }, "block": { "geoid": "110019800001034", "block": "1034", "layer": "2020 Census Blocks" }, "place": { "geoid": "1150000", "name": "Washington city" }, "county_subdivision": { "geoid": "1100150000", "name": "Washington city" }, "congressional_district": { "geoid": "1198", "name": "Delegate District (at Large)", "layer": "120th Congressional Districts" }, "zcta": { "zcta5": "20006" }, "metro_area": { "cbsa": "47900", "name": "Washington-Arlington-Alexandria, DC-VA-MD-WV Metro Area" }, "school_district": { "geoid": "1100030", "name": "District of Columbia Public Schools" } } } ], "source": { "provider": "US Census Bureau Geocoder (geocoding.geo.census.gov)", "url": "https://geocoding.geo.census.gov/geocoder/geographies/onelineaddress?address=...", "license": "public (US Government work); benchmark Public_AR_Current, vintage Current_Current" }, "fetched_at": "2026-10-01T00:12:05.000Z" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "GET", "HEAD" ] }, "queryParams": { "type": "object", "properties": { "address": { "type": "string", "minLength": 5, "maxLength": 200, "description": "one-line US street address: number, street, city, state and/or ZIP" } }, "required": [ "address" ] } }, "required": [ "type", "method" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object", "properties": { "input_address": { "type": "string" }, "matched": { "type": "boolean" }, "count": { "type": "integer" }, "matches": { "type": "array", "items": { "type": "object", "properties": { "matched_address": { "type": "string" }, "lat": { "type": "number" }, "lon": { "type": "number" }, "components": { "type": "object", "properties": { "zip": { "type": "string" }, "streetName": { "type": "string" }, "city": { "type": "string" }, "state": { "type": "string" }, "suffixType": { "type": "string" }, "suffixDirection": { "type": "string" }, "fromAddress": { "type": "string" }, "toAddress": { "type": "string" } } }, "tiger_line": { "type": "object", "properties": { "side": { "type": "string" }, "tigerLineId": { "type": "string" } } }, "geographies": { "type": "object", "properties": { "state": { "type": "object" }, "county": { "type": "object" }, "tract": { "type": "object" }, "block_group": { "type": "object" }, "block": { "type": "object" }, "place": { "type": "object" }, "county_subdivision": { "type": "object" }, "congressional_district": { "type": "object" }, "zcta": { "type": "object" }, "metro_area": { "type": "object" }, "school_district": { "type": "object" } } } } } }, "source": { "type": "object", "properties": { "provider": { "type": "string" }, "url": { "type": "string" }, "license": { "type": "string" } } }, "fetched_at": { "type": "string" } } } }, "required": [ "type" ] } }, "required": [ "input" ] } } }, "message": "Pay $0.005 USDC on Base and retry with PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1).", "price": "$0.005", "price_usdc": 0.005, "amount_atomic": "5000", "input_example": "https://utility.agentexchange.work/v1/geo/geocode?address=1600%20Pennsylvania%20Ave%20NW%2C%20Washington%2C%20DC%2020500", "docs": { "openapi": "https://utility.agentexchange.work/openapi.json", "llms": "https://utility.agentexchange.work/llms.txt", "sample": "https://utility.agentexchange.work/samples/geo-geocode.json", "terms": "https://utility.agentexchange.work/terms" } }, "docs": "https://utility.agentexchange.work/llms.txt" }