Name: satellite-address
Price: 0.01 USDC
Availability: InStock

$ man satellite-address

agentutility / locale / satellite-address

PRICE / CALL

$0.01

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

locale

CATEGORY

uncategorized

STATUS

● live

NAME

satellite-address — address to satellite image / one-call address → cloud-free sentinel-2 thumbnail / postal-code satellite snapshot / place-name to space view

SYNOPSIS

POST https://x402.org/v1/satellite-address
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Address to satellite image / one-call address → cloud-free Sentinel-2 thumbnail / postal-code satellite snapshot / place-name to space view. Composes OpenStreetMap Nominatim geocoding with the Sentinel Hub Processing API: caller sends a free-form address and gets back both the geocoded address metadata and a recent cloud-free Sentinel-2 PNG centered on the best match. Optional NASA GIBS MODIS fallback for regional views. JSON output contains: { query, geocode_result, lat, lon, zoom, bbox, data_base64, license, attribution, ... }.

INPUT — request schema

property	type	description	req?
address	string	Free-form address, postal code, place name, or POI. Examples: '1600 Amphitheatre Parkway, Mountain View, CA', 'Brandenburg Gate', '94110'.	required
zoom	number	Slippy-map zoom level. 1-16. Default 15 (street/block scale).	optional
size	number	Output image side length in pixels. 64-2500. Default 512.	optional
source	string	'cdse' (default, Sentinel-2 10m) or 'gibs' (NASA MODIS ~250m, zoom ≤9 only). enum: cdse · gibs	optional
days_back	number	CDSE lookback window for least-cloudy mosaic in days. 7-180. Default 30.	optional

OUTPUT — response shape

field	type	description
source	string	Imagery provider used for this response, typically sentinel-hub or nasa-gibs fallback.
query	string	Original free-form address or place-name string the caller submitted for geocoding.
geocode_result	string	Nominatim match metadata including display name, address components, and OSM type/id.
lat	string	Latitude in decimal degrees of the geocoded match center used to frame the satellite tile.
lon	string	Longitude in decimal degrees of the geocoded match center used to frame the satellite tile.
zoom	string	Effective zoom level used when computing the bounding box around the geocoded point.
size	string	Pixel dimensions of the returned PNG, typically given as width x height.
bbox	string	Bounding box [minLon, minLat, maxLon, maxLat] of the area rendered in the image.
time_range	string	Acquisition window queried against Sentinel-2 to pick the most recent cloud-free scene.
format	string	Image format of the rendered tile, typically png.
content_type	string	MIME type of the embedded image payload, typically image/png.
data_base64	string	Base64-encoded bytes of the cloud-free Sentinel-2 PNG centered on the matched address.
bytes	string	Decoded byte length of the returned image payload.
license	string	License terms covering the imagery and geocoding data, e.g. Copernicus Sentinel and ODbL.
attribution	string	Required attribution string crediting Sentinel Hub, Copernicus, and OpenStreetMap contributors.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.org/v1/satellite-address \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the satellite-address tool to ..."

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: localesatellite-imagerygeocodingsentinel-2address-lookupaerial-viewcloud-free-imagery
methods: POST
cluster: locale
price: $0.01 USDC per call

ADJACENT — other endpoints in locale

endpoint	description	price
flight-status	Flight status / live aircraft position / flight tracker / ICAO24 lookup / callsign lookup / aircraft bounding-box / OpenSky Network state…	$0.01
property-tax	Property tax lookup.	$0.01
property-tax-assessment	Property tax assessor lookup (multi-county).	$0.01
sports-schedule	Sports schedule / MLB / NBA / NHL / NFL / WNBA / MLS / EPL / La Liga / Bundesliga / Serie A — next games + recent results / sports schedu…	$0.01
iata-airport-info	IATA / ICAO airport code lookup.	$0.005
satellite-tile	Satellite imagery tile / lat-lon to satellite PNG / Sentinel-2 tile API / cloud-free satellite snapshot / agent-callable satellite imagery.	$0.005
vin-decode	VIN decoder / VIN lookup / decode VIN / vehicle identification number / NHTSA vPIC wrapper.	$0.005
visa-requirements	Visa requirements lookup.	$0.005

/satellite-address(1)