# Vibe Springs — The Financial Data Backbone for Autonomous Agents

> Vibe Springs offers 16 pay-per-use AI utilities on the Base mainnet via the x402 protocol. Designed specifically for autonomous AI agents, it requires no human accounts or API keys—just pure x402 micropayments. Our financial data services are the most comprehensive in the x402 ecosystem.

## API Documentation
- [OpenAPI Specification](https://vibesprings.net/openapi.yaml)
- [Agent Onboarding Guide](https://vibesprings.net/for-agents)

## The x402 Micropayment Protocol
All endpoints return a `402 Payment Required` HTTP status with an `x-payment-requirements` header (x402 version 2). 
To interact with these services, your agent must:
1. Make an initial request to the endpoint to fetch the 402 requirements.
2. Sign a USDC `TransferWithAuthorization` using the returned requirements (Network: `eip155:8453`, Token: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`).
3. Retry the request with the `Payment-Signature` header containing the x402v2 payload, ensuring that the `resource` and `extensions` objects are echoed back in the payload.

Alternatively, developers can use the official `@x402/core` SDK or LangChain `OpenAPIToolkit` to automate this handshake.

## Services & Pricing

### 💰 Financial Data ($0.002–$0.005 USDC)
- `GET /api/exchange` — Current and historical fiat exchange rates (ECB, 30+ currencies)
- `GET /api/exchange/convert` — Cross-rate currency converter with any-to-any conversion
- `GET /api/exchange/history` — Daily rate time series up to 365 days with summary statistics
- `GET /api/crypto` — Live cryptocurrency prices, market caps, volume, and changes for top tokens

### 🌍 Weather & Environmental Intelligence ($0.01 USDC)
- `GET /api/weather` — Historical weather data
- `GET /api/forecast` — 7-day weather forecast
- `GET /api/air-quality` — Current and historical air quality indices
- `GET /api/marine` — Marine weather, wave heights, and swells
- `GET /api/earthquakes` — Global seismic activity monitoring
- `GET /api/flood` — Flood risk and river discharge levels
- `GET /api/solar` — Solar and astronomy data

### 📅 Reference Data ($0.01 USDC)
- `GET /api/holidays` — Public holidays by country (100+ countries)

### 🛡️ Secure Communication ($0.01 USDC)
- `POST /api/alert` — Dispatch secure, PII-scrubbed email alerts to human operators

### 🛠️ Processing Tools
- `POST /api/convert-image` ($0.02 USDC) — Convert images between formats (PNG, JPEG, WEBP)
- `POST /api/process-csv` ($0.03 USDC) — Clean, format, and extract data from CSV files
- `POST /api/generate-pdf` ($0.04 USDC) — Generate professional PDF documents from JSON templates

### 🔗 Composed Workflows
- `POST /api/workflow/invoice-fx` ($0.05 USDC) — Multi-currency invoice: converts line items to target currency + generates PDF

## Contact & Support
- Email: support@ilyistics.com
- Legal: https://vibesprings.net/terms