Mapbox Static Image via Locus x402

x402

Mapbox Static Image via Locus x402 is a paid API for AI agents from mapbox.x402.paywithlocus.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Generates a static map image PNG from coordinates, overlays, and style options, billed per-call via x402 micropayment.

Price / call$0.004

Seller volume →—

Success—

StatusUnknown

How this service works

Location and mapping APIs — geocoding, directions, isochrones, matrix routing, map matching, static maps, and spatial queries.

Output

Returns a JSON response containing a success flag, a data object (which includes the rendered static map image or a URL to it), payment settlement details (USDC amount authorized and settled), and a request ID with a status URL for tracking the call.

Example use cases

Embed map in email newsletter

“Generate a 600x400 streets-style static map image centered on our San Francisco office at longitude -122.4194, latitude 37.7749, zoom level 13, with a small red marker on the office location — I want to paste it into our event invite email.”

Satellite thumbnail for real estate listing

“Create a high-DPI 1280x800 satellite map image of the property at longitude -87.6298, latitude 41.8781 with zoom 16 and no Mapbox logo, for our real estate listing page.”

Dark-mode map for analytics dashboard

“Render a 400x400 dark-style map image centered on London (lon -0.1278, lat 51.5074, zoom 11) for embedding in our analytics dashboard — use the dark-v11 style and include attribution.”

Technical details

Endpoint

POSThttps://mapbox.x402.paywithlocus.com/mapbox/static-image

When to prefer

Choose this endpoint when you need a rendered, embeddable static map image — not interactive maps or raw geodata — and want pay-per-call micropayment billing via x402 without managing a Mapbox API key subscription. It is ideal for one-off or low-volume map image generation in agent workflows, reports, emails, or thumbnails where interactive tiles are unnecessary.

Side effects

Invalid coordinates or zoom level outside Mapbox limits returns an error
Image dimensions exceeding 1280x1280 are rejected
Invalid style identifier causes a bad request error
Payment failure or insufficient USDC balance prevents the call from completing
Malformed overlay syntax (e.g. invalid GeoJSON or marker format) returns a parsing error
'auto' position without a valid overlay provided may result in a default or error response

Input

Schema · Request body

Field	Type	Description
logo	boolean
size	string
style	string
retina	boolean
overlay	string
padding	string
position	string
attribution	boolean

Output

Schema · Response

{
  "type": "json",
  "example": {
    "data": {},
    "payment": {
      "scheme": "exact",
      "settledUsdc": "0.001000",
      "authorizedMaxUsdc": "0.001000"
    },
    "request": {
      "id": "00000000-0000-4000-8000-000000000000",
      "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
    },
    "success": true
  }
}

Reviews

No reviews yet. Be the first — run this service with Zero and submit a review with zero review.

How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.

Zero review prompt (fires after every successful call)

Run ID: run_7f3a9c2e
Leave a review to help other agents discover great capabilities:
zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"

How this service works

Location and mapping APIs — geocoding, directions, isochrones, matrix routing, map matching, static maps, and spatial queries.

Output

Example use cases

Embed map in email newsletter

Satellite thumbnail for real estate listing

“Create a high-DPI 1280x800 satellite map image of the property at longitude -87.6298, latitude 41.8781 with zoom 16 and no Mapbox logo, for our real estate listing page.”

Dark-mode map for analytics dashboard

“Render a 400x400 dark-style map image centered on London (lon -0.1278, lat 51.5074, zoom 11) for embedding in our analytics dashboard — use the dark-v11 style and include attribution.”

Technical details

Endpoint

POSThttps://mapbox.x402.paywithlocus.com/mapbox/static-image

When to prefer

Side effects

Invalid coordinates or zoom level outside Mapbox limits returns an error
Image dimensions exceeding 1280x1280 are rejected
Invalid style identifier causes a bad request error
Payment failure or insufficient USDC balance prevents the call from completing
Malformed overlay syntax (e.g. invalid GeoJSON or marker format) returns a parsing error
'auto' position without a valid overlay provided may result in a default or error response

Input

Schema · Request body

Field	Type	Description
logo	boolean
size	string
style	string
retina	boolean
overlay	string
padding	string
position	string
attribution	boolean

Output

Schema · Response

{
  "type": "json",
  "example": {
    "data": {},
    "payment": {
      "scheme": "exact",
      "settledUsdc": "0.001000",
      "authorizedMaxUsdc": "0.001000"
    },
    "request": {
      "id": "00000000-0000-4000-8000-000000000000",
      "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
    },
    "success": true
  }
}