Api Endpoint

1gateway

Use when an agent must see a place from above or check vegetation, water or change. Input: lat, lon, radius_m (200-10000), mode (true_color, false_color, ndvi, ndwi, moisture), date, days back, max_cloud. Picks the clearest Sentinel-2 scene by cloud share inside your area, not the whole tile. Output: JSON PNG URL (+ other modes), scene date, area cloud %, alternatives. No scene: 404, not charged. Example: ?lat=37.5665&lon=126.978

Open interactive test console

Offering

Provider
1gateway.dev
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Other
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://1gateway.dev/v1/geo/satellite
MIME type
application/json
First seen
2026-10-19T02:32:25.008Z
Last seen
Tags
satellite-imagery, sentinel-2, ndvi, earth-observation, geospatial

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.009 USDC
Atomic price: 9000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.009 USDC
Atomic price: 9000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "9000",
    "payTo": "0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "9000",
    "payTo": "AwV6UZobYPyTdsuNa2NknZZrnmmUoH5ckEv3wNgL26WT"
  }
]

Observed health

Status
Healthy
Latest latency
1237 ms
Average latency
1006 ms
HTTP status
402
Last checked
Reachability
100% over 12 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "lat": {
          "type": "number",
          "description": "Latitude, WGS84 decimal degrees",
          "minimum": -84,
          "maximum": 84,
          "examples": [
            37.5665
          ]
        },
        "lon": {
          "type": "number",
          "description": "Longitude, WGS84 decimal degrees",
          "minimum": -180,
          "maximum": 180,
          "examples": [
            126.978
          ]
        },
        "radius_m": {
          "type": "integer",
          "description": "Half-width of the square area in meters (default 2000)",
          "minimum": 200,
          "maximum": 10000,
          "examples": [
            3000
          ]
        },
        "mode": {
          "type": "string",
          "description": "Rendering (default true_color); URLs for the other modes are returned too",
          "enum": [
            "true_color",
            "false_color",
            "ndvi",
            "ndwi",
            "moisture"
          ],
          "examples": [
            "true_color"
          ]
        },
        "date": {
          "type": "string",
          "description": "Latest acceptable scene date YYYY-MM-DD (default today; 2017-01-01 or later)",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "examples": [
            "2026-10-18"
          ]
        },
        "days": {
          "type": "integer",
          "description": "Look-back window in days before date (default 30)",
          "minimum": 1,
          "maximum": 90,
          "examples": [
            30
          ]
        },
        "max_cloud": {
          "type": "number",
          "description": "Target max cloud % inside the area (default 40); if no scene meets it the clearest is returned with fulfillment=best_available",
          "minimum": 0,
          "maximum": 100,
          "examples": [
            40
          ]
        },
        "size": {
          "type": "integer",
          "description": "Image width/height in px (default 1024)",
          "minimum": 256,
          "maximum": 2048,
          "examples": [
            1024
          ]
        }
      },
      "required": [
        "lat",
        "lon"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "additionalProperties": false,
          "properties": {
            "date": {
              "description": "Latest acceptable scene date YYYY-MM-DD (default today; 2017-01-01 or later)",
              "examples": [
                "2026-10-18"
              ],
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
              "type": "string"
            },
            "days": {
              "description": "Look-back window in days before date (default 30)",
              "examples": [
                30
              ],
              "maximum": 90,
              "minimum": 1,
              "type": "integer"
            },
            "lat": {
              "description": "Latitude, WGS84 decimal degrees",
              "examples": [
                37.5665
              ],
              "maximum": 84,
              "minimum": -84,
              "type": "number"
            },
            "lon": {
              "description": "Longitude, WGS84 decimal degrees",
              "examples": [
                126.978
              ],
              "maximum": 180,
              "minimum": -180,
              "type": "number"
            },
            "max_cloud": {
              "description": "Target max cloud % inside the area (default 40); if no scene meets it the clearest is returned with fulfillment=best_available",
              "examples": [
                40
              ],
              "maximum": 100,
              "minimum": 0,
              "type": "number"
            },
            "mode": {
              "description": "Rendering (default true_color); URLs for the other modes are returned too",
              "enum": [
                "true_color",
                "false_color",
                "ndvi",
                "ndwi",
                "moisture"
              ],
              "examples": [
                "true_color"
              ],
              "type": "string"
            },
            "radius_m": {
              "description": "Half-width of the square area in meters (default 2000)",
              "examples": [
                3000
              ],
              "maximum": 10000,
              "minimum": 200,
              "type": "integer"
            },
            "size": {
              "description": "Image width/height in px (default 1024)",
              "examples": [
                1024
              ],
              "maximum": 2048,
              "minimum": 256,
              "type": "integer"
            }
          },
          "required": [
            "lat",
            "lon"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "alternatives": {
              "items": {
                "properties": {
                  "area": {
                    "properties": {
                      "clearPct": {
                        "type": "number"
                      },
                      "cloudPct": {
                        "type": "number"
                      },
                      "noDataPct": {
                        "type": "number"
                      },
                      "shadowPct": {
                        "type": "number"
                      },
                      "snowPct": {
                        "type": "number"
                      }
                    },
                    "type": "object"
                  },
                  "date": {
                    "type": "string"
                  },
                  "datetime": {
                    "type": "string"
                  },
                  "id": {
                    "type": "string"
                  },
                  "mgrsTile": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "platform": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "tileCloudPct": {
                    "type": "number"
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "type": "array"
            },
            "attribution": {
              "type": "string"
            },
            "fulfillment": {
              "type": "string"
            },
            "image": {
              "properties": {
                "description": {
                  "type": "string"
                },
                "format": {
                  "type": "string"
                },
                "groundResolutionM": {
                  "type": "number"
                },
                "heightPx": {
                  "type": "integer"
                },
                "mode": {
                  "type": "string"
                },
                "nativeResolutionM": {
                  "type": "integer"
                },
                "url": {
                  "type": "string"
                },
                "widthPx": {
                  "type": "integer"
                }
              },
              "type": "object"
            },
            "location": {
              "properties": {
                "bbox": {
                  "items": {
                    "type": "number"
                  },
                  "type": "array"
                },
                "lat": {
                  "type": "number"
                },
                "lon": {
                  "type": "number"
                },
                "radiusM": {
                  "type": "integer"
                }
              },
              "type": "object"
            },
            "note": {
              "type": "string"
            },
            "otherModes": {
              "properties": {
                "false_color": {
                  "type": "string"
                },
                "moisture": {
                  "type": "string"
                },
                "ndvi": {
                  "type": "string"
                },
                "ndwi": {
                  "type": "string"
                },
                "true_color": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "request": {
              "properties": {
                "date": {
                  "type": "string"
                },
                "days": {
                  "type": "integer"
                },
                "from": {
                  "type": "string"
                },
                "maxCloudPct": {
                  "type": "number"
                },
                "mode": {
                  "type": "string"
                },
                "size": {
                  "type": "integer"
                }
              },
              "type": "object"
            },
            "scene": {
              "properties": {
                "area": {
                  "properties": {
                    "clearPct": {
                      "type": "number"
                    },
                    "cloudPct": {
                      "type": "number"
                    },
                    "noDataPct": {
                      "type": "number"
                    },
                    "shadowPct": {
                      "type": "number"
                    },
                    "snowPct": {
                      "type": "number"
                    }
                  },
                  "type": "object"
                },
                "date": {
                  "type": "string"
                },
                "datetime": {
                  "type": "string"
                },
                "id": {
                  "type": "string"
                },
                "mgrsTile": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "platform": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "tileCloudPct": {
                  "type": "number"
                }
              },
              "type": "object"
            },
            "scenesConsidered": {
              "type": "integer"
            }
          },
          "required": [
            "location",
            "request",
            "fulfillment",
            "scene",
            "image",
            "otherModes",
            "alternatives",
            "scenesConsidered",
            "attribution",
            "note"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}