Global weather forecast
$0.003 USDCUse the queried coordinates for a separately authorized current global forecast.
Review and run this separate callGlobal reverse geocode
Resolve one latitude/longitude pair into bounded, great-circle-distance-ranked nearby GeoNames populated places with country, first-level region, population, timezone, feature code, and source freshness without a request-time network call.
$0.002 USDCBasex402 v2POST
Endpoint
https://apiacre.com/v1/data/reverse-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/reverse-geocode \
-X POST \
-d '{"latitude":51.5074,"longitude":-0.1278,"radius_km":10,"limit":3}' \
--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/reverse-geocode
npx --yes agentcash@latest fetch https://apiacre.com/v1/data/reverse-geocode \
--method POST \
--header 'content-type: application/json' \
--body '{"latitude":51.5074,"longitude":-0.1278,"radius_km":10,"limit":3}' \
--payment-protocol x402 \
--payment-network base \
--max-amount 0.002Input example
{
"latitude": 51.5074,
"longitude": -0.1278,
"radius_km": 10,
"limit": 3
}Response shape
{
"request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
"service": "data.reverse-geocode",
"version": "1",
"data": {
"version": "apiacre-reverse-geocode/1",
"query": {
"latitude": 51.5074,
"longitude": -0.1278,
"radiusKm": 10.0,
"limit": 3
},
"candidateCount": 99,
"matched": true,
"resultsTruncated": true,
"results": [
{
"rank": 1,
"geonameId": 2643743,
"name": "London",
"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",
"distanceKm": 0.19
},
{
"rank": 2,
"geonameId": 6615507,
"name": "St James's",
"country": {
"code": "GB",
"name": "United Kingdom",
"iso3": "GBR",
"continentCode": "EU"
},
"admin1": {
"code": "ENG",
"name": "England"
},
"coordinates": {
"latitude": 51.5073,
"longitude": -0.13982
},
"population": 10361,
"timezone": "Europe/London",
"featureCode": "PPLX",
"modifiedOn": "2024-04-09",
"distanceKm": 0.832
},
{
"rank": 3,
"geonameId": 6545173,
"name": "Soho",
"country": {
"code": "GB",
"name": "United Kingdom",
"iso3": "GBR",
"continentCode": "EU"
},
"admin1": {
"code": "ENG",
"name": "England"
},
"coordinates": {
"latitude": 51.5144,
"longitude": -0.13535
},
"population": 19634,
"timezone": "Europe/London",
"featureCode": "PPLX",
"modifiedOn": "2023-07-17",
"distanceKm": 0.937
}
],
"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 applies a bounded spatial lookup and great-circle distance ranking to the bundled populated-place snapshot.",
"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.",
"This endpoint returns nearby populated places, not street addresses, parcels, points of interest, administrative boundary containment, or navigation routes.",
"The nearest populated place is not proof of the queried coordinate's postal address, municipality, jurisdiction, or service area.",
"Distances are rounded great-circle distances between coordinates and place centroids; they are not road, walking, or travel distances.",
"The search radius is capped at 500 km and results use the bundled 2026-08-18 snapshot; an empty result does not prove that no settlement or named feature exists nearby."
]
},
"meta": {
"duration_ms": 42,
"cached": false,
"sources": [],
"warnings": [],
"next_actions": [
{
"service": "data.us-weather-forecast",
"title": "Global weather forecast",
"reason": "Use the queried coordinates for a separately authorized current global forecast.",
"method": "POST",
"path": "/v1/data/us-weather-forecast",
"price": "$0.003",
"input_template": {
"latitude": "$request.latitude",
"longitude": "$request.longitude",
"forecast_type": "day_night",
"units": "auto",
"periods": 6,
"include_current_conditions": false,
"include_active_alerts": false
},
"use_output": "Treat the nearby place as context rather than boundary proof. The forecast is a separate paid request and current 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/reverse-geocode' \
-H 'content-type: application/json' \
--data '{"latitude":51.5074,"longitude":-0.1278,"radius_km":10,"limit":3}'