Skip to content
onelayer.
All tools

Tool detail

Satellite & GeoRisk x402 API

Returns satellite imagery (PNG URLs) and scene metadata for given coordinates, in true-color, vegetation, water, thermal, or radar mode.

Categories: Maps places

Use when

  • get a recent satellite image for specific coordinates
  • check vegetation, water, or thermal imagery for a location
  • pull radar satellite imagery independent of cloud cover

Not for

  • not a geocoding or address lookup (see sibling address-to-coordinates endpoint)
  • not a numeric risk score (see sibling location-risk endpoint)

Inputs

POST JSON body: lat, lon (numbers, required); mode (true_color|vegetation|water|thermal|radar, default true_color), date, date_tolerance_days, max_cloud_cover, orbit, radius_m optional

Admitted input schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional preferred acquisition date in YYYY-MM-DD format."
    },
    "date_tolerance_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "default": 10
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "max_cloud_cover": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100,
      "description": "Optical modes only. Radar is cloud-independent.",
      "default": 20
    },
    "mode": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "true_color",
        "vegetation",
        "water",
        "thermal",
        "radar"
      ],
      "default": "true_color"
    },
    "orbit": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "ASCENDING",
        "DESCENDING"
      ],
      "description": "Sentinel-1 orbit direction for radar mode.",
      "default": "ASCENDING"
    },
    "radius_m": {
      "type": "integer",
      "minimum": 500,
      "maximum": 50000,
      "default": 3000
    }
  },
  "required": [
    "lat",
    "lon"
  ],
  "additionalProperties": false
}

Endpoint

Method
POST
URL
https://sat.ipintel.ai/satellite-observe

Payment

Protocol
x402
Listed price
0.025 USDC per call on Base (eip155:8453)
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
POST https://sat.ipintel.ai/satellite-observe
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z