US Geography
US ZIP code to place name, state and centroid; optionally verify it belongs to a state you expect.
OtherLiveeip155:8453Exactvia cdp
ZipPostalGeography
Calls · 30d
1
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 4 snapshots so far.
$24.31
Verified settled volume
1,175 settlements proven x402 by their on-chain EIP-3009 marker.
$0.020
Listed price
As published in the catalog. Always read the live 402 before paying.
1
Calls · 30d
Upstream's own call count for this endpoint, not ours.
1
Unique payers · 30d
Last called 2026-10-20 21:16Z
—
Upstream on-chain volume
Reported by the source catalog.
Paid to
0xb531320805C5BED1D46AEaDcF4F008FDF172DBDaThe wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.
Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Provider
The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.
Live 402 challenge
Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xb531320805C5BED1D46AEaDcF4F008FDF172DBDa",
"scheme": "exact",
"network": "base",
"mimeType": "application/json",
"resource": "https://geo-us.x402tookit.com/zip-lookup",
"description": "US ZIP code to place name, state and centroid; optionally verify it belongs to a state you expect.",
"outputSchema": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"zip": "90210",
"state": "CA"
}
},
"output": {
"zip": "90210",
"asOf": "2026-10-11T04:46:56.222Z",
"places": [
{
"place": "Beverly Hills",
"state": "California",
"latitude": 34.0901,
"longitude": -118.4065,
"stateAbbr": "CA"
}
],
"source": "Zippopotam.us",
"reasons": [],
"summary": "90210: Beverly Hills, CA; matches CA.",
"verdict": "STATE_MATCH",
"degraded": false,
"sourceUrl": "https://zippopotam.us",
"disclaimer": "Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting.",
"notChecked": [
"ZIP boundaries (a ZIP is a mail route, not an area; centroids are approximate)",
"PO-box-only and unique-organization ZIPs may be missing",
"…1 more"
],
"expectedState": "CA",
"matchesExpectedState": true
}
},
"maxAmountRequired": "20000",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BFK9TLC3edb13K6v4YyH3DwPb5DSUpkWvb7XnqCL9b4F"
},
"payTo": "DUPiupXtuox38dcGoXUKer5mAydCzmaHjrbQ66qeEm8s",
"scheme": "exact",
"network": "solana",
"mimeType": "application/json",
"resource": "https://geo-us.x402tookit.com/zip-lookup",
"description": "US ZIP code to place name, state and centroid; optionally verify it belongs to a state you expect.",
"outputSchema": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"zip": "90210",
"state": "CA"
}
},
"output": {
"zip": "90210",
"asOf": "2026-10-11T04:46:56.222Z",
"places": [
{
"place": "Beverly Hills",
"state": "California",
"latitude": 34.0901,
"longitude": -118.4065,
"stateAbbr": "CA"
}
],
"source": "Zippopotam.us",
"reasons": [],
"summary": "90210: Beverly Hills, CA; matches CA.",
"verdict": "STATE_MATCH",
"degraded": false,
"sourceUrl": "https://zippopotam.us",
"disclaimer": "Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting.",
"notChecked": [
"ZIP boundaries (a ZIP is a mail route, not an area; centroids are approximate)",
"PO-box-only and unique-organization ZIPs may be missing",
"…1 more"
],
"expectedState": "CA",
"matchesExpectedState": true
}
},
"maxAmountRequired": "20000",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xb531320805C5BED1D46AEaDcF4F008FDF172DBDa",
"scheme": "exact",
"network": "polygon",
"mimeType": "application/json",
"resource": "https://geo-us.x402tookit.com/zip-lookup",
"description": "US ZIP code to place name, state and centroid; optionally verify it belongs to a state you expect.",
"outputSchema": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"zip": "90210",
"state": "CA"
}
},
"output": {
"zip": "90210",
"asOf": "2026-10-11T04:46:56.222Z",
"places": [
{
"place": "Beverly Hills",
"state": "California",
"latitude": 34.0901,
"longitude": -118.4065,
"stateAbbr": "CA"
}
],
"source": "Zippopotam.us",
"reasons": [],
"summary": "90210: Beverly Hills, CA; matches CA.",
"verdict": "STATE_MATCH",
"degraded": false,
"sourceUrl": "https://zippopotam.us",
"disclaimer": "Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting.",
"notChecked": [
"ZIP boundaries (a ZIP is a mail route, not an area; centroids are approximate)",
"PO-box-only and unique-organization ZIPs may be missing",
"…1 more"
],
"expectedState": "CA",
"matchesExpectedState": true
}
},
"maxAmountRequired": "20000",
"maxTimeoutSeconds": 300
}
],
"x402Version": 1,
"alsoAvailable": {
"llms": "https://geo-us.x402tookit.com/llms.txt",
"catalog": "https://geo-us.x402tookit.com/catalog",
"message": "US Geography has 8 pay-per-call endpoints (Geocode US addresses, reverse geocode, districts, metro areas, ZIP lookup, state FIPS and GEOID parsing.), from $0.02 a call. See the full menu and send your agents our way.",
"openapi": "https://geo-us.x402tookit.com/openapi.json",
"related": [
{
"url": "https://geo-us.x402tookit.com/coord-distance",
"path": "/coord-distance",
"what": "Great-circle (haversine) distance between two coordinates in km, miles and nautical miles…",
"price": "$0.02"
},
{
"url": "https://geo-us.x402tookit.com/geocode-address",
"path": "/geocode-address",
"what": "Geocode a US street address: normalized address, latitude and longitude, state, county an…",
"price": "$0.02"
},
{
"url": "https://geo-us.x402tookit.com/geoid-parse",
"path": "/geoid-parse",
"what": "Parse a Census GEOID into state, county, tract, block group and block codes and name its…",
"price": "$0.02"
}
]
}
}Accepts
The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.
0.02USDC≈ $0.02 USD
on Base · exact scheme
Pay 0.02 USDC on Base to 0xb531…2DBDa. The signed payment is good for 5 minutes.
- Paid to
- 0xb531…2DBDa
- USD Coin contract
- 0x8335…02913
- Payment window
- 5 minutes
- As published
- 20000 smallest units
20000units
on solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · exact scheme
That figure is in the token’s smallest units. Roundhouse does not hold this contract’s decimals, so it is shown as published rather than converted.
- Paid to
- DUPiup…eEm8s
- Token contract
- EPjFWd…TDt1v
- Payment window
- 5 minutes
20000units
on Polygon · exact scheme
That figure is in the token’s smallest units. Roundhouse does not hold this contract’s decimals, so it is shown as published rather than converted.
- Paid to
- 0xb531…2DBDa
- Token contract
- 0x3c49…c3359
- Payment window
- 5 minutes
20000units
on Arbitrum · exact scheme
That figure is in the token’s smallest units. Roundhouse does not hold this contract’s decimals, so it is shown as published rather than converted.
- Paid to
- 0xb531…2DBDa
- Token contract
- 0xaf88…e5831
- Payment window
- 5 minutes
The catalog’s raw entry
[
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xb531320805C5BED1D46AEaDcF4F008FDF172DBDa",
"amount": "20000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BFK9TLC3edb13K6v4YyH3DwPb5DSUpkWvb7XnqCL9b4F"
},
"payTo": "DUPiupXtuox38dcGoXUKer5mAydCzmaHjrbQ66qeEm8s",
"amount": "20000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xb531320805C5BED1D46AEaDcF4F008FDF172DBDa",
"amount": "20000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
{
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xb531320805C5BED1D46AEaDcF4F008FDF172DBDa",
"amount": "20000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
}
]Extensions
{
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"zip": "90210",
"state": "CA"
}
},
"output": {
"type": "json",
"example": {
"zip": "90210",
"asOf": "2026-10-11T04:46:56.222Z",
"places": [
{
"place": "Beverly Hills",
"state": "California",
"latitude": 34.0901,
"longitude": -118.4065,
"stateAbbr": "CA"
}
],
"source": "Zippopotam.us",
"reasons": [],
"summary": "90210: Beverly Hills, CA; matches CA.",
"verdict": "STATE_MATCH",
"degraded": false,
"sourceUrl": "https://zippopotam.us",
"disclaimer": "Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting.",
"notChecked": [
"ZIP boundaries (a ZIP is a mail route, not an area; centroids are approximate)",
"PO-box-only and unique-organization ZIPs may be missing",
"…1 more"
],
"expectedState": "CA",
"matchesExpectedState": true
}
}
},
"schema": {
"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": [
"zip"
],
"properties": {
"zip": {
"type": "string",
"description": "5-digit US ZIP code"
},
"state": {
"type": "string",
"description": "Optional state (abbreviation or name) to verify against"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"properties": {
"zip": {
"type": [
"null",
"string"
]
},
"asOf": {
"type": [
"null",
"string"
]
},
"places": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"place": {
"type": [
"null",
"string"
]
},
"state": {
"type": [
"null",
"string"
]
},
"latitude": {
"type": [
"null",
"number"
]
},
"longitude": {
"type": [
"null",
"number"
]
},
"stateAbbr": {
"type": [
"null",
"string"
]
}
}
}
},
"source": {
"type": [
"null",
"string"
]
},
"reasons": {
"type": [
"array",
"null"
]
},
"summary": {
"type": [
"null",
"string"
]
},
"verdict": {
"type": [
"null",
"string"
]
},
"degraded": {
"type": [
"boolean",
"null"
]
},
"sourceUrl": {
"type": [
"null",
"string"
]
},
"disclaimer": {
"type": [
"null",
"string"
]
},
"notChecked": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"expectedState": {
"type": [
"null",
"string"
]
},
"matchesExpectedState": {
"type": [
"boolean",
"null"
]
}
}
}
}
}
}
}
}
}Provenance
- Seen in the source catalog
- 2026-10-20 21:16Z
- Last indexed by Roundhouse
- 2026-10-22 19:30Z
- Last enriched (probe, favicon, geo)
- 2026-10-20 21:45Z
- x402 version
- 2
- Max timeout
- 300s
- Liveness probe
- HTTP 402
Hand this page to an agent
Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.
GET api.roundhouseai.io/v0/endpoints
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 4 snapshots so far. Verified volume counts only settlements with an on-chain EIP-3009 marker.
Show the promptHide the prompt
Using Roundhouse, look up the x402 service US Geography and tell me whether it is worth paying: what a call costs, whether the endpoint answered when last probed, and what its payment record actually shows. curl -s 'https://api.roundhouseai.io/v0/endpoints?q=US%20Geography' curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>' Then call it: read the price from the live 402 at https://geo-us.x402tookit.com/zip-lookup, never from a cached figure, and pay with an x402 client. The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except /v0/unified* and /v0/endpoints. Either pay over x402 (mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402), or ask me for an organization key, which I create at https://roundhouseai.io/dashboard/connections. If you have neither, ask before going further. If you do not have Roundhouse tools or skills installed, read https://roundhouseai.io/skill.md first — it is the whole procedure.