$ man satellite-tile
/satellite-tile(1)
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
localeCATEGORY
uncategorized
STATUS
● live
NAME
satellite-tile — satellite imagery tile / lat-lon to satellite png / sentinel-2 tile api / cloud-free satellite snapshot / agent-callable satellite imagery
SYNOPSIS
POST https://x402.org/v1/satellite-tile
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Satellite imagery tile / lat-lon to satellite PNG / Sentinel-2 tile API / cloud-free satellite snapshot / agent-callable satellite imagery. Returns a recent cloud-free Sentinel-2 (10m) PNG centered on a lat/lon at a slippy-map zoom level. Default source: CDSE Sentinel Hub Processing API with mosaickingOrder=leastCC over the prior 30 days (configurable via days_back). Optional NASA GIBS MODIS Terra (~250m) source for regional zoom ≤9 with zero quota. Output is JSON: { source, lat, lon, zoom, bbox, data_base64, license, attribution, ... }. License: Copernicus open data (CC BY-SA 3.0 IGO) or NASA public domain; attribution string included in every response.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| lat | number | Latitude in decimal degrees. Range [-90, 90]. | required |
| lon | number | Longitude in decimal degrees. Range [-180, 180]. | required |
| zoom | number | Slippy-map zoom level. 1-16. Default 14 (city block scale). MODIS/GIBS supports ≤9 only. | optional |
| size | number | Output image side length in pixels. 64-2500. Default 512. | optional |
| source | string | Imagery source. 'cdse' (default, Sentinel-2 10m) or 'gibs' (NASA MODIS Terra ~250m, no quota, zoom ≤9 only). enum: cdse · gibs | optional |
| days_back | number | CDSE only: 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 tile, either CDSE Sentinel-2 or NASA GIBS MODIS Terra. |
| lat | string | Latitude of the tile center in decimal degrees, echoed back from the request. |
| lon | string | Longitude of the tile center in decimal degrees, echoed back from the request. |
| zoom | string | Slippy-map zoom level used to compute the tile bounding box. |
| size | string | Pixel dimensions of the returned PNG, typically expressed as widthxheight. |
| bbox | string | Geographic bounding box of the tile as [minLon, minLat, maxLon, maxLat] in WGS84 degrees. |
| time_range | string | Date window searched for cloud-free imagery, e.g. last 30 days ending at request time. |
| format | string | Image file format of the returned tile, typically png. |
| content_type | string | MIME type of the encoded image payload, typically image/png. |
| data_base64 | string | Base64-encoded PNG bytes of the cloud-free satellite tile. |
| bytes | string | Decoded size of the PNG payload in bytes. |
| license | string | License covering the imagery, Copernicus CC BY-SA 3.0 IGO or NASA public domain. |
| attribution | string | Required attribution string to display alongside the imagery. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/satellite-tile \
-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-tile tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- localesatellite-imagerysentinel-2map-tilegeospatiallat-loncloud-freeslippy-map
- methods
- POST
- cluster
- locale
- price
- $0.005 USDC per call
ADJACENT — other endpoints in locale
| endpoint | description | price |
|---|---|---|
| iata-airport-info | IATA / ICAO airport code lookup. | $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 |
| weather | Weather API / weather forecast / current weather / hourly forecast. | $0.005 |
| weather-forecast | Weather forecast / hourly forecast / current weather / temperature / precipitation / UV index / sunrise-sunset / Open-Meteo / weather API. | $0.005 |
| astro-times | sunrise-sunset / golden-hour / civil twilight / nautical dusk / day-length / solar-noon / dawn-dusk / astronomy times. | $0.002 |
| country-info | Country info / ISO 3166 / country code lookup / capital city lookup / currencies by country / population / region resolver. | $0.002 |
| earthquakes-recent | Earthquake feed / seismic activity / USGS / recent quakes / quake monitor / tremor data / fault line activity / tsunami alerts. | $0.002 |
SEE ALSO