Global weather forecast
$0.003 USDCUse one selected place candidate's coordinates for a separately authorized current global forecast.
Review and run this separate callGlobal place geocode
Resolve one global city or locality name into bounded, population-ranked GeoNames coordinates, country and first-level-region identity, population, timezone, feature code, and source freshness without a request-time network call.
$0.002 USDCBasex402 v2POST
Endpoint
https://apiacre.com/v1/data/place-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.002 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/place-geocode \
-X POST \
-d '{"place":"London, GB","limit":5}' \
--max-amount 2000 \
--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/place-geocode
npx --yes agentcash@latest fetch https://apiacre.com/v1/data/place-geocode \
--method POST \
--header 'content-type: application/json' \
--body '{"place":"London, GB","limit":5}' \
--payment-protocol x402 \
--payment-network base \
--max-amount 0.002Input example
{
"place": "London, GB",
"limit": 5
}Response shape
{
"request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
"service": "data.place-geocode",
"version": "1",
"data": {
"version": "apiacre-place-geocode/1",
"query": {
"place": "London, GB",
"normalized": "london, gb",
"limit": 5
},
"candidateCount": 2,
"candidateCountCapped": false,
"ambiguous": true,
"resultsTruncated": false,
"results": [
{
"rank": 1,
"geonameId": 2643743,
"name": "London",
"matchedNameType": "primary",
"country": {
"code": "GB",
"name": "United Kingdom",
"iso3": "GBR",
"continentCode": "EU"
},
"admin1": {
"code": "ENG",
"name": "England"
},
"coordinates": {
"latitude": 51.50853,
"longitude": -0.12574
},
"population": 8961989,
"timezone": "Europe/London",
"featureCode": "PPLC",
"modifiedOn": "2026-08-17"
},
{
"rank": 2,
"geonameId": 2643741,
"name": "City of London",
"matchedNameType": "alternate",
"country": {
"code": "GB",
"name": "United Kingdom",
"iso3": "GBR",
"continentCode": "EU"
},
"admin1": {
"code": "ENG",
"name": "England"
},
"coordinates": {
"latitude": 51.51279,
"longitude": -0.09184
},
"population": 8072,
"timezone": "Europe/London",
"featureCode": "PPLA3",
"modifiedOn": "2021-02-17"
}
],
"source": {
"provider": "GeoNames",
"dataset": "GeoNames cities500",
"snapshotBuiltOn": "2026-08-18",
"placeRecords": 235408,
"aliasRecords": 766415,
"homeUrl": "https://www.geonames.org/",
"downloadUrl": "https://download.geonames.org/export/dump/",
"license": "CC BY 4.0",
"licenseUrl": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "GeoNames (CC BY 4.0; https://www.geonames.org/).",
"transformation": "API Acre normalizes exact names and qualifiers, then ranks matches by alias quality, population, and stable GeoName ID.",
"networkRequestsMade": 0
},
"limitations": [
"Coverage follows the GeoNames cities500 extract: populated places above 500 residents and administrative seats through PPLA4, subject to source completeness and accuracy.",
"Matching is exact after Unicode-to-ASCII normalization; this endpoint does not perform fuzzy matching, street-address geocoding, point-of-interest search, parcel lookup, or routing.",
"Unqualified names can be ambiguous. Review country, first-level region, GeoName ID, and coordinates before using a candidate.",
"Population-based ranking is a selection aid, not proof that the first candidate is the caller's intended place.",
"Results use the bundled 2026-08-18 snapshot and can differ from newer GeoNames records."
]
},
"meta": {
"duration_ms": 42,
"cached": false,
"sources": [],
"warnings": [],
"next_actions": [
{
"service": "data.us-weather-forecast",
"title": "Global weather forecast",
"reason": "Use one selected place candidate's coordinates for a separately authorized current global forecast.",
"method": "POST",
"path": "/v1/data/us-weather-forecast",
"price": "$0.003",
"input_template": {
"latitude": "$result.data.results[0].coordinates.latitude",
"longitude": "$result.data.results[0].coordinates.longitude",
"forecast_type": "day_night",
"units": "auto",
"periods": 6,
"include_current_conditions": false,
"include_active_alerts": false
},
"use_output": "Run only after confirming the intended country and region candidate. The forecast is a separate paid request and current weather-source coverage can vary by coordinates.",
"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/place-geocode' \
-H 'content-type: application/json' \
--data '{"place":"London, GB","limit":5}'