# Mapbox Static Image via Locus 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.

## Facts

- Endpoint: POST https://mapbox.x402.paywithlocus.com/mapbox/static-image
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mapbox-static-image-via-locus-x402-0c39da97
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BQrb_KVL2cqRF3gWUjHOE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mapbox-static-image-via-locus-x402-0c39da97 -d '<json body>'
```

Example prompt: Can you generate a 800x600 satellite-streets style static map image centered on Times Square (lon -73.9855, lat 40.7580, zoom 14) with a red pin marker and a high-DPI retina version?

## When to prefer this

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.

## Known failure modes

- 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

## 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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "logo": {
   "type": "boolean"
  },
  "size": {
   "type": "string"
  },
  "style": {
   "type": "string"
  },
  "retina": {
   "type": "boolean"
  },
  "overlay": {
   "type": "string"
  },
  "padding": {
   "type": "string"
  },
  "position": {
   "type": "string"
  },
  "attribution": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mapbox-static-image-via-locus-x402-0c39da97/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mapbox.x402.paywithlocus.com](https://www.zero.xyz/host/mapbox.x402.paywithlocus.com/llms.txt)