--- name: vibesprings.net description: vibesprings.net provides fiat currency exchange rates and conversion, a snapshot of top cryptocurrency market data, and PDF invoice generation. It exposes four discrete skills covering currency data retrieval, currency conversion calculation, and structured document output. host: vibesprings.net --- # vibesprings.net vibesprings.net is a small-footprint utility host serving agents that need fiat currency data (sourced from the European Central Bank), quick cryptocurrency market snapshots for the top 25 tokens, and the ability to produce invoice PDFs from structured billing data. It is not a trading platform, blockchain gateway, or general-purpose document renderer — it occupies a narrow but practical niche for financial data lookup and invoice document generation. ## When to use this host Use vibesprings.net when an agent needs daily ECB fiat exchange rates, a simple fiat currency conversion with rate and inverse rate, a top-25 crypto market snapshot (prices, caps, volume, short-term changes), or structured PDF invoice generation. Do not use this host for real-time tick-by-tick forex data, crypto token swaps or on-chain transactions, historical price series or OHLCV candles, single-token crypto lookups outside the top 25, or rendering arbitrary HTML/markdown to PDF. For deeper crypto market data with filtering and historical series, prefer a dedicated market data provider such as CoinGecko or CoinMarketCap APIs. For on-chain asset exchange, use a DEX aggregator host. For general-purpose PDF rendering, use a document-rendering service that accepts HTML or template inputs. ## Capabilities ### Fiat Currency Data and Conversion Provides daily ECB-sourced fiat exchange rates relative to USD and performs point-in-time currency conversion calculations including the converted amount, rate, and inverse rate. - **`fetch-exchange-rates`** — Returns daily fiat currency exchange rates against USD sourced from the European Central Bank, delivered via a paid x402 endpoint on Base. - **`fetch-currency-conversion`** — Converts a currency amount from one currency to another and returns the converted amount, exchange rate, inverse rate, and source date via the VibeSprings exchange endpoint. ### Crypto Market Snapshot Returns a fixed snapshot of price, market cap, 24h volume, and short-term percent changes for the top 25 cryptocurrencies priced in USD. - **`fetch-crypto-market-data`** — Returns price, market cap, 24h volume, and 1h/24h/7d percent changes for the top 25 cryptocurrencies priced in USD. ### Invoice Document Generation Accepts structured invoice data — vendor, billing party, line items, dates, currency, and notes — and returns a binary PDF invoice file ready for download or delivery. - **`generate-pdf-invoice`** — Generates a PDF document from structured invoice data including vendor, billing, line items, dates, and currency, returning a binary PDF file. ## Workflows ### Multi-Currency Invoice Generation *Use when an agent needs to produce an invoice where line item amounts are known in one currency but the invoice must be issued in a different fiat currency.* 1. **`fetch-currency-conversion`** — Convert the source currency amounts to the target invoice currency, capturing the exchange rate and converted totals for use in the invoice. 2. **`generate-pdf-invoice`** — Populate the invoice with the converted amounts and target currency, then generate and return the final PDF document. ### Exchange Rate Lookup Then Invoice *Use when an agent needs to display or annotate an invoice with current exchange rates for multiple currencies before generating the PDF.* 1. **`fetch-exchange-rates`** — Retrieve current daily ECB fiat rates to determine applicable exchange rates for the invoice currency context. 2. **`generate-pdf-invoice`** — Generate the invoice PDF using the confirmed currency and rate-informed amounts. ## Skill reference ### `fetch-currency-conversion` **SpringSwap Convert** — Converts a currency amount from one currency to another and returns the converted amount, exchange rate, inverse rate, and source date via the VibeSprings exchange endpoint. *Use when:* Use when an agent needs to convert a specific amount between two currencies and requires the current exchange rate, converted amount, and inverse rate for display or downstream calculation. *Not for:* Do not use for crypto token swaps or on-chain asset exchanges; this endpoint handles fiat currency conversion only. **Inputs:** - `from` (string, required) — ISO 4217 currency code of the source currency. - `to` (string, required) — ISO 4217 currency code of the target currency. - `amount` (number, required) — Numeric amount to convert from the source currency. **Returns:** Returns convertedAmount, rate, inverseRate, date, and source attribution for the requested currency pair and amount. **Example:** `GET https://vibesprings.net/api/exchange/convert?from=USD&to=EUR&amount=1` --- ### `fetch-crypto-market-data` **Crypto Market Data** — Returns price, market cap, 24h volume, and 1h/24h/7d percent changes for the top 25 cryptocurrencies priced in USD. *Use when:* Use when an agent needs a current snapshot of top cryptocurrency market data including prices, market caps, trading volumes, and short-term price changes for assets like BTC, ETH, SOL, and others. *Not for:* Do not use for historical price series, order book data, or single-token lookups; this endpoint returns a fixed list of 25 tokens with no filtering parameters. **Returns:** Returns vsCurrency='usd', count=25, and a tokens array with price, marketCap, volume24h, change1h/24h/7d, ATH, circulating supply, and lastUpdated for each of the top 25 cryptocurrencies. **Example:** `GET https://vibesprings.net/api/crypto` --- ### `fetch-exchange-rates` **VibeSpring Exchange Rates** — Returns daily fiat currency exchange rates against USD sourced from the European Central Bank, delivered via a paid x402 endpoint on Base. *Use when:* Use when an agent needs current fiat exchange rates relative to USD for currency conversion, financial calculations, or display of multi-currency pricing. *Not for:* Do not use for crypto token prices or real-time tick data; this returns daily ECB fiat rates only. **Returns:** Returns a JSON object with base currency USD, a date string, a rates object containing ~29 fiat currency codes with their USD exchange rates, the data source, and server processing time. **Example:** `GET https://vibesprings.net/api/exchange` --- ### `generate-pdf-invoice` **PDF Forge** — Generates a PDF document from structured invoice data including vendor, billing, line items, dates, and currency, returning a binary PDF file. *Use when:* Use when an agent needs to produce a downloadable invoice PDF from structured billing data such as vendor details, customer details, line items with tax rates, issue date, and due date. *Not for:* Do not use for rendering arbitrary HTML or markdown to PDF; this endpoint is structured around invoice-shaped data. Not suitable for bulk batch PDF generation in a single call. **Inputs:** - `data` (object, required) — Top-level wrapper object containing all invoice fields: vendor, billing, lineItems, dueDate, issueDate, currency, and notes. - `data.vendor` (object, required) — Vendor (seller) contact and address details: name, company, email, phone, addressLine1, addressLine2, city, state, postalCode, country. - `data.billing` (object, required) — Billing (buyer) contact and address details: name, company, email, phone, addressLine1, addressLine2, city, state, postalCode, country. - `data.lineItems` (array, required) — Array of line item objects, each with description (string), quantity (number), unitPrice (number), and taxRate (decimal, e.g. 0.0825 for 8.25%). - `data.issueDate` (string, required) — Invoice issue date in ISO 8601 format (YYYY-MM-DD). - `data.dueDate` (string, required) — Invoice due date in ISO 8601 format (YYYY-MM-DD). - `data.currency` (string, required) — Three-letter ISO 4217 currency code for the invoice amounts. - `data.notes` (string) — Optional free-text notes to appear on the invoice (e.g. payment terms, contact instructions). **Returns:** Returns a binary PDF file (Content-Type: application/pdf, ~10KB) containing a rendered invoice with vendor/billing details, line items, tax, and totals. **Example:** `{"data":{"vendor":{"name":"Vibe Springs Studio","company":"Vibe Springs Studio Inc.","email":"billing@vibesprings.net","phone":"+1-212-555-0199","addressLine1":"1200 Broadway","addressLine2":"Floor 7","city":"New York","state":"NY","postalCode":"10001","country":"US"},"billing":{"name":"Jordan Rivera","company":"Rivera Consulting LLC","email":"jordan.rivera@example.com","phone":"+1-415-555-0134","addressLine1":"88 Market Street","addressLine2":"Suite 120","city":"San Francisco","state":"CA","postalCode":"94105","country":"US"},"lineItems":[{"description":"Design & layout","quantity":1,"unitPrice":1250,"taxRate":0.0825}],"issueDate":"2026-05-28","dueDate":"2026-06-27","currency":"USD","notes":"Payment due by due date listed above."}}` ---