World Data API for AI Agents

12 pay-per-query data and utility services. Weather, earth science, finance, and productivity tools — all x402-native, USDC on Base. No accounts. No keys. No subscriptions.

Agent Quick-Start View Catalog JSON

How x402 Works

Request

Hit any endpoint. No key needed.

402 Response

Server returns payment terms in USDC on Base.

Pay & Receive

Agent pays, gets data back. Done.

Data Services 9

Simple GET requests — pay $0.01, get clean JSON back. Every endpoint is x402-native and listed on Agentic.Market.

🌤️

Weather Forecast

$0.01 USDC

GET /api/forecast

Up to 16-day forecast. Temp, precipitation, wind, UV.

Params: location, days?

🌿

Historical Weather

$0.01 USDC

GET /api/weather

Historical daily weather for any location and date range.

Params: location, start_date, end_date

💨

Air Quality

$0.01 USDC

GET /api/air-quality

PM2.5, PM10, ozone, US AQI and European AQI.

Params: location, days?

🌊

Marine Weather

$0.01 USDC

GET /api/marine

Wave height, swell, ocean current for coastal areas.

Params: location, days?

🌋

Earthquakes

$0.01 USDC

GET /api/earthquakes

Recent seismic events from the USGS catalog.

Params: location, radius_km?, min_mag?, days?

🌊

Flood Risk

$0.01 USDC

GET /api/flood

River discharge forecasts and flood probability.

Params: location, days?

☀️

Solar & Sunrise

$0.01 USDC

GET /api/solar

Sunrise, sunset, day length, UV index, solar radiation.

Params: location, date?, days?

💱

Currency Exchange

$0.01 USDC

GET /api/exchange

Forex rates from ECB. 30+ currencies, historical support.

Params: base?, to?, date?

🗓️

Public Holidays

$0.01 USDC

GET /api/holidays

Public holidays for 100+ countries by year.

Params: country, year?

Utility Tools 3

POST endpoints for document and file processing. Send structured data, get processed output back.

📄

PDF Generation

$0.04 USDC

POST /api/generate-pdf

JSON → professional PDF. Invoice, report, resume templates.

Params: template, data, options?

🖼️

Image Conversion

$0.02 USDC

POST /api/convert-image

Convert and resize images. JPG, PNG, WebP, AVIF.

Params: file, format?, width?, quality?

📊

CSV Processing

$0.03 USDC

POST /api/process-csv

Clean, filter, sort CSV files. Output as JSON or PDF.

Params: file, instructions?

Agent Quick-Start

All endpoints speak x402 natively. Hit the catalog first, pick a service, pay the 402, get your data.

Step 0 — Discover All Services (Free)

# Fetch the machine-readable catalog — no payment needed
GET https://vibesprings.net/api/catalog

# Returns full JSON with all endpoints, params, prices, and examples
{
  "name": "Vibe Springs",
  "services": [
    {
      "name": "Weather Forecast",
      "endpoint": "https://vibesprings.net/api/forecast",
      "method": "GET",
      "price_usdc": 0.01,
      "params": { "location": {...}, "days": {...} },
      "example_request": "GET .../api/forecast?location=Tokyo&days=7"
    },
    ... 11 more services
  ]
}

Step 1 — Request → 402 Payment Required

# Any GET data endpoint — same pattern for all 9 data services
GET https://vibesprings.net/api/forecast?location=London&days=7

# Response: HTTP 402
{
  "x402Version": 1,
  "accepts": [{
    "scheme": "exact",
    "network": "base",
    "maxAmountRequired": "10000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x38C063312719220c676E988f0DEE14B4ec0e44C8",
    "resource": "/api/forecast",
    "description": "Vibe Springs — Weather Forecast Service"
  }],
  "facilitatorUrl": "https://api.cdp.coinbase.com/platform/v2/x402"
}

Step 2 — Pay & Retry → 200 Data

# Retry with X-Payment header containing your signed USDC payment
GET https://vibesprings.net/api/forecast?location=London&days=7
X-Payment: <base64_encoded_x402_payment_payload>

# Response: HTTP 200
{
  "location": "London, England, United Kingdom",
  "timezone": "Europe/London",
  "forecast_days": 7,
  "forecast": [
    {
      "date": "2026-04-22",
      "temp_max_c": 14.2,
      "temp_min_c": 7.8,
      "precipitation_mm": 2.1,
      "precipitation_probability_pct": 45,
      "wind_max_kmh": 22.3,
      "uv_index_max": 3,
      "condition": "Partly cloudy"
    }
  ]
}

More Examples

# Currency rates
GET /api/exchange?base=USD&to=EUR,GBP,JPY

# Earthquakes near Tokyo, last 14 days, M3.0+
GET /api/earthquakes?location=Tokyo&radius_km=300&min_mag=3.0&days=14

# Public holidays for Japan 2026
GET /api/holidays?country=JP&year=2026

# Air quality in Beijing for next 3 days
GET /api/air-quality?location=Beijing&days=3

# Sunrise/sunset in Reykjavik on summer solstice
GET /api/solar?location=Reykjavik&date=2026-06-21

Why Agents Pick Vibe Springs

Zero Friction

No API keys. No accounts. No signup. Just hit the URL, pay $0.01, get data.

Agent-Native

x402-native, listed on Agentic.Market. Agents discover and pay autonomously.

One-Stop Hub

12 services in one place. Weather, finance, earth science, tools — all same protocol.