vibesprings-net Defi Yields API

openapi: 3.2.0
info:
  title: Vibe Springs Defi Yields 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: Defi Yields
paths:
  /api/defi-yields:
    get:
      operationId: getDefiYields
      summary: Aggregated DeFi yield scanner powered by DefiLlama
      parameters:
      - name: token
        in: query
        required: false
        schema:
          type: string
          default: USDC
        description: 'Token symbol to filter by (e.g. ''USDC'', ''ETH'', ''WBTC''). Default: ''USDC''.'
      - name: chain
        in: query
        required: false
        schema:
          type: string
        description: Chain to filter by (e.g. 'base', 'ethereum', 'arbitrum', 'optimism'). Omit for all chains.
      - name: min_tvl
        in: query
        required: false
        schema:
          type: string
          default: '100000'
        description: 'Minimum TVL in USD (e.g. ''100000''). Default: 100000.'
      - name: limit
        in: query
        required: false
        schema:
          type: string
          default: '20'
        description: 'Max results to return (1-50). Default: 20.'
      - name: sort
        in: query
        required: false
        schema:
          type: string
          default: apy
        description: 'Sort by: ''apy'', ''tvl'', or ''protocol''. Default: ''apy''.'
      responses:
        '200':
          description: List of yield opportunities
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefiYieldsResponse'
        '402':
          description: Payment Required (x402)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.06'
        protocols:
        - x402: {}
      security:
      - x402: []
      tags:
      - Defi Yields
components:
  schemas:
    DefiYieldsResponse:
      type: object
      properties:
        count:
          type: integer
        filters:
          type: object
          properties:
            token:
              type: string
            chain:
              type:
              - string
              - 'null'
            min_tvl:
              type: integer
        yields:
          type: array
          items:
            type: object
            properties:
              protocol:
                type: string
              chain:
                type: string
              pool:
                type: string
              symbol:
                type: string
              apy:
                type: number
              apyBase:
                type:
                - number
                - 'null'
              apyReward:
                type:
                - number
                - 'null'
              tvl:
                type: number
              tvlFormatted:
                type: string
              riskLevel:
                type: string
              poolType:
                type: string
              url:
                type: string
        source:
          type: string
        processingTime:
          type: string
    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.