# Vibe Springs — agents.txt
# https://vibesprings.net
# Last updated: 2026-06-27

Name: Vibe Springs
Description: 39 pay-per-use AI endpoints on Base mainnet via x402 protocol. Weather, finance, blockchain, social intelligence, agent infrastructure, composites, workflows, and processing tools. No API keys, no subscriptions — just micropayments.
Url: https://vibesprings.net
Contact: support@ilyistics.com
Provider: Vibe Springs / Ilyistics LLC

# Discovery (all FREE, no payment required)
Catalog: https://vibesprings.net/api/catalog
OpenAPI: https://vibesprings.net/openapi.yaml
OpenAPI-JSON: https://vibesprings.net/openapi.json
LLMs-txt: https://vibesprings.net/llms.txt
LLMs-full-txt: https://vibesprings.net/llms-full.txt
x402-Manifest: https://vibesprings.net/.well-known/x402.json
MCP: https://vibesprings.net/.well-known/mcp.json
AI-Plugin: https://vibesprings.net/.well-known/ai-plugin.json

# Payment
Protocol: x402
Network: eip155:8453 (Base Mainnet)
Currency: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
Facilitator: https://api.cdp.coinbase.com/platform/v2/x402
PayTo: 0x38C063312719220c676E988f0DEE14B4ec0e44C8
Price-Range: $0.001 - $1.00 USDC

# Terms
Data-Usage: allowed
Training: allowed
Caching: allowed (24h recommended TTL)
Attribution: appreciated but not required

# Service Categories (39 endpoints total)
## data/weather (7 endpoints, $0.002/call)
- GET /api/weather — Historical weather data for any location
- GET /api/forecast — Up to 16-day weather forecast
- GET /api/air-quality — Current and forecast air quality (PM2.5, PM10, ozone)
- GET /api/marine — Marine weather, wave heights, swells, currents
- GET /api/earthquakes — Global seismic activity monitoring (USGS)
- GET /api/flood — Flood risk and river discharge levels
- GET /api/solar — Solar radiation, astronomy, UV index

## data/finance (6 endpoints, $0.002-$0.005/call)
- GET /api/exchange — Live ECB forex rates for 30+ currencies ($0.002)
- GET /api/exchange/convert — Cross-rate currency converter ($0.002)
- GET /api/exchange/history — Daily rate time series up to 365 days ($0.005)
- GET /api/crypto — Live crypto prices, market caps, volume ($0.005)
- GET /api/market-data — Unified stock and crypto market feed ($0.002)
- GET /api/holidays — Public holidays by country ($0.002)

## data/blockchain (7 endpoints, $0.001-$0.005/call)
- GET /api/gas — Real-time gas fees for Base, ETH, Arbitrum, Optimism ($0.001)
- GET /api/wallet-intel — Full wallet profiling and behavioral tags ($0.02)
- GET /api/defi-yields — Cross-protocol yield scanner ($0.03)
- GET /api/price/btc-usd — Real-time BTC/USD price oracle ($0.002)
- GET /api/price/eth-usd — Real-time ETH/USD price oracle ($0.002)
- GET /api/price/sol-usd — Real-time SOL/USD price oracle ($0.002)
- GET /api/price/base-gas — Real-time Base gas price oracle ($0.001)

## social/feeds (4 endpoints, $0.50-$1.00/call)
- GET /api/social/brian_armstrong/tweets — @brian_armstrong feed ($1.00)
- GET /api/social/vitalikbuterin/tweets — @vitalikbuterin feed ($0.50)
- GET /api/social/elonmusk/tweets — @elonmusk feed ($1.00)
- GET /api/social/search/tweets — Search tweets by query ($0.50)

## tools (4 endpoints, $0.01-$0.04/call)
- POST /api/alert — Secure email alerts to operators ($0.01)
- POST /api/generate-pdf — Professional PDF document generation ($0.04)
- POST /api/convert-image — Image conversion and optimization ($0.02)
- POST /api/process-csv — CSV data cleaning and analysis ($0.01)

## workflows (3 endpoints, $0.008-$0.06/call)
- GET /api/workflow/location-report — Weather + air + solar combined ($0.008)
- POST /api/workflow/invoice-fx — Multi-currency invoice + PDF ($0.05)
- POST /api/workflow/csv-to-pdf — CSV processing + PDF report ($0.06)

## composite (4 endpoints, $0.02-$0.03/call)
- GET /api/market-pulse — Crypto + FX + gas + DeFi in one call ($0.02)
- GET /api/travel-brief — Forecast + air + holidays + FX ($0.02)
- GET /api/portfolio-brief — Wallet + risk + yields + gas ($0.03)
- GET /api/risk-report — 6-signal risk score + wallet profile ($0.03)

## security (1 endpoint, $0.005/call)
- GET /api/address-risk — On-chain security score (0-100)

## agent-infrastructure (3 endpoints, $0.003-$0.005/call)
- GET /api/agent/status — Agent wallet status and recommendations ($0.005)
- GET /api/infra/health-check — API health and x402 compatibility scanner ($0.003)
- GET /api/infra/discover — Dynamic catalog search and filtering ($0.005)