Meridian
meridian.nodeapi.ai · Rust rewrite · Base USDC payments live · DEM tools live

Geospatial processing for agents, scripts, and people who want the answer fast.

Meridian is a GIS and raster processing API with 28 production endpoints. Call an operation, receive a 402, sign an x402 payment in USDC on Base, retry, and get your result. No API key. No subscription. No dashboard maze.

Open docs See quickstart Open operator panel
Runtime
Rust / Axum
GIS Engine
GDAL 3.8 · GEOS
Payments
x402 · Base USDC

Quickstart

This is the part an agent cares about: endpoint, payment flow, result.

# 1) Call endpoint (expect 402 Payment Required)
curl -X POST https://meridianapi.nodeapi.ai/v1/reproject \
  -F "[email protected]" \
  -F "target_crs=EPSG:3857"

# 2) Sign x402 payment with your Base wallet
# 3) Retry with X-PAYMENT header
curl -X POST https://meridianapi.nodeapi.ai/v1/reproject \
  -H "X-PAYMENT: <base64-eip3009-payload>" \
  -F "[email protected]" \
  -F "target_crs=EPSG:3857"

How payment works

  • 1. Request: call any paid endpoint with a file.
  • 2. Receive 402: Meridian returns payment requirements.
  • 3. Sign: your agent signs an EIP-3009 authorization off-chain.
  • 4. Retry: send the same request with X-PAYMENT.
  • 5. Settle: facilitator submits transferWithAuthorization() on Base.
  • 6. Result: operation runs and returns data.

Operations

Current surface area: 28 production endpoints including vector, topology, DEM, and raster math operations.

Core GIS

  • reproject
  • buffer
  • clip
  • dissolve
  • convert

Schema & validation

  • schema
  • validate
  • repair

Transforms

  • erase
  • feature-to-point
  • feature-to-line
  • feature-to-polygon
  • multipart-to-singlepart
  • add-field

Topology & combine

  • union
  • intersect
  • difference
  • append
  • merge
  • spatial-join

Batch & tiles

  • batch
  • vectorize (.mbtiles)

DEM & raster

  • hillshade
  • slope / aspect / roughness
  • color-relief / contours
  • raster-calc

Why this version exists

The Rust version keeps the API shape but swaps the old Solana Pay flow for x402 on Base — much better for agent-to-agent transactions.
  • No API keys: payment is the auth model.
  • No subscriptions: pay for the operation you run.
  • Docs stay current: OpenAPI is generated from the codebase.
  • Live-tested: end-to-end Base USDC payments already verified against production.
  • Acceptance-tested: full black-box production sweep passed 22/22.
  • Fast path: good fit for agents, scripts, and backend workflows.

Pricing

Simple enough to remember.

$0.01 / MB
Usage-based pricing
$0.01 min
Small files round up
$2.00 max
Hard cap per operation

Example: a 500KB GeoJSON reproject calculates to $0.005 and rounds up to the $0.01 minimum.

Useful links

  • /docs — OpenAPI reference
  • /v1/health — health endpoint
  • /metrics — Prometheus metrics
  • POST /v1/reproject — example paid endpoint
  • POST /v1/hillshade — DEM shaded relief endpoint
  • POST /v1/raster-calc — pixel math across raster inputs
  • POST /v1/batch — multiple ops in one request

Integrate

Three ways to use Meridian, depending on your setup.

Direct API

Any HTTP client. POST a file to the endpoint of your choice, handle the 402, retry with payment, get your result. Full OpenAPI docs at meridianapi.nodeapi.ai/docs.

# Example: reproject a GeoJSON file to Web Mercator
pip install x402
python -c "
from x402.client import pay_for_request
r = pay_for_request('https://meridianapi.nodeapi.ai/v1/reproject',
    files={'file': open('input.geojson','rb')},
    data={'target_crs': 'EPSG:3857'},
    private_key=WALLET_KEY)
print(r.json())
# Replace /v1/reproject with any of the 28 endpoints
"

OpenClaw Agent Skill

For agents running on OpenClaw. Install the Meridian skill and your agent gains full knowledge of the API, payment flow, and endpoint surface — no manual setup.

clawhub install meridian

Operator Panel

Meridian is built for agent-native workflows first. This manual interface uses the same production API for ad hoc runs, testing, validation, and human-operated jobs.

28 operations Quote → pay → run → download Same API agents use
Choose your main file first. The panel will auto-detect vector vs raster when possible, including by inspecting ZIP contents when it can.
Upload a file, then select an applicable operation.

This panel can only call wallets already attached to this browser session. Click a wallet icon below to select and connect it.

Run status Idle

Select an operation and enter inputs to request a quote.

0%
Request summary
Endpoint
—
Input mode
—
Files
—
Parameters
—
Quote
No quote yet.
Wallet
Not connected.
Result
No result yet.
Raw response / error
—