Officially indexed in Coinbase x402 Bazaar · Live on Agentic.Market

World Data API for AI Agents

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

Agent Quick-Start

Explore Full Catalog (JSON)

Machine-readable schema for agents & frameworks.

🎮 Try Live Demo llms.txt MCP Config

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 12

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

🌤️

Weather Forecast

$0.002 USDC

GET /api/forecast

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

Params: location, days?

🌿

Historical Weather

$0.002 USDC

GET /api/weather

Historical daily weather for any location and date range.

Params: location, start_date, end_date

💨

Air Quality

$0.002 USDC

GET /api/air-quality

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

Params: location, days?

🌊

Marine Weather

$0.002 USDC

GET /api/marine

Wave height, swell, ocean current for coastal areas.

Params: location, days?

🌋

Earthquakes

$0.002 USDC

GET /api/earthquakes

Recent seismic events from the USGS catalog.

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

🌊

Flood Risk

$0.002 USDC

GET /api/flood

River discharge forecasts and flood probability.

Params: location, days?

☀️

Solar & Sunrise

$0.002 USDC

GET /api/solar

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

Params: location, date?, days?

💱

Currency Exchange

$0.002 USDC

GET /api/exchange

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

Params: base?, to?, date?

🔄

Currency Convert

$0.002 USDC

GET /api/exchange/convert

Convert any amount between 30+ fiat currencies with live ECB rates.

Params: from, to, amount?

📈

Exchange History

$0.005 USDC

GET /api/exchange/history

Daily exchange rate time series for any pair up to 365 days.

Params: base?, to?, start, end

🪙

Crypto Prices

$0.005 USDC

GET /api/crypto

Live prices, market caps, and volume for top tokens.

Params: ids?, vs?, limit?

🗓️

Public Holidays

$0.002 USDC

GET /api/holidays

Public holidays for 100+ countries by year.

Params: country, year?

Utility Tools 4

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?

📧

Secure Email Alert

$0.01 USDC

POST /api/alert

Secure, plain-text alerts for human operators with automatic PII sanitization.

Params: to, subject, body

🖼️

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?

Composable Workflows 3

Multi-step workflows combining multiple services in a single, atomic x402 payment.

🗺️

Location Report

$0.008 USDC

GET /api/workflow/location-report

Combines weather, astronomy, and air quality in a single call.

Params: location

📈

CSV to PDF

$0.06 USDC

POST /api/workflow/csv-to-pdf

Processes raw CSV data and renders a professional PDF summary.

Params: file, instructions?

🧾

Invoice FX

$0.05 USDC

POST /api/workflow/invoice-fx

Converts multi-currency items to target currency and builds PDF.

Params: from, to, targetCurrency, items

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.002,
      "params": { "location": {...}, "days": {...} },
      "example_request": "GET .../api/forecast?location=Tokyo&days=7"
    },
    ... 15 more services
  ]
}

Step 1 — Request → 402 Payment Required

# Any GET data endpoint — same pattern for all 12 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"
    }
  ]
}

Error Code Reference

Code	Meaning	Agent Action
`402`	Payment Required	Sign USDC payment and retry with `X-Payment` header.
`400`	Invalid Params	Check your query params against the `catalog` schema.
`429`	Rate Limited	Wait for `Retry-After` seconds before trying again.
`503`	Service Down	External data provider is unavailable. Try again in 5-10 mins.

View Deep-Dive for Agent Developers

Framework guides for LangGraph, CrewAI, and OpenAI Swarm.

Why Agents Pick Vibe Springs

Saves Inference Tokens

Our processing tools use structured JSON — your agent skips writing HTML, CSS, or parsing code, saving thousands of LLM tokens per call.

Agent-Native

x402-native, listed on Agentic.Market. Data from $0.002, tools from $0.02. Agents discover and pay autonomously.

One-Stop Hub

16 services in one place. Weather, finance, earth science, tools, and workflows — all same protocol, zero API keys.