vibesprings-net Workflow API

openapi: 3.2.0
info:
  title: Vibe Springs Workflow API
  description: 'Pay-per-use AI utilities: image conversion, PDF generation, CSV processing, and historical weather data. All endpoints require x402 USDC payments on Base mainnet. No API keys needed.'
  version: v2
  contact:
    name: Vibe Springs Support
    email: support@vibesprings.net
    url: https://vibesprings.net/for-agents
  x-guidance: 'Vibe Springs: 50 pay-per-use AI endpoints for autonomous agents via x402 micropayments on Base. Categories: (1) Weather & Environmental Intelligence — historical weather, forecasts, air quality, marine, earthquakes, floods, solar/UV, and weather-driven delay-risk. (2) Finance — forex rates, currency conversion, rate history, crypto prices, market data, public holidays. (3) Blockchain & On-chain — gas fees, wallet profiling, DeFi yield scanning, price oracles (BTC, ETH, SOL, Base gas), address risk scoring. (4) Mock Social Intelligence — deterministic synthetic social feeds and scenario streams for agent testing, not live social data. (5) Processing Tools — PDF generation, image conversion, CSV cleaning, email alerts. (6) Composite Intelligence — market-pulse (crypto+FX+gas+DeFi), travel-brief (forecast+air+holidays+FX), portfolio-brief (wallet+risk+yields+gas), risk-report (6-signal due diligence). (7) Workflows — location-report, invoice-fx, csv-to-pdf. (8) Agent Infrastructure — wallet status checker, API health scanner, service discovery proxy, API AEO visibility auditor. (9) x402 Market Intelligence — listing authenticity and health audits, category trends, competitor analysis, and a historical archive of the Bazaar itself that the Coinbase discovery API does not retain. Pricing: $0.001-$25.00 USDC per call. No API keys or accounts needed — just x402 wallet signatures on Base mainnet (eip155:8453).'
servers:
- url: https://vibesprings.net
tags:
- name: Workflow
paths:
  /api/workflow/invoice-fx:
    post:
      operationId: generateInvoiceFX
      summary: Multi-currency invoice workflow.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - from
              - to
              - targetCurrency
              - items
              properties:
                invoiceNumber:
                  type: string
                from:
                  type: object
                  properties:
                    name:
                      type: string
                    address:
                      type: string
                    email:
                      type: string
                to:
                  type: object
                  properties:
                    name:
                      type: string
                    address:
                      type: string
                    email:
                      type: string
                targetCurrency:
                  type: string
                items:
                  type: array
                  items:
                    type: object
                    properties:
                      description:
                        type: string
                      quantity:
                        type: number
                      unitPrice:
                        type: number
                      currency:
                        type: string
                notes:
                  type: string
                dueDate:
                  type: string
      responses:
        '200':
          description: Generated PDF invoice
          content:
            application/pdf:
              schema:
                type: string
                format: binary
        '402':
          description: Payment Required (x402)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.15'
        protocols:
        - x402: {}
      security:
      - x402: []
      tags:
      - Workflow
  /api/workflow/location-report:
    get:
      operationId: getLocationReport
      summary: Location intelligence report (forecast, air, flood, quakes, marine, solar)
      parameters:
      - name: location
        in: query
        required: true
        schema:
          type: string
        description: City or region name.
      - name: forecast_days
        in: query
        required: false
        schema:
          type: integer
          default: 3
        description: Days of forecast data (1-7).
      responses:
        '200':
          description: Comprehensive location data
          content:
            application/json:
              schema:
                type: object
        '402':
          description: Payment Required (x402)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.05'
        protocols:
        - x402: {}
      security:
      - x402: []
      tags:
      - Workflow
  /api/workflow/csv-to-pdf:
    post:
      operationId: csvToPdf
      summary: Convert uploaded CSV data to professional PDF report
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
                  description: The CSV file.
                instructions:
                  type: string
                  description: JSON string containing processing/styling instructions.
              required:
              - file
      responses:
        '200':
          description: PDF report file
          content:
            application/pdf:
              schema:
                type: string
                format: binary
        '402':
          description: Payment Required (x402)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.15'
        protocols:
        - x402: {}
      security:
      - x402: []
      tags:
      - Workflow
components:
  schemas:
    PaymentRequired:
      type: object
      description: x402 v2 payment requirements. Sent base64-encoded JSON in the PAYMENT-REQUIRED response header of a 402. Retry the request with a PAYMENT-SIGNATURE header (v1 X-PAYMENT is also accepted).
      required:
      - x402Version
      - accepts
      properties:
        x402Version:
          type: integer
          enum:
          - 2
        error:
          type: string
        resource:
          type: object
          properties:
            url:
              type: string
            description:
              type: string
            mimeType:
              type: string
        accepts:
          type: array
          items:
            type: object
            required:
            - scheme
            - network
            - amount
            - asset
            - payTo
            properties:
              scheme:
                type: string
                example: exact
              network:
                type: string
                example: eip155:8453
                description: CAIP-2 network id (Base mainnet)
              amount:
                type: string
                description: Atomic units of asset (USDC has 6 decimals)
              asset:
                type: string
                description: Token contract address
              payTo:
                type: string
              maxTimeoutSeconds:
                type: integer
              extra:
                type: object
                additionalProperties: true
        extensions:
          type: object
          additionalProperties: true
  securitySchemes:
    x402:
      type: apiKey
      name: X-Payment
      in: header
      description: Base64 encoded x402 payment payload signed by the agent wallet.