US weather forecast
$0.003 USDCUse the selected Census coordinates for a separately authorized current NWS forecast, with optional current conditions and active point alerts.
Review and run this separate callUS address geocode
Geocode one structural address in the United States, Puerto Rico, or U.S. Island Areas with normalized U.S. Census MAF/TIGER coordinates, optional bounded state/county/tract/block/congressional geography, exact source attribution, and explicit range-interpolation limits.
$0.005 USDCBasex402 v2POST
Endpoint
https://apiacre.com/v1/data/us-address-geocodeSend the JSON body below. An unpaid request returns HTTP 402 with a PAYMENT-REQUIRED header; an x402-compatible buyer signs the requirement and retries with PAYMENT-SIGNATURE.
Official Coinbase agent path
Coinbase Agentic Wallet can satisfy this x402 request in one command. Running it may pay automatically, so --max-amount is fixed to $0.005 USDC in atomic units. Copying the command does not install, authenticate, sign, or pay; review the request and use a separate low-value wallet before running it.
npx --yes awal@latest x402 pay https://apiacre.com/v1/data/us-address-geocode \
-X POST \
-d '{"address":"4600 Silver Hill Rd, Washington, DC 20233","include_geographies":true}' \
--max-amount 5000 \
--jsonCoinbase pay-for-service documentation · Buyer setup and wallet safety
Alternative third-party AgentCash commands
Run check first without payment. Its fetch command may automatically pay up to the exact listed price.
npx --yes agentcash@latest check https://apiacre.com/v1/data/us-address-geocode
npx --yes agentcash@latest fetch https://apiacre.com/v1/data/us-address-geocode \
--method POST \
--header 'content-type: application/json' \
--body '{"address":"4600 Silver Hill Rd, Washington, DC 20233","include_geographies":true}' \
--payment-protocol x402 \
--payment-network base \
--max-amount 0.005Input example
{
"address": "4600 Silver Hill Rd, Washington, DC 20233",
"include_geographies": true
}Response shape
{
"request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
"service": "data.us-address-geocode",
"version": "1",
"data": {
"query": {
"address": "4600 Silver Hill Rd, Washington, DC 20233",
"includeGeographies": true
},
"matched": true,
"matchCount": 1,
"ambiguous": false,
"matchesTruncated": false,
"matches": [
{
"matchedAddress": "4600 SILVER HILL RD, WASHINGTON, DC, 20233",
"coordinates": {
"longitude": -76.928365658124,
"latitude": 38.845053106269
},
"tigerLine": {
"id": "657091557",
"side": "L"
},
"addressComponents": {
"fromAddress": "4600",
"toAddress": "4700",
"preQualifier": null,
"preDirection": null,
"preType": null,
"streetName": "SILVER HILL",
"suffixType": "RD",
"suffixDirection": null,
"suffixQualifier": null,
"city": "WASHINGTON",
"state": "DC",
"zip": "20233"
},
"geographies": {
"requested": true,
"available": true,
"state": {
"kind": "state",
"name": "Maryland",
"geoid": "24",
"code": "24",
"abbreviation": "MD",
"session": null
},
"county": {
"kind": "county",
"name": "Prince George's County",
"geoid": "24033",
"code": "033",
"abbreviation": null,
"session": null
},
"tract": {
"kind": "census_tract",
"name": "Census Tract 8024.05",
"geoid": "24033802405",
"code": "802405",
"abbreviation": null,
"session": null
},
"block": {
"kind": "census_block",
"name": "Block 2004",
"geoid": "240338024052004",
"code": "2004",
"abbreviation": null,
"session": null
},
"congressionalDistrict": {
"kind": "congressional_district",
"name": "Congressional District 4",
"geoid": "2404",
"code": "4",
"abbreviation": null,
"session": "119"
}
}
}
],
"benchmark": {
"id": "4",
"name": "Public_AR_Current",
"description": "Public Address Ranges - Current Benchmark",
"isDefault": true
},
"vintage": {
"id": "4",
"name": "Current_Current",
"description": "Current Vintage - Current Benchmark",
"isDefault": true
},
"source": {
"provider": "U.S. Census Bureau",
"dataset": "Census Geocoding Services using MAF/TIGER address ranges",
"endpointUrl": "https://geocoding.geo.census.gov/geocoder/geographies/onelineaddress",
"documentationUrl": "https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html",
"termsUrl": "https://www.census.gov/data/developers/about/terms-of-service.html",
"attribution": "This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.",
"transformation": "API Acre selected and normalized bounded address, coordinate, TIGER-line, and requested geography fields without modifying their meaning."
},
"retrievedAt": "2026-08-18T05:35:00+00:00",
"limitations": [
"Coordinates are calculated along a MAF/TIGER address range; they are not rooftop, parcel-boundary, or entrance coordinates.",
"Coverage is limited to structural addresses in the United States, Puerto Rico, and U.S. Island Areas.",
"No match does not prove that an address is nonexistent, current, occupied, or deliverable.",
"The caller-supplied address is sent to the Census Geocoder only for this lookup; do not use the result to identify or link Census respondents, people, households, businesses, or other entities.",
"Current benchmark and geography-vintage data can change, and upstream availability is not guaranteed."
]
},
"meta": {
"duration_ms": 42,
"cached": false,
"sources": [],
"warnings": [],
"next_actions": [
{
"service": "data.us-weather-forecast",
"title": "US weather forecast",
"reason": "Use the selected Census coordinates for a separately authorized current NWS forecast, with optional current conditions and active point alerts.",
"method": "POST",
"path": "/v1/data/us-weather-forecast",
"price": "$0.003",
"input_template": {
"latitude": "$result.data.matches[0].coordinates.latitude",
"longitude": "$result.data.matches[0].coordinates.longitude",
"forecast_type": "day_night",
"units": "us",
"periods": 6,
"include_current_conditions": true,
"include_active_alerts": true
},
"use_output": "Run only after confirming the intended address match. Census coordinates are address-range estimates and NWS point coverage may map them to a nearby forecast grid.",
"handoff_path": "/catalog/data.us-weather-forecast",
"checkout_path": "/try/data.us-weather-forecast",
"sample_path": "/samples/data.us-weather-forecast",
"maximum_atomic_usdc": "3000",
"handoff_payment_required": false,
"executes_automatically": false,
"authorization_required": true
}
]
}
}Continue this workflow
These optional follow-ups use this result in a larger workflow. Each call shows a fresh x402 challenge and requires separate buyer authorization.
Try the payment challenge
curl -i -X POST 'https://apiacre.com/v1/data/us-address-geocode' \
-H 'content-type: application/json' \
--data '{"address":"4600 Silver Hill Rd, Washington, DC 20233","include_geographies":true}'