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

World Data API for AI Agents

40 pay-per-query data, composite intelligence, 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 24

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?

📊

Unified Market Data

$0.002 USDC

GET /api/market-data

Real-time stock prices, crypto spot prices, and crypto perpetuals metrics in a single request.

Params: symbols?

🌾

DeFi Yields

$0.03 USDC

GET /api/defi-yields

Cross-protocol yield scanner. Best APY across Aave, Compound, Uniswap, and 100+ protocols.

Params: token?, chain?, min_tvl?, limit?

👛

Wallet Intel

$0.02 USDC

GET /api/wallet-intel

Full wallet profiling — balances, tokens, activity level, behavioral tags.

Params: address, chain?

⛽

Gas Oracle

$0.001 USDC

GET /api/gas

Real-time gas fees for Base, Ethereum, Arbitrum, Optimism with cost estimates.

Params: chain?

🗓️

Public Holidays

$0.002 USDC

GET /api/holidays

Public holidays for 100+ countries by year.

Params: country, year?

🪙

BTC/USD Price Oracle

$0.01 USDC

GET /api/price/btc-usd

Real-time spot price of Bitcoin in USD from Coinbase.

Params: None

🪙

ETH/USD Price Oracle

$0.01 USDC

GET /api/price/eth-usd

Real-time spot price of Ethereum in USD from Coinbase.

Params: None

🪙

SOL/USD Price Oracle

$0.01 USDC

GET /api/price/sol-usd

Real-time spot price of Solana in USD from Coinbase.

Params: None

⛽

Base Gas Price Oracle

$0.01 USDC

GET /api/price/base-gas

Real-time base gas fee and transaction estimates on Base mainnet.

Params: None

🚧

Delay Disruption Risk

$0.05 USDC

GET /api/delay-risk

0–100 outdoor scheduling disruption risk score from weather, soil type, and wind.

Params: lat, lon, profile?, days?, soil?, hydrologicGroup?, drainageClass?, gradient?, exposure?

🚧

Delay Risk Demo

$0.002 USDC

GET /api/demo/delay-risk

Demo: delay risk score for 5 fixed US locations representing clay, wet coast, semi-arid, fast-drain, and silt.

Params: location?, profile?, soil?

🐦

Mock Social Feed

$0.005 USDC

GET /api/mock/social/feed

Deterministic mock social feed with persona, sentiment, seed, and custom formatting controls.

Params: persona?, seed?, sentiment?, count?, format?

🐦

Mock Social Stream Scenario

$0.01 USDC

GET /api/mock/social/stream

Deterministic mock social stream scenarios (hype cycle, FUD cascade, etc.) at step ticks.

Params: scenario?, step?, seed?, format?

Utility Tools 5

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

🔍

Agent Visibility Auditor

$0.20 USDC

GET /api/audit/agent-visibility

Audit any API endpoint for x402 compatibility, JSON schema constraints, robots.txt, and LLM readability.

Params: url

🛡️

Address Risk

$0.005 USDC

GET /api/address-risk

On-chain risk scoring for any Ethereum address.

Params: address, network?

📄

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

Composite Intelligence 4

Single-call aggregations that combine multiple data sources in parallel. Pay once, get a complete intelligence package — built for agentic workflows that need rich context fast.

📊

Market Pulse

$0.02 USDC

GET /api/market-pulse

Real-time snapshot: top crypto + FX rates + Base gas + USDC DeFi yields — all in one call.

Params: cryptos?, base?

✈️

Travel Brief

$0.02 USDC

GET /api/travel-brief

Destination intel: 7-day forecast + air quality + public holidays + currency FX for any city.

Params: location, country?, currency?

💼

Portfolio Brief

$0.03 USDC

GET /api/portfolio-brief

Complete DeFi portfolio snapshot: wallet tokens + risk score + available USDC yields + gas prices.

Params: address, chain?

🔍

Risk Report

$0.03 USDC

GET /api/risk-report

Deep on-chain due-diligence: 6+ risk signals, severity flags, full wallet profile + behavioral tags.

Params: address, chain?

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"
    },
    ... 39 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.