openapi: "3.0.3"
info:
  title: "Web3 Identity API"
  description: "**⚠️ DISCLAIMER:** Data provided \"as is\" without warranty. Not financial advice. Always verify critical data independently. See [Terms of Service](https://docs.web3identity.com/legal/terms).\n\n---\n\n**1,634 API endpoints** for Web3 identity, social graphs, DeFi analytics, token prices, wallet security, and blockchain data.\n\nENS, Farcaster, Lens, DeFi (TVL, yields, protocols), market data, chains, bridges, stablecoins, perps,  lending, DEXes, NFTs, L2s, and utilities.\n\n## Payment\nUses x402 protocol for micropayments. Pay per request with USDC on Base network.\n\n## Free Tier\n- 13+ always-free endpoints (health, demo, docs, etc.)\n- 100 free calls/day on all endpoints\n- SIWE authentication doubles free tier to 200/day\n\n## SDK\n```bash\nnpm install @atv-eth/x402-sdk\n```\n\n## Links\n- [📚 Documentation](https://docs.web3identity.com) — Guides, tutorials, and concepts\n- [🔧 API Reference](https://api.web3identity.com/docs) — Interactive Swagger UI\n- [📦 npm SDK](https://www.npmjs.com/package/@atv-eth/x402-sdk) — JavaScript/TypeScript SDK\n- [📬 Postman Collection](https://api.web3identity.com/postman/Web3-Identity-API.postman_collection.json)\n- [🤖 ATV.eth](https://atv.eth.limo) — About the builder\n"
  version: "2.9.0"
  x-spec-sha: "db3c50950fe6e0d3"
  x-spec-generated-at: "2026-02-19T03:31:29.000Z"
  x-spec-source: "e7fa7ed"
  contact:
    name: "ATV.eth"
    email: "atv@web3domains.com"
    url: "https://atv.eth.limo"
  license:
    name: "MIT"
    url: "https://opensource.org/licenses/MIT"
servers:
  - url: "https://api.web3identity.com"
    description: "Production"
externalDocs:
  description: "Full documentation, guides, and tutorials"
  url: "https://docs.web3identity.com"
tags:
  - name: "Free"
    description: "Always free endpoints (10)"
  - name: "ENS"
    description: "ENS resolution, profiles, availability (25+)"
  - name: "Farcaster"
    description: "Farcaster profiles, casts, channels (25+)"
  - name: "DeFi"
    description: "TVL, yields, protocols, stablecoins (80+)"
  - name: "Prices"
    description: "Token prices and market data (45+)"
  - name: "Wallet"
    description: "Balances, transactions, NFTs (20+)"
  - name: "Security"
    description: "Risk scores, contract verification (15+)"
  - name: "L2"
    description: "Layer 2 data, gas prices, bridges (25+)"
  - name: "NFT"
    description: "Collections, rarity, activity (15+)"
  - name: "Protocol"
    description: "Individual protocol stats (15+)"
  - name: "Chain"
    description: "Chain-specific data and gas (15+)"
  - name: "Alchemy"
    description: "Enhanced Alchemy endpoints (12)"
  - name: "Utilities"
    description: "Conversions and helpers (20+)"
  - name: "Social"
    description: "Social graphs, reputation, POAPs (15+)"
  - name: "Auth"
    description: "SIWE authentication (4)"
  - name: "Subnames"
    description: "ENS subname registration and management (20+)"
  - name: "CCIP"
    description: "ERC-3668 CCIP-Read gateway for off-chain ENS resolution"
  - name: "Agent"
    description: "AI agent identity registration and discovery (6)"
  - name: "OAuth"
    description: "OAuth2/OIDC bridge for enterprise SSO integration (10)"
  - name: "TwoFactor"
    description: "2FA/MFA management - TOTP, WebAuthn/Passkeys, Recovery (17)"
  - name: "Status"
    description: "System status, health history, and logging (3)"
  - name: "Subscribe"
    description: "Email subscription management for status updates (3)"
  - name: "Admin"
    description: "Administrative endpoints for platform management (43)"
security:
  - {}
  - ApiKeyAuth: []
  - X402Payment: []
  - SiweAuth: []
paths:
  /.well-known/x402:
    get:
      summary: "x402 Payment Configuration"
      operationId: "getX402Config"
      tags:
        - "Free"
        - "Payment"
      description: "Returns x402 payment configuration for automated payment clients.\n\n### Response Includes\n- Receiver wallet address\n- Supported network (Base)\n- Supported asset (USDC)\n- Facilitator URL\n\n### Used By\n- x402 SDK clients\n- Payment automation tools\n- Wallet integrations"
      responses:
        "200":
          description: "Payment configuration"
          content:
            application/json:
              example:
                receiver: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                network: "base"
                asset: "USDC"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
              schema:
                type: "object"
                properties:
                  accepts:
                    type: "array"
                    items:
                      type: "object"
                  facilitator:
                    type: "string"
                  network:
                    type: "string"
        "400":
          description: "Bad Request - Invalid parameters or malformed request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Invalid parameter format"
                code: "INVALID_PARAMETER"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
  /api/abi/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Get verified contract ABI"
      operationId: "getapiAbi"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                abi:
                  - type: "function"
                    name: "transfer"
                    inputs:
                      - name: "to"
                        type: "address"
                      - name: "amount"
                        type: "uint256"
                    outputs:
                      - name: "success"
                        type: "bool"
                verified: true
                contractName: "ERC20"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/active-users:
    get:
      tags:
        - "Utilities"
      summary: "Active users by chain"
      operationId: "getapiActiveusers"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - chain: "Ethereum"
                    activeUsers24h: 456789
                    activeUsers7d: 1234567
                  - chain: "Polygon"
                    activeUsers24h: 234567
                    activeUsers7d: 987654
                  - chain: "BSC"
                    activeUsers24h: 345678
                    activeUsers7d: 1098765
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/address/age/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Address age (first tx)"
      operationId: "getapiAddressAge"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/WalletOverview"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/address/batch/type:
    get:
      tags:
        - "Utilities"
      summary: "Batch address types"
      operationId: "batchAddressType"
      x-price: "$0.02"
      parameters:
        - name: "addresses"
          in: "query"
          required: true
          description: "Comma-separated Ethereum addresses"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain network (ethereum, base, polygon, etc)"
          example: "ethereum"
      responses:
        "200":
          description: "Results"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Wallet"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/address/batch/validate:
    get:
      tags:
        - "Utilities"
      summary: "Batch validate addresses"
      operationId: "batchValidate"
      x-price: "$0.02"
      parameters:
        - name: "addresses"
          in: "query"
          required: true
          description: "Comma-separated Ethereum addresses"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Results"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Wallet"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/address/checksum/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Checksum address"
      operationId: "checksumAddressApi"
      x-price: "$0.005"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Checksum"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Wallet"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/address/code/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Contract code info"
      operationId: "getAddressCode"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain network (ethereum, base, polygon, etc)"
          example: "ethereum"
      responses:
        "200":
          description: "Code"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Wallet"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/address/iscontract/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Is contract check"
      operationId: "isContract"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain network (ethereum, base, polygon, etc)"
          example: "ethereum"
      responses:
        "200":
          description: "Result"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Wallet"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/address/type/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Address type (EOA/contract)"
      operationId: "getapiAddressType"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/WalletOverview"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Identify address type (EOA, contract, Safe)"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/address/validate/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Validate address"
      operationId: "validateAddressApi"
      x-price: "$0.005"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Validation"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Wallet"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/age/{address}:
    get:
      tags:
        - "Wallet"
      summary: "Wallet age and first transaction"
      operationId: "getapiAge"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AddressAgeResponse"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                firstTransaction: "2016-07-30T13:12:42.000Z"
                age:
                  days: 3490
                  years: 9.56
                firstTxHash: "0x2910543af39aba0cd09dbb2d50200b3e800a63d867b7f53b7e148d216d269fd2"
                blockNumber: 46147
                source: "etherscan"
                timestamp: "2026-02-18T04:30:00.000Z"
          x-example-source: "synthetic"
          x-example-reason: "Etherscan V1 API deprecated. Real data requires Etherscan V2 or direct RPC calls. Example based on route implementation."
          x-example-captured-at: null
        "503":
          description: "Service Unavailable - Etherscan V1 API deprecated"
          content:
            application/json:
              example:
                error: true
                code: "AGE_ERROR"
                message: "Invalid response from Etherscan API"
                timestamp: "2026-02-18T04:28:17.060Z"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      description: "Get Ethereum address age based on first transaction timestamp.\n\n⚠️ **DEPRECATED:** This endpoint currently returns 503 due to Etherscan V1 API deprecation (upstream dependency). \nThe endpoint may be restored in a future version if an alternative data provider (Etherscan V2, direct RPC, or indexer) is integrated.\n\n**Current Status:** Returns 503 Service Unavailable\n**Reason:** Etherscan V1 API has been deprecated by the provider\n**Alternative:** Use direct RPC calls to fetch first transaction or wait for provider migration"
      deprecated: true
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/aggregators:
    get:
      tags:
        - "DeFi"
      summary: "DEX aggregator volumes"
      operationId: "getapiAggregators"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AggregatorData"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/airdrops:
    get:
      tags:
        - "DeFi"
      summary: "Recent/upcoming airdrops"
      operationId: "getapiAirdrops"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/alchemy/balances/{address}:
    get:
      tags:
        - "Alchemy"
      summary: "All ERC20 token balances"
      operationId: "getapiAlchemyBalances"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Token balances for the address"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyBalancesResponse"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                chain: "ethereum"
                balances:
                  - contractAddress: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                    tokenBalance: "0x00000000000000000000000000000000000000000000001b1ae4d6e2ef500000"
                  - contractAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
                    tokenBalance: "0x000000000000000000000000000000000000000000002a5a058fc295ed000000"
                source: "alchemy"
                timestamp: "2026-02-18T01:37:53.596Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/alchemy/collection/{contract}:
    get:
      tags:
        - "Alchemy"
      summary: "NFT collection metadata"
      operationId: "getapiAlchemyCollection"
      x-price: "$0.01"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "NFT collection contract address"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
      responses:
        "200":
          description: "Collection metadata"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyCollectionResponse"
              example:
                contract: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                chain: "ethereum"
                name: "BoredApeYachtClub"
                symbol: "BAYC"
                totalSupply: 10000
                source: "alchemy"
                timestamp: "2026-02-18T01:38:00.695Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/alchemy/contracts/{address}:
    get:
      tags:
        - "Alchemy"
      summary: "Contracts deployed by address"
      description: "Get contracts deployed by an Ethereum address"
      operationId: "getapiAlchemyContracts"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
      responses:
        "200":
          description: "Contract metadata"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyContractsResponse"
              example:
                address: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                chain: "ethereum"
                source: "alchemy"
                timestamp: "2026-02-18T02:09:01.578Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/alchemy/floor/{contract}:
    get:
      tags:
        - "Alchemy"
      summary: "NFT collection floor price"
      operationId: "getapiAlchemyFloor"
      x-price: "$0.01"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "NFT collection contract address"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
      responses:
        "200":
          description: "Floor price data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyFloorPriceResponse"
              example:
                contract: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                chain: "ethereum"
                floorPrice: 15.5
                currency: "ETH"
                source: "alchemy"
                timestamp: "2026-02-18T01:38:05.749Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/alchemy/holders/{contract}:
    get:
      tags:
        - "Alchemy"
      summary: "Token/NFT holders count"
      description: "Get holder count for a token or NFT contract"
      operationId: "getapiAlchemyHolders"
      x-price: "$0.02"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Token/NFT contract address"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
      responses:
        "200":
          description: "Holder count data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyHoldersResponse"
              example:
                contract: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                chain: "ethereum"
                source: "alchemy"
                timestamp: "2026-02-18T02:09:01.958Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/alchemy/nft/{contract}/{tokenId}:
    get:
      tags:
        - "Alchemy"
      summary: "Single NFT metadata"
      operationId: "getapiAlchemyNft"
      x-price: "$0.01"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "NFT collection contract address"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
        - name: "tokenId"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Token ID within the collection"
          example: "1"
      responses:
        "200":
          description: "NFT metadata"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyNFTResponse"
              example:
                contract: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                tokenId: "1"
                chain: "ethereum"
                name: "Bored Ape Yacht Club"
                description: "The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs"
                image: "https://ipfs.io/ipfs/QmRRPWG96cmgTn2qSzjwr2qvfNEuhunv6FNeMFGa9bx6mQ"
                attributes:
                  - trait_type: "Background"
                    value: "Orange"
                source: "alchemy"
                timestamp: "2026-02-18T01:38:05.825Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/alchemy/nfts/{address}:
    get:
      tags:
        - "Alchemy"
      summary: "NFTs owned by address"
      operationId: "getapiAlchemyNfts"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "NFT portfolio"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyNFTsResponse"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                chain: "ethereum"
                nfts: []
                source: "alchemy"
                timestamp: "2026-02-18T01:37:53.596Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/alchemy/owners/{contract}:
    get:
      tags:
        - "Alchemy"
      summary: "NFT collection owners"
      description: "Get owner distribution for an NFT collection"
      operationId: "getapiAlchemyOwners"
      x-price: "$0.02"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "NFT contract address"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
      responses:
        "200":
          description: "NFT owner distribution"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyOwnersResponse"
              example:
                contract: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                chain: "ethereum"
                source: "alchemy"
                timestamp: "2026-02-18T02:09:16.366Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/alchemy/sales/{contract}:
    get:
      tags:
        - "Alchemy"
      summary: "NFT sales history"
      description: "Get recent sales for an NFT contract"
      operationId: "getapiAlchemySales"
      x-price: "$0.02"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "NFT contract address"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
      responses:
        "200":
          description: "NFT sales data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemySalesResponse"
              example:
                contract: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                chain: "ethereum"
                source: "alchemy"
                timestamp: "2026-02-18T02:09:16.700Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/alchemy/spam/{contract}:
    get:
      tags:
        - "Alchemy"
      summary: "Check if contract is spam"
      operationId: "getapiAlchemySpam"
      x-price: "$0.01"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Contract address to check"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
      responses:
        "200":
          description: "Spam classification result"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemySpamResponse"
              example:
                contract: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                chain: "ethereum"
                isSpam: false
                spamClassifications: []
                source: "alchemy"
                timestamp: "2026-02-18T01:38:14.532Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/alchemy/token/{contract}:
    get:
      tags:
        - "Alchemy"
      summary: "ERC20 token metadata"
      operationId: "getapiAlchemyToken"
      x-price: "$0.01"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ERC20 token contract address"
          example: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
      responses:
        "200":
          description: "Token metadata"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyTokenResponse"
              example:
                contract: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                chain: "ethereum"
                metadata:
                  decimals: 18
                  logo: "https://static.alchemyapi.io/images/assets/2396.png"
                  name: "WETH"
                  symbol: "WETH"
                source: "alchemy"
                timestamp: "2026-02-18T01:38:00.621Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/alchemy/transfers/{address}:
    get:
      tags:
        - "Alchemy"
      summary: "Token/NFT transfer history"
      description: "Get transfer history for an address (tokens and NFTs)"
      operationId: "getapiAlchemyTransfers"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Transfer history"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyTransfersResponse"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                chain: "ethereum"
                source: "alchemy"
                timestamp: "2026-02-18T02:09:16.759Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/atv:
    get:
      tags:
        - "Free"
      summary: "ATV agent info"
      operationId: "getATV"
      responses:
        "200":
          description: "Agent information"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ATVInfoResponse"
              example:
                name: "ATV (Agent Trust Vector)"
                role: "Autonomous trust & verification validator"
                wallet: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                ens: "atv.eth"
                erc8004:
                  base: true
                  mainnet: true
                channels:
                  telegram: "@ATV_claw_bot"
                  email: "atv@web3domains.com"
                  twitter: "@ATV_eth"
                  xmtp: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                api:
                  baseUrl: "https://api.web3identity.com"
                  endpoints: 1027
                  version: "2.8.0"
                operator: "GaryPalmerJr.eth"
                timestamp: "2026-02-18T04:28:17.070Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get ATV (Agent Trust Vector) information and contact channels"
  /api/auth/logout:
    post:
      tags:
        - "Auth"
      summary: "Logout and invalidate session"
      operationId: "logout"
      requestBody:
        required: false
        description: "Optional session token (can use Authorization header instead)"
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/LogoutRequest"
            examples:
              with-token:
                summary: "Logout with token in body"
                value:
                  sessionToken: "EXAMPLE_SESSION_TOKEN_12345"
      responses:
        "200":
          description: "Successfully logged out"
          content:
            application/json:
              schema:
                type: "object"
                required:
                  - "success"
                  - "timestamp"
                properties:
                  success:
                    type: "boolean"
                    description: "Whether logout was successful"
                  message:
                    type: "string"
                    description: "Status message"
                  timestamp:
                    type: "string"
                    format: "date-time"
              example:
                success: true
                message: "Session invalidated"
                timestamp: "2026-02-18T00:35:41.007Z"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Invalidate current session"
  /api/auth/nonce:
    post:
      tags:
        - "Auth"
      summary: "Get nonce for SIWE"
      description: "Get a nonce and pre-built SIWE message for wallet authentication.\n\nThe response includes a ready-to-sign message that the client can display to the user.\nOptionally provide domain/uri for IPFS gateway or eth.limo support.\n"
      operationId: "getAuthNonce"
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: "object"
              properties:
                address:
                  type: "string"
                  description: "Wallet address (for pre-built message)"
                  example: "0x701B4937e6c943789ffA74CC8601813b2D87B454"
                domain:
                  type: "string"
                  description: "Custom domain for SIWE message"
                  example: "aboutme.eth.limo"
                uri:
                  type: "string"
                  description: "Custom URI for SIWE message"
                  example: "https://aboutme.eth.limo"
      responses:
        "200":
          description: "Nonce for signing"
          content:
            application/json:
              schema:
                type: "object"
              examples:
                standard:
                  summary: "Fresh SIWE nonce and message"
                  value:
                    nonce: "a7b3c9d2e5f8g1h4j6k8m0n2p4q7r9s2"
                    message: "api.web3identity.com wants you to sign in with your Ethereum account:\n0x983110309620D911731Ac0932219af06091b6744\n\nSign in to Web3 Identity API\n\nURI: https://api.web3identity.com\nVersion: 1\nChain ID: 1\nNonce: a7b3c9d2e5f8g1h4j6k8m0n2p4q7r9s2\nIssued At: 2026-02-12T21:15:00Z\nExpiration Time: 2026-02-12T21:30:00Z"
                    expiresAt: "2026-02-12T21:30:00Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
  /api/auth/session:
    get:
      tags:
        - "Auth"
      summary: "Get current session"
      operationId: "getSession"
      responses:
        "200":
          description: "Session info"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthSessionResponse"
              example:
                authenticated: false
                message: "No valid session found"
                timestamp: "2026-02-18T04:28:17.083Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current authentication session status"
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/verify:
    post:
      tags:
        - "Auth"
      summary: "Verify SIWE signature"
      description: "Verify SIWE signature and create authenticated session"
      operationId: "verifyAuth"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/AuthVerifyRequest"
      responses:
        "200":
          description: "Session token"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuthVerifyResponse"
              example:
                success: true
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                chainId: 1
                accessToken: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhZGRyZXNzIjoiMHhkOGRhNmJmMjY5NjRhZjlkN2VlZDllMDNlNTM0MTVkMzdhYTk2MDQ1IiwiY2hhaW5JZCI6MSwiaWF0IjoxNzM5ODQyMjAwLCJleHAiOjE3Mzk4NDU4MDB9.SYNTHETIC_TOKEN_SIGNATURE"
                refreshToken: "rt_1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
                expiresIn: 3600
                requiresTwoFactor: false
                timestamp: "2026-02-18T04:30:00.000Z"
          x-example-source: "synthetic"
          x-example-reason: "Requires valid SIWE message and signature. Synthetic tokens demonstrate JWT structure without exposing real credentials."
          x-example-captured-at: null
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
  /api/auth/2fa/status:
    get:
      tags:
        - "TwoFactor"
      summary: "Get 2FA status for authenticated user"
      operationId: "get2FAStatus"
      description: "Retrieve current 2FA (two-factor authentication) status including TOTP and WebAuthn enablement for the authenticated user"
      security:
        - SiweAuth: []
      responses:
        "200":
          description: "2FA settings"
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  enabled:
                    type: "boolean"
                  totpEnabled:
                    type: "boolean"
                  webauthnEnabled:
                    type: "boolean"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request - Invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "401":
          description: "Unauthorized"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited - Too many requests"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
  /api/auth/2fa/verify/totp:
    post:
      tags:
        - "TwoFactor"
      summary: "Verify TOTP code during login"
      description: "Verifies TOTP code. With pendingToken, completes auth and returns tokens."
      operationId: "verify2FATOTP"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: "object"
              required:
                - "address"
                - "code"
              properties:
                address:
                  type: "string"
                code:
                  type: "string"
                  pattern: "^[0-9]{6}$"
                pendingToken:
                  type: "string"
      responses:
        "200":
          description: "Verification successful with auth tokens if pendingToken provided"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request - Invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "401":
          description: "Invalid code or expired token"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited - Too many requests"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
  /api/auth/2fa/verify/recovery:
    post:
      tags:
        - "TwoFactor"
      summary: "Verify recovery code during login"
      description: "Use one-time recovery code. Returns remaining count."
      operationId: "verify2FARecovery"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: "object"
              required:
                - "address"
                - "code"
              properties:
                address:
                  type: "string"
                code:
                  type: "string"
                pendingToken:
                  type: "string"
      responses:
        "200":
          description: "Verified with remaining code count"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request - Invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "401":
          description: "Invalid code"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited - Too many requests"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
  /api/avatar/{name}:
    get:
      tags:
        - "ENS"
      summary: "Get avatar URL for ENS name"
      operationId: "getapiAvatar"
      x-price: "$0.001"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSAvatarResponse"
              example:
                name: "vitalik.eth"
                avatar: "https://metadata.ens.domains/mainnet/avatar/vitalik.eth"
                timestamp: "2026-02-18T04:00:02.901Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      description: "Get ENS avatar URL for a given ENS name"
  /api/balance/{address}:
    get:
      tags:
        - "Wallet"
      summary: "ETH balance across multiple chains"
      operationId: "getapiBalance"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bitcoin/24hrprice:
    get:
      tags:
        - "Prices"
      summary: "Bitcoin 24h weighted average price"
      description: "Get Bitcoin's 24-hour weighted average price from blockchain.info"
      operationId: "getBtc24hrPrice"
      x-price: "$0.01"
      responses:
        "200":
          description: "Bitcoin 24h price"
          content:
            application/json:
              schema:
                type: "object"
                required:
                  - "price24h"
                  - "currency"
                  - "timestamp"
                properties:
                  price24h:
                    type: "number"
                    description: "24-hour weighted average price"
                  currency:
                    type: "string"
                    description: "Price currency"
                    example: "USD"
                  source:
                    type: "string"
                    description: "Data source"
                  timestamp:
                    type: "string"
                    format: "date-time"
              example:
                price24h: 67406.77
                currency: "USD"
                source: "blockchain.info"
                timestamp: "2026-02-18T00:35:49.690Z"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bitcoin/24hrtransactioncount:
    get:
      tags:
        - "Chain"
      summary: "BTC 24h TX count"
      operationId: "getBtc24hTxCount"
      x-price: "$0.01"
      responses:
        "200":
          description: "TX count"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Bitcoin24hTransactionCountResponse"
              example:
                transactionCount24h: 648804
                source: "blockchain.info"
                timestamp: "2026-02-18T04:44:32.149Z"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      description: "Get Bitcoin 24-hour transaction count"
  /api/bitcoin/all:
    get:
      tags:
        - "Prices"
      summary: "All BTC data"
      operationId: "getBtcAll"
      x-price: "$0.02"
      responses:
        "200":
          description: "All data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BitcoinAllResponse"
              example:
                price:
                  usd: 67661.7
                  eur: 57130.83
                  gbp: 49915.53
                network:
                  blockHeight: 937185
                  difficulty: 125864590119494
                  hashrate: 1001082033866
                  hashrateUnit: "GH/s"
                supply:
                  totalBtc: 19991200
                  maxSupply: 21000000
                  percentMined: "95.1962"
                market:
                  marketCap: 1346167025776
                  tradeVolume24h: 372748041.5303999
                source: "blockchain.info"
                timestamp: "2026-02-18T04:44:32.463Z"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      description: "Get comprehensive Bitcoin statistics (price, network, supply, market)"
  /api/bitcoin/avgtxsize:
    get:
      tags:
        - "Chain"
      summary: "BTC avg TX size"
      operationId: "getBtcAvgTxSize"
      x-price: "$0.01"
      responses:
        "200":
          description: "Size"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BitcoinAvgTxSizeResponse"
              example:
                avgTxSize: 893
                unit: "bytes"
                source: "blockchain.info"
                timestamp: "2026-02-18T04:44:32.926Z"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      description: "Get Bitcoin average transaction size"
  /api/bitcoin/avgtxvalue:
    get:
      tags:
        - "Chain"
      summary: "BTC avg TX value"
      operationId: "getBtcAvgTxValue"
      x-price: "$0.01"
      responses:
        "200":
          description: "Value"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BitcoinAvgTxValueResponse"
              example:
                avgTxValue: 5.e-8
                unit: "BTC"
                source: "blockchain.info"
                timestamp: "2026-02-18T04:44:33.292Z"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      description: "Get Bitcoin average transaction value"
  /api/bitcoin/bcperblock:
    get:
      tags:
        - "Chain"
      summary: "BTC block reward"
      operationId: "getBtcBlockReward"
      x-price: "$0.01"
      responses:
        "200":
          description: "Reward"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BitcoinBtcPerBlockResponse"
              example:
                btcPerBlock: 3.e-8
                satoshisPerBlock: 3
                source: "blockchain.info"
                timestamp: "2026-02-18T04:44:33.415Z"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      description: "Get Bitcoin amount mined per block"
  /api/bitcoin/blockcount:
    get:
      tags:
        - "Chain"
      summary: "BTC block height"
      operationId: "getBtcBlockcount"
      x-price: "$0.01"
      responses:
        "200":
          description: "Block height"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BitcoinBlockCountResponse"
              example:
                blockHeight: 937185
                source: "blockchain.info"
                timestamp: "2026-02-18T04:51:00.000Z"
          x-example-source: "synthetic"
          x-example-reason: "Requires x402 payment ($0.001 USDC). Synthetic example demonstrates successful response structure."
          x-example-captured-at: null
        "402":
          description: "Payment Required - x402 micropayment required"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.00 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.001"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      description: "Get current Bitcoin block height"
  /api/bitcoin/difficulty:
    get:
      tags:
        - "Chain"
      summary: "BTC mining difficulty"
      operationId: "getBtcDifficulty"
      x-price: "$0.01"
      responses:
        "200":
          description: "Difficulty"
          content:
            application/json:
              schema:
                type: "object"
              example:
                difficulty: 72345678901234.56
                nextDifficulty: 73456789012345.67
                changePercent: 1.53
                nextAdjustment: 1209600
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bitcoin/eta:
    get:
      tags:
        - "Chain"
      summary: "BTC next block ETA"
      operationId: "getBtcEta"
      x-price: "$0.01"
      responses:
        "200":
          description: "ETA"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BitcoinEtaResponse"
              example:
                eta: -6804.2215
                note: "Estimated time until next block (seconds)"
                source: "blockchain.info"
                timestamp: "2026-02-18T04:51:00.233Z"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      description: "Get estimated time until next Bitcoin block"
  /api/bitcoin/hashrate:
    get:
      tags:
        - "Chain"
      summary: "BTC hashrate"
      operationId: "getBtcHashrate"
      x-price: "$0.01"
      responses:
        "200":
          description: "Hashrate"
          content:
            application/json:
              schema:
                type: "object"
                example:
                  hashrate: 485670000000000
                  unit: "H/s"
              example:
                hashrate: 567890123456789.1
                unit: "TH/s"
                timestamp: 1707393600
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bitcoin/interval:
    get:
      tags:
        - "Chain"
      summary: "BTC block interval"
      operationId: "getBtcInterval"
      x-price: "$0.01"
      responses:
        "200":
          description: "Interval"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BitcoinIntervalResponse"
              example:
                blockInterval: 499.7785
                unit: "seconds"
                source: "blockchain.info"
                timestamp: "2026-02-18T04:51:00.360Z"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      description: "Get average time between Bitcoin blocks"
  /api/bitcoin/latesthash:
    get:
      tags:
        - "Chain"
      summary: "BTC latest hash"
      operationId: "getBtcLatesthash"
      x-price: "$0.01"
      responses:
        "200":
          description: "Hash"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BitcoinLatestHashResponse"
              example:
                latestHash: "00000000000000000000804ea89be39e80ddc0a2e6f1ee45442b277633f27e06"
                source: "blockchain.info"
                timestamp: "2026-02-18T04:51:00.489Z"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      description: "Get hash of the latest Bitcoin block"
  /api/bitcoin/marketcap:
    get:
      tags:
        - "Prices"
      summary: "BTC market cap"
      operationId: "getBtcMarketcap"
      x-price: "$0.01"
      responses:
        "200":
          description: "Market cap"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BitcoinMarketCapResponse"
              example:
                marketCap: 1346167025776
                currency: "USD"
                source: "blockchain.info"
                timestamp: "2026-02-18T04:51:00.000Z"
          x-example-source: "synthetic"
          x-example-reason: "Requires x402 payment ($0.01 USDC). Synthetic example demonstrates successful response structure."
          x-example-captured-at: null
        "402":
          description: "Payment Required - x402 micropayment required"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      description: "Get total Bitcoin market capitalization"
  /api/bitcoin/stats:
    get:
      tags:
        - "Chain"
      summary: "BTC network stats"
      operationId: "getBtcStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
                example:
                  height: 830456
                  difficulty: 72345678901234
                  hashrate: 485670000000000
                  totalbc: 19632456.25
                  nextRetarget: 831456
                  lastBlockTime: 1707774456
              example:
                price: 65432.1
                marketCap: 1287654321098.76
                volume24h: 28901234567.89
                blockHeight: 829456
                hashrate: 567890123456789.1
                difficulty: 72345678901234.56
                transactions24h: 345678
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bitcoin/ticker:
    get:
      tags:
        - "Prices"
      summary: "BTC multi-currency ticker"
      operationId: "getBtcTicker"
      x-price: "$0.01"
      responses:
        "200":
          description: "Ticker"
          content:
            application/json:
              schema:
                type: "object"
              example:
                symbol: "BTC"
                price: 65432.1
                priceChange24h: 1.87
                high24h: 66234.56
                low24h: 64789.12
                volume24h: 28901234567.89
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bitcoin/totalbc:
    get:
      tags:
        - "Chain"
      summary: "BTC total supply"
      operationId: "getBtcTotalSupply"
      x-price: "$0.01"
      responses:
        "200":
          description: "Supply"
          content:
            application/json:
              schema:
                type: "object"
              example:
                totalBtc: 19991190
                totalSatoshis: 1999119000000000
                maxSupply: 21000000
                percentMined: "95.1961"
                source: "blockchain.info"
                timestamp: "2026-02-18T04:53:28.260Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/block/latest:
    get:
      tags:
        - "Chain"
      summary: "Latest block number"
      operationId: "getapiBlockLatest"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                blockNumber: null
                blockHex: "You are using a deprecated V1 endpoint, switch to Etherscan API V2 using https://docs.etherscan.io/v2-migration"
                chain: "ethereum"
                source: "etherscan"
                timestamp: "2026-02-18T04:53:28.458Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/block/{number}:
    get:
      tags:
        - "Chain"
      summary: "Block details"
      operationId: "getapiBlock"
      x-price: "$0.01"
      parameters:
        - name: "number"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Block number"
          example: 19200000
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                number: 937185
                hash: "0xafff2ea2540c11594b7f6dd9d6fea0f53f3dbc61efd6b7baa9b14ee5f6e006d3"
                parentHash: "0x09ae4e7a05bb9a9010139c8959410b5f05981ce9d23284feb7b282157d2208d6"
                timestamp: "2016-02-01T11:55:45.000Z"
                gasUsed: 21000
                gasLimit: 3141592
                baseFeePerGas: null
                transactionCount: 1
                miner: "0xf8b483dba2c3b7176a3da549ad41a48bb3121069"
                source: "etherscan"
                queriedAt: "2026-02-18T04:53:28.611Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridge/activity/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Cross-chain bridge activity"
      operationId: "getapiBridgeActivity"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges:
    get:
      tags:
        - "L2"
      summary: "Cross-chain bridge volumes"
      operationId: "getapiBridges"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/across:
    get:
      tags:
        - "DeFi"
      summary: "Across bridge stats"
      operationId: "getAcross"
      x-price: "$0.01"
      responses:
        "200":
          description: "Across"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/activity/{address}:
    get:
      tags:
        - "DeFi"
      summary: "Bridge activity for address"
      operationId: "getBridgeActivity"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Activity"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/chain/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "Bridges by chain"
      operationId: "getBridgesByChainApi"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Chain bridges"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/ethereum-arbitrum:
    get:
      tags:
        - "DeFi"
      summary: "ETH to Arbitrum bridges"
      operationId: "getEthArbBridges"
      x-price: "$0.01"
      responses:
        "200":
          description: "Routes"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/ethereum-base:
    get:
      tags:
        - "DeFi"
      summary: "ETH to Base bridges"
      operationId: "getEthBaseBridges"
      x-price: "$0.01"
      responses:
        "200":
          description: "Routes"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/ethereum-optimism:
    get:
      tags:
        - "DeFi"
      summary: "ETH to Optimism bridges"
      operationId: "getEthOpBridges"
      x-price: "$0.01"
      responses:
        "200":
          description: "Routes"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/ethereum-polygon:
    get:
      tags:
        - "DeFi"
      summary: "ETH to Polygon bridges"
      operationId: "getEthPolyBridges"
      x-price: "$0.01"
      responses:
        "200":
          description: "Routes"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/hop:
    get:
      tags:
        - "DeFi"
      summary: "Hop bridge stats"
      operationId: "getHop"
      x-price: "$0.01"
      responses:
        "200":
          description: "Hop"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/large-txs:
    get:
      tags:
        - "DeFi"
      summary: "Large bridge transactions"
      operationId: "getLargeBridgeTxs"
      x-price: "$0.02"
      responses:
        "200":
          description: "Large TXs"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/stargate:
    get:
      tags:
        - "DeFi"
      summary: "Stargate bridge stats"
      operationId: "getStargateBridge"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stargate"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/stats/{timestamp}:
    get:
      tags:
        - "DeFi"
      summary: "Bridge stats at timestamp"
      operationId: "getBridgeStats"
      x-price: "$0.01"
      parameters:
        - name: "timestamp"
          in: "path"
          required: true
          description: "Unix timestamp"
          schema:
            type: "string"
          example: "24h"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/synapse:
    get:
      tags:
        - "DeFi"
      summary: "Synapse bridge stats"
      operationId: "getSynapse"
      x-price: "$0.01"
      responses:
        "200":
          description: "Synapse"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/top:
    get:
      tags:
        - "DeFi"
      summary: "Top bridges by TVL"
      operationId: "getTopBridgesApi"
      x-price: "$0.01"
      responses:
        "200":
          description: "Top bridges"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/wormhole:
    get:
      tags:
        - "DeFi"
      summary: "Wormhole bridge stats"
      operationId: "getWormholeBridge"
      x-price: "$0.01"
      responses:
        "200":
          description: "Wormhole"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/bridges/{id}:
    get:
      tags:
        - "DeFi"
      summary: "Bridge details"
      operationId: "getBridge"
      x-price: "$0.01"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Unique identifier"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Bridge data"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/casts/{identifier}:
    get:
      tags:
        - "Farcaster"
      summary: "Recent Farcaster casts"
      operationId: "getapiCasts"
      x-price: "$0.02"
      parameters:
        - name: "identifier"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Unique identifier"
          example: "dwr.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/casts/0x123 not found"
                timestamp: "2026-02-18T04:53:28.626Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/categories:
    get:
      tags:
        - "Utilities"
      summary: "DeFi categories list"
      operationId: "getapiCategories"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/category/{name}:
    get:
      tags:
        - "Utilities"
      summary: "Protocols by category"
      operationId: "getapiCategory"
      x-price: "$0.01"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                category: "defi"
                totalTvl: 0
                protocols: []
                source: "defillama"
                timestamp: "2026-02-18T04:53:28.903Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/cex/volumes:
    get:
      tags:
        - "Protocol"
      summary: "CEX volume ranking"
      operationId: "getapiCexVolumes"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/cex/{exchange}:
    get:
      tags:
        - "Protocol"
      summary: "CEX details"
      operationId: "getapiCex"
      x-price: "$0.01"
      parameters:
        - name: "exchange"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "exchange"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "CEX_ERROR"
                message: "fetch failed"
                timestamp: "2026-02-18T05:29:01.276Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains:
    get:
      tags:
        - "Free"
        - "Chain"
      summary: "List Supported Chains (Always Free)"
      operationId: "getChains"
      description: "Returns all supported blockchain networks. Always free."
      responses:
        "200":
          description: "List of supported chains"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ChainsResponse"
              example:
                chains:
                  - id: 1
                    name: "Ethereum"
                    symbol: "ETH"
                    type: "L1"
                  - id: 8453
                    name: "Base"
                    symbol: "ETH"
                    type: "L2"
                count: 10
                timestamp: "2026-02-09T06:30:00.000Z"
        "400":
          description: "Bad Request - Invalid parameters or malformed request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Invalid parameter format"
                code: "INVALID_PARAMETER"
        "402":
          description: "Payment Required - x402 micropayment needed for this endpoint"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
  /api/chain/arbitrum:
    get:
      tags:
        - "Chain"
      summary: "Arbitrum chain stats"
      operationId: "getapiChainArbitrum"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "Arbitrum"
                tvl: 7890123456.78
                protocols: 245
                gasPrice: 0.4
                blockTime: 0.25
                tps: 4000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chain/avalanche:
    get:
      tags:
        - "Chain"
      summary: "Avalanche chain stats"
      operationId: "getapiChainAvalanche"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chain/base:
    get:
      tags:
        - "Chain"
      summary: "Base chain stats"
      operationId: "getapiChainBase"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "Base"
                tvl: 2345678901.23
                protocols: 156
                gasPrice: 0.2
                blockTime: 2
                tps: 3000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chain/bsc:
    get:
      tags:
        - "Chain"
      summary: "BSC chain stats"
      operationId: "getapiChainBsc"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chain/fees:
    get:
      tags:
        - "Chain"
      summary: "Chain fees ranking"
      operationId: "getapiChainFees"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chain/optimism:
    get:
      tags:
        - "Chain"
      summary: "Optimism chain stats"
      operationId: "getapiChainOptimism"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "Optimism"
                tvl: 5678901234.56
                protocols: 189
                gasPrice: 0.3
                blockTime: 2
                tps: 2000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chain/polygon:
    get:
      tags:
        - "Chain"
      summary: "Polygon chain stats"
      operationId: "getapiChainPolygon"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "Polygon"
                tvl: 8901234567.89
                protocols: 312
                gasPrice: 120
                blockTime: 2
                tps: 7000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chain/revenue:
    get:
      tags:
        - "Chain"
      summary: "Chain revenue ranking"
      operationId: "getapiChainRevenue"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/aptos/stats:
    get:
      tags:
        - "Chain"
      summary: "Aptos stats"
      operationId: "getAptosStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/arbitrum/stats:
    get:
      tags:
        - "Chain"
      summary: "Arbitrum stats"
      operationId: "getArbitrumStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Arbitrum stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/aurora/stats:
    get:
      tags:
        - "Chain"
      summary: "Aurora stats"
      operationId: "getAuroraStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/avalanche/stats:
    get:
      tags:
        - "Chain"
      summary: "Avalanche stats"
      operationId: "getAvalancheStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Avalanche stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/base/stats:
    get:
      tags:
        - "Chain"
      summary: "Base stats"
      operationId: "getBaseStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Base stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/blast/stats:
    get:
      tags:
        - "Chain"
      summary: "Blast stats"
      operationId: "getBlastStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/bsc/stats:
    get:
      tags:
        - "Chain"
      summary: "BSC stats"
      operationId: "getBscStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "BSC stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/cardano/stats:
    get:
      tags:
        - "Chain"
      summary: "Cardano stats"
      operationId: "getCardanoStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/celo/stats:
    get:
      tags:
        - "Chain"
      summary: "Celo stats"
      operationId: "getCeloStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/cosmos/stats:
    get:
      tags:
        - "Chain"
      summary: "Cosmos stats"
      operationId: "getCosmosStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/cronos/stats:
    get:
      tags:
        - "Chain"
      summary: "Cronos stats"
      operationId: "getCronosStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/ethereum/stats:
    get:
      tags:
        - "Chain"
      summary: "Ethereum stats"
      operationId: "getEthereumStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Ethereum stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "Ethereum"
                tvl: 45234567890.12
                blockHeight: 19234567
                gasPrice: 38
                transactions24h: 1234567
                activeAddresses24h: 456789
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/fantom/stats:
    get:
      tags:
        - "Chain"
      summary: "Fantom stats"
      operationId: "getFantomStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/fees:
    get:
      tags:
        - "Chain"
      summary: "Chain fees overview"
      operationId: "getChainFees"
      x-price: "$0.01"
      responses:
        "200":
          description: "Fees overview"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - chain: "Ethereum"
                    fees24h: 12345678.9
                    avgFee: 5.67
                  - chain: "BSC"
                    fees24h: 567890.12
                    avgFee: 0.23
                  - chain: "Polygon"
                    fees24h: 234567.89
                    avgFee: 0.05
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/gas:
    get:
      tags:
        - "Chain"
      summary: "Gas prices all chains"
      operationId: "getAllGas"
      x-price: "$0.02"
      responses:
        "200":
          description: "Gas prices"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GasPrices"
              example:
                chains:
                  - chain: "ethereum"
                    fast: 45
                    standard: 38
                    slow: 32
                    baseFee: 30
                    unit: "gwei"
                  - chain: "polygon"
                    fast: 150
                    standard: 120
                    slow: 100
                    baseFee: 80
                    unit: "gwei"
                  - chain: "arbitrum"
                    fast: 0.5
                    standard: 0.4
                    slow: 0.3
                    baseFee: 0.2
                    unit: "gwei"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Current gas prices for Ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/gas-price/{chain}:
    get:
      tags:
        - "Chain"
      summary: "Gas price for chain"
      operationId: "getChainGas"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Gas price"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DetailedGasPrices"
              example:
                chain: "ethereum"
                fast:
                  gasPrice: 45
                  maxFee: 50
                  maxPriorityFee: 2
                  estimatedTime: 30
                standard:
                  gasPrice: 38
                  maxFee: 42
                  maxPriorityFee: 1.5
                  estimatedTime: 60
                slow:
                  gasPrice: 32
                  maxFee: 35
                  maxPriorityFee: 1
                  estimatedTime: 180
                baseFee: 30
                timestamp: "2026-02-08T14:30:00.000Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Current gas prices for Ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/gnosis/stats:
    get:
      tags:
        - "Chain"
      summary: "Gnosis stats"
      operationId: "getGnosisStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/injective/stats:
    get:
      tags:
        - "Chain"
      summary: "Injective stats"
      operationId: "getInjectiveStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/l2/fees:
    get:
      tags:
        - "L2"
      summary: "L2 fees comparison"
      operationId: "getL2Fees"
      x-price: "$0.01"
      responses:
        "200":
          description: "L2 fees"
          content:
            application/json:
              schema:
                type: "object"
              example:
                l2s:
                  - name: "Arbitrum"
                    avgFee: 0.15
                    savingsVsL1: "98.5%"
                  - name: "Optimism"
                    avgFee: 0.12
                    savingsVsL1: "98.8%"
                  - name: "Base"
                    avgFee: 0.08
                    savingsVsL1: "99.1%"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/l2/overview:
    get:
      tags:
        - "L2"
      summary: "L2 overview"
      operationId: "getL2Overview"
      x-price: "$0.02"
      responses:
        "200":
          description: "L2 data"
          content:
            application/json:
              schema:
                type: "object"
              example:
                l2s:
                  - name: "Arbitrum"
                    tvl: 7890123456.78
                    tps: 4000
                    gasPrice: 0.4
                    transactions24h: 5678901
                  - name: "Optimism"
                    tvl: 5678901234.56
                    tps: 2000
                    gasPrice: 0.3
                    transactions24h: 3456789
                  - name: "Base"
                    tvl: 2345678901.23
                    tps: 3000
                    gasPrice: 0.2
                    transactions24h: 2345678
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/linea/stats:
    get:
      tags:
        - "Chain"
      summary: "Linea stats"
      operationId: "getLineaStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/mantle/stats:
    get:
      tags:
        - "Chain"
      summary: "Mantle stats"
      operationId: "getMantleStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/mode/stats:
    get:
      tags:
        - "Chain"
      summary: "Mode stats"
      operationId: "getModeStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/near/stats:
    get:
      tags:
        - "Chain"
      summary: "NEAR stats"
      operationId: "getNearStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/optimism/stats:
    get:
      tags:
        - "Chain"
      summary: "Optimism stats"
      operationId: "getOptimismStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Optimism stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/overview:
    get:
      tags:
        - "Chain"
      summary: "Multi-chain overview"
      operationId: "getChainsOverview"
      x-price: "$0.02"
      responses:
        "200":
          description: "Chains overview"
          content:
            application/json:
              schema:
                type: "object"
              example:
                totalTVL: 95678901234.56
                chains:
                  - name: "Ethereum"
                    tvl: 45234567890.12
                    dominance: 47.3
                  - name: "Tron"
                    tvl: 23456789012.34
                    dominance: 24.5
                  - name: "BSC"
                    tvl: 8901234567.89
                    dominance: 9.3
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/polygon/stats:
    get:
      tags:
        - "Chain"
      summary: "Polygon stats"
      operationId: "getPolygonStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Polygon stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/rank/{rank}:
    get:
      tags:
        - "Chain"
      summary: "Chain by TVL rank"
      operationId: "getChainByRank"
      x-price: "$0.01"
      parameters:
        - name: "rank"
          in: "path"
          required: true
          description: "Ranking position or type"
          schema:
            type: "integer"
          example: 10
      responses:
        "200":
          description: "Chain data"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/scroll/stats:
    get:
      tags:
        - "Chain"
      summary: "Scroll stats"
      operationId: "getScrollStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/solana/stats:
    get:
      tags:
        - "Chain"
      summary: "Solana stats"
      operationId: "getSolanaStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Solana stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/sui/stats:
    get:
      tags:
        - "Chain"
      summary: "Sui stats"
      operationId: "getSuiStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/ton/stats:
    get:
      tags:
        - "Chain"
      summary: "TON stats"
      operationId: "getTonStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/tron/stats:
    get:
      tags:
        - "Chain"
      summary: "Tron stats"
      operationId: "getTronStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/zksync/stats:
    get:
      tags:
        - "Chain"
      summary: "zkSync Era stats"
      operationId: "getZkSyncStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/{chain}/balance/{address}:
    get:
      tags:
        - "Chain"
      summary: "Address balance"
      operationId: "getChainBalance"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Balance"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "ethereum"
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                balance:
                  wei: "5234567890123456789"
                  eth: "5.234567890123456789"
                  usd: 16987.45
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/{chain}/block/latest:
    get:
      tags:
        - "Chain"
      summary: "Latest block"
      operationId: "getChainLatestBlock"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Block data"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "ethereum"
                blockNumber: 19234567
                timestamp: 1707393600
                miner: "0x1234567890123456789012345678901234567890"
                gasUsed: 15000000
                gasLimit: 30000000
                baseFee: 30000000000
                transactions: 234
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/{chain}/block/{number}:
    get:
      tags:
        - "Chain"
      summary: "Block by number"
      operationId: "getChainBlock"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
        - name: "number"
          in: "path"
          required: true
          description: "Block number"
          schema:
            type: "string"
          example: 19200000
      responses:
        "200":
          description: "Block data"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/{chain}/protocols:
    get:
      tags:
        - "Chain"
      summary: "Protocols on chain"
      operationId: "getChainProtocols"
      x-price: "$0.02"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Protocols"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "ethereum"
                protocols:
                  - name: "Lido"
                    category: "Liquid Staking"
                    tvl: 23456789012.34
                  - name: "Aave"
                    category: "Lending"
                    tvl: 8901234567.89
                  - name: "Uniswap"
                    category: "DEX"
                    tvl: 5678901234.56
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/{chain}/stats:
    get:
      tags:
        - "Chain"
      summary: "Chain statistics"
      operationId: "getChainStats"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Chain stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/{chain}/tvl:
    get:
      tags:
        - "Chain"
      summary: "Chain TVL history"
      operationId: "getChainsChainTvl"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "TVL history"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/chains/{chain}/txcount/{address}:
    get:
      tags:
        - "Chain"
      summary: "Transaction count"
      operationId: "getChainTxCount"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "TX count"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/code/{address}:
    get:
      tags:
        - "Chain"
      summary: "Contract bytecode"
      operationId: "getapiCode"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                chain: "ethereum"
                isContract: true
                codeSize: 3124
                timestamp: "2026-02-18T05:29:01.420Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/compare/dex:
    get:
      tags:
        - "Utilities"
      summary: "Compare DEX volume across chains"
      operationId: "getapiCompareDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/compare/gas:
    get:
      tags:
        - "Utilities"
      summary: "Compare gas across chains"
      operationId: "getapiCompareGas"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GasPrices"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Current gas prices for Ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/compare/tvl:
    get:
      tags:
        - "Utilities"
      summary: "Compare TVL across chains"
      operationId: "getapiCompareTvl"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/contract/code/{address}:
    get:
      tags:
        - "Chain"
      summary: "Check if address is contract and get code size"
      operationId: "getapiContractCode"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                chain: "ethereum"
                hasCode: true
                codeSize: 3124
                codeHash: "0x6060604052600436106100af576000357c010000000000000000000000000000..."
                timestamp: "2026-02-18T05:29:01.546Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/contract/source/{address}:
    get:
      tags:
        - "Chain"
      summary: "Verified contract source"
      operationId: "getapiContractSource"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_VERIFIED"
                message: "Contract source code not available"
                timestamp: "2026-02-18T05:29:01.749Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/contract/verify/{address}:
    get:
      tags:
        - "Chain"
      summary: "Contract verification status"
      operationId: "getapiContractVerify"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                chain: "ethereum"
                contractName: null
                compiler: null
                optimization: null
                license: null
                source: "etherscan"
                timestamp: "2026-02-18T05:29:01.811Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/contract/{address}:
    get:
      tags:
        - "Chain"
      summary: "Contract info and verification status"
      operationId: "getapiContract"
      x-price: "$0.03"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/contract/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 not found"
                timestamp: "2026-02-18T05:32:23.671Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/convert/btc/multi:
    get:
      tags:
        - "Utilities"
      summary: "BTC to multiple currencies"
      operationId: "convertBtcMulti"
      x-price: "$0.01"
      parameters:
        - name: "amount"
          in: "query"
          schema:
            type: "number"
          description: "Amount in token units or USD"
          example: 1
      responses:
        "200":
          description: "Conversions"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "RATE_NOT_FOUND"
                message: "Cannot convert btc to multi"
                timestamp: "2026-02-18T05:32:23.763Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/convert/btc/usd:
    get:
      tags:
        - "Utilities"
      summary: "BTC to USD"
      operationId: "convertBtcUsd"
      x-price: "$0.01"
      parameters:
        - name: "amount"
          in: "query"
          schema:
            type: "number"
          description: "Amount in token units or USD"
          example: 1
      responses:
        "200":
          description: "Conversion"
          content:
            application/json:
              schema:
                type: "object"
              example:
                from: "BTC"
                to: "USD"
                amount: 1
                rate: 67700
                result: 67700
                source: "coingecko"
                timestamp: "2026-02-18T05:32:23.833Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/convert/eth/usd:
    get:
      tags:
        - "Utilities"
      summary: "ETH to USD"
      operationId: "getapiConvertEthtousd"
      x-price: "$0.01"
      parameters:
        - name: "amount"
          in: "query"
          required: true
          schema:
            type: "string"
          description: "Amount value"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                from: "ETH"
                to: "USD"
                amount: 1
                rate: 1997.24
                result: 1997.24
                source: "coingecko"
                timestamp: "2026-02-18T05:33:21.597Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/convert/eth/btc:
    get:
      tags:
        - "Utilities"
      summary: "ETH to BTC"
      operationId: "convertEthBtc"
      x-price: "$0.01"
      parameters:
        - name: "amount"
          in: "query"
          schema:
            type: "number"
          description: "Amount in token units or USD"
          example: 1
      responses:
        "200":
          description: "Conversion"
          content:
            application/json:
              schema:
                type: "object"
              example:
                from: "ETH"
                to: "BTC"
                amount: 1
                rate: 0.02949831
                result: 0.02949831
                source: "coingecko"
                timestamp: "2026-02-18T05:32:23.904Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/convert/eth/multi:
    get:
      tags:
        - "Utilities"
      summary: "ETH to multiple currencies"
      operationId: "convertEthMulti"
      x-price: "$0.01"
      parameters:
        - name: "amount"
          in: "query"
          schema:
            type: "number"
          description: "Amount in token units or USD"
          example: 1
      responses:
        "200":
          description: "Conversions"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "RATE_NOT_FOUND"
                message: "Cannot convert eth to multi"
                timestamp: "2026-02-18T05:32:23.975Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/convert/gwei/eth:
    get:
      tags:
        - "Utilities"
      summary: "Gwei conversions"
      operationId: "getapiConvertGwei"
      x-price: "$0.01"
      parameters:
        - name: "amount"
          in: "query"
          required: true
          schema:
            type: "string"
          description: "Amount value"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "RATE_NOT_FOUND"
                message: "Cannot convert gwei to eth"
                timestamp: "2026-02-18T05:33:21.666Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "sunset"
      x-deprecated-at: "2026-02-19"
      x-sunset-date: "2026-08-01"
      x-replacement-operationId: "convertCurrency"
  /api/convert/rates:
    get:
      tags:
        - "Utilities"
      summary: "Exchange rates"
      operationId: "getExchangeRates"
      x-price: "$0.01"
      responses:
        "200":
          description: "Rates"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/convert/sol/usd:
    get:
      tags:
        - "Utilities"
      summary: "SOL to USD"
      operationId: "convertSolUsd"
      x-price: "$0.01"
      parameters:
        - name: "amount"
          in: "query"
          schema:
            type: "number"
          description: "Amount in token units or USD"
          example: 1
      responses:
        "200":
          description: "Conversion"
          content:
            application/json:
              schema:
                type: "object"
              example:
                from: "SOL"
                to: "USD"
                amount: 1
                rate: 85.02
                result: 85.02
                source: "coingecko"
                timestamp: "2026-02-18T05:33:21.726Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/convert/usd/eth:
    get:
      tags:
        - "Utilities"
      summary: "USD to ETH"
      operationId: "getapiConvertUsdtoeth"
      x-price: "$0.01"
      parameters:
        - name: "amount"
          in: "query"
          required: true
          schema:
            type: "string"
          description: "Amount value"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                from: "USD"
                to: "ETH"
                amount: 1
                rate: 0.00050926
                result: 0.00050926
                source: "coingecko"
                timestamp: "2026-02-18T05:33:21.801Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "sunset"
      x-deprecated-at: "2026-02-19"
      x-sunset-date: "2026-08-01"
      x-replacement-operationId: "convertCurrency"
  /api/convert/wei/eth:
    get:
      tags:
        - "Utilities"
      summary: "Wei to ETH conversion"
      operationId: "getapiConvertWei"
      x-price: "$0.01"
      parameters:
        - name: "amount"
          in: "query"
          required: true
          schema:
            type: "string"
          description: "Amount value"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                from: "WEI"
                to: "ETH"
                amount: 1
                rate: 1.2463e-8
                result: 1.2463e-8
                source: "coingecko"
                timestamp: "2026-02-18T05:33:21.869Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "sunset"
      x-deprecated-at: "2026-02-19"
      x-sunset-date: "2026-08-01"
      x-replacement-operationId: "convertCurrency"
  /api/convert/{from}/{to}:
    get:
      tags:
        - "Utilities"
      summary: "Currency conversion"
      operationId: "convertCurrency"
      x-price: "$0.01"
      parameters:
        - name: "from"
          in: "path"
          required: true
          description: "Start of date/block range"
          schema:
            type: "string"
          example: "2024-01-01"
        - name: "to"
          in: "path"
          required: true
          description: "End of date/block range"
          schema:
            type: "string"
          example: "2024-12-31"
        - name: "amount"
          in: "query"
          schema:
            type: "number"
          description: "Amount in token units or USD"
          example: 1
      responses:
        "200":
          description: "Conversion"
          content:
            application/json:
              schema:
                type: "object"
              example:
                from: "ETH"
                to: "USD"
                amount: 1
                result: 3245.67
                rate: 3245.67
                timestamp: "2026-02-08T14:30:00.000Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/decode:
    post:
      tags:
        - "Utilities"
      summary: "Decode transaction calldata"
      operationId: "postapiDecode"
      x-price: "$0.05"
      requestBody:
        required: true
        description: "Hex-encoded calldata to decode"
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/DecodeCalldataRequest"
            examples:
              erc20-transfer:
                summary: "ERC-20 transfer calldata"
                value:
                  data: "0xa9059cbb000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa960450000000000000000000000000000000000000000000000056bc75e2d63100000"
              with-abi:
                summary: "With ABI for accurate decoding"
                value:
                  data: "0xa9059cbb000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa960450000000000000000000000000000000000000000000000056bc75e2d63100000"
                  abi:
                    - name: "transfer"
                      type: "function"
                      inputs:
                        - name: "to"
                          type: "address"
                        - name: "amount"
                          type: "uint256"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint POST /api/decode not found"
                timestamp: "2026-02-18T05:40:53.869Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/aave:
    get:
      tags:
        - "Protocol"
      summary: "Aave stats"
      operationId: "getAave"
      x-price: "$0.01"
      responses:
        "200":
          description: "Aave data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                protocol: "Aave"
                tvl: 12345678901.23
                totalBorrowed: 5678901234.56
                totalSupplied: 18024580135.79
                chains:
                  Ethereum:
                    tvl: 8901234567.89
                    supplied: 12345678901.23
                    borrowed: 3456789012.34
                  Polygon:
                    tvl: 2345678901.23
                    supplied: 3456789012.34
                    borrowed: 1234567890.12
                topMarkets:
                  - asset: "USDC"
                    supplied: 5678901234.56
                    borrowed: 2345678901.23
                    supplyAPY: 2.5
                    borrowAPY: 4.8
                  - asset: "ETH"
                    supplied: 3456789012.34
                    borrowed: 1234567890.12
                    supplyAPY: 1.8
                    borrowAPY: 3.2
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/algo-stables:
    get:
      tags:
        - "DeFi"
      summary: "Algorithmic stablecoins"
      operationId: "getAlgoStables"
      x-price: "$0.01"
      responses:
        "200":
          description: "Algo stables"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                stablecoins:
                  - name: "Frax"
                    supply: 678901234.56
                    algorithm: "Fractional"
                    backed: "Partial"
                  - name: "UST (Terra)"
                    supply: 0
                    algorithm: "Algorithmic"
                    status: "Depegged"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/bridges:
    get:
      tags:
        - "DeFi"
      summary: "All bridges"
      operationId: "getBridges"
      x-price: "$0.01"
      responses:
        "200":
          description: "Bridges list"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                bridges:
                  - name: "Across"
                    volume24h: 45678901.23
                    tvl: 234567890.12
                    chains:
                      - "Ethereum"
                      - "Arbitrum"
                      - "Optimism"
                  - name: "Stargate"
                    volume24h: 34567890.12
                    tvl: 567890123.45
                    chains:
                      - "Ethereum"
                      - "Polygon"
                      - "Arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/bridges/chain/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "Bridge volume by chain"
      operationId: "getBridgesByChain"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Chain bridge volume"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/cdp:
    get:
      tags:
        - "DeFi"
      summary: "CDP protocols"
      operationId: "getCdpProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "CDP protocols"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                protocols:
                  - name: "MakerDAO"
                    totalDebt: 5678901234.56
                    collateralRatio: 168.45
                  - name: "Liquity"
                    totalDebt: 987654321.09
                    collateralRatio: 125.67
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/chains:
    get:
      tags:
        - "DeFi"
      summary: "Chain TVL rankings"
      operationId: "getapiDefiChains"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DeFiChainsResponse"
              example:
                chains:
                  - name: "Ethereum"
                    tvl: 52345678901.23
                    tokenSymbol: "ETH"
                  - name: "Binance"
                    tvl: 12345678901.23
                    tokenSymbol: "BNB"
                  - name: "Solana"
                    tvl: 8765432109.87
                    tokenSymbol: "SOL"
                  - name: "Arbitrum"
                    tvl: 4321098765.43
                    tokenSymbol: null
                  - name: "Base"
                    tvl: 3210987654.32
                    tokenSymbol: null
                source: "defillama"
                timestamp: "2026-02-18T01:15:29.681Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/chains/{chain}/tvl:
    get:
      tags:
        - "DeFi"
      summary: "Chain TVL history"
      operationId: "getChainTvlHistory"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "TVL history"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/compound:
    get:
      tags:
        - "Protocol"
      summary: "Compound stats"
      operationId: "getCompound"
      x-price: "$0.01"
      responses:
        "200":
          description: "Compound data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/crosschain:
    get:
      tags:
        - "DeFi"
      summary: "Cross-chain protocols"
      operationId: "getCrosschainProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "Cross-chain protocols"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/curve:
    get:
      tags:
        - "Protocol"
      summary: "Curve stats"
      operationId: "getCurve"
      x-price: "$0.01"
      responses:
        "200":
          description: "Curve data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/derivatives:
    get:
      tags:
        - "DeFi"
      summary: "Derivatives protocols"
      operationId: "getDerivatives"
      x-price: "$0.01"
      responses:
        "200":
          description: "Derivatives"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                protocols:
                  - name: "dYdX"
                    volume24h: 987654321.09
                    openInterest: 2345678901.23
                    type: "perpetuals"
                  - name: "GMX"
                    volume24h: 567890123.45
                    openInterest: 1234567890.12
                    type: "perpetuals"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/dex/volume:
    get:
      tags:
        - "DeFi"
      summary: "DEX volumes"
      operationId: "getDexVolume"
      x-price: "$0.01"
      responses:
        "200":
          description: "DEX volume data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                totalVolume24h: 9876543210.12
                dexes:
                  - name: "Uniswap"
                    volume24h: 1234567890.12
                    share: 12.5
                  - name: "Curve"
                    volume24h: 987654321.09
                    share: 10
                  - name: "PancakeSwap"
                    volume24h: 876543210.98
                    share: 8.9
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/dex/volume/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "DEX volume by chain"
      operationId: "getDexVolumeByChain"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Chain DEX volume"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/farms:
    get:
      tags:
        - "DeFi"
      summary: "Yield farms"
      operationId: "getYieldFarms"
      x-price: "$0.01"
      responses:
        "200":
          description: "Yield farms"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                farms:
                  - protocol: "Curve"
                    pool: "3pool"
                    apy: 8.45
                    tvl: 987654321.09
                    chain: "Ethereum"
                    tokens:
                      - "DAI"
                      - "USDC"
                      - "USDT"
                  - protocol: "Convex"
                    pool: "stETH-ETH"
                    apy: 12.34
                    tvl: 567890123.45
                    chain: "Ethereum"
                    tokens:
                      - "stETH"
                      - "ETH"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/fees/{protocol}:
    get:
      tags:
        - "DeFi"
      summary: "Protocol fees"
      operationId: "getProtocolFees"
      x-price: "$0.01"
      parameters:
        - name: "protocol"
          in: "path"
          required: true
          description: "DeFi protocol identifier"
          schema:
            type: "string"
          example: "aave"
      responses:
        "200":
          description: "Protocol fees"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/gaming:
    get:
      tags:
        - "DeFi"
      summary: "Gaming protocols"
      operationId: "getGamingProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "Gaming protocols"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/indexes:
    get:
      tags:
        - "DeFi"
      summary: "Index protocols"
      operationId: "getIndexProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "Index protocols"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/insurance:
    get:
      tags:
        - "DeFi"
      summary: "Insurance protocols"
      operationId: "getInsurance"
      x-price: "$0.01"
      responses:
        "200":
          description: "Insurance"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                protocols:
                  - name: "Nexus Mutual"
                    tvl: 234567890.12
                    activeCover: 123456789.01
                    capacity: 345678901.23
                  - name: "InsurAce"
                    tvl: 123456789.01
                    activeCover: 67890123.45
                    capacity: 234567890.12
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/launchpads:
    get:
      tags:
        - "DeFi"
      summary: "Launchpad protocols"
      operationId: "getLaunchpads"
      x-price: "$0.01"
      responses:
        "200":
          description: "Launchpads"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/leveraged-farming:
    get:
      tags:
        - "DeFi"
      summary: "Leveraged farming protocols"
      operationId: "getLeveragedFarming"
      x-price: "$0.01"
      responses:
        "200":
          description: "Leveraged farming"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/makerdao:
    get:
      tags:
        - "Protocol"
      summary: "MakerDAO stats"
      operationId: "getMakerDAO"
      x-price: "$0.01"
      responses:
        "200":
          description: "MakerDAO data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                protocol: "MakerDAO"
                tvl: 9876543210.12
                daiSupply: 5678901234.56
                collateralRatio: 168.45
                vaults:
                  - collateralType: "ETH-A"
                    collateral: 3456789012.34
                    debt: 1987654321.09
                    ratio: 174.23
                  - collateralType: "WBTC-A"
                    collateral: 1234567890.12
                    debt: 678901234.56
                    ratio: 181.78
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/nft-lending:
    get:
      tags:
        - "DeFi"
      summary: "NFT lending protocols"
      operationId: "getNftLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "NFT lending"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/options:
    get:
      tags:
        - "DeFi"
      summary: "Options protocols"
      operationId: "getOptionsProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "Options"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                protocols:
                  - name: "Lyra"
                    tvl: 123456789.01
                    volume24h: 23456789.01
                    openInterest: 45678901.23
                  - name: "Hegic"
                    tvl: 98765432.1
                    volume24h: 12345678.9
                    openInterest: 34567890.12
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/prediction:
    get:
      tags:
        - "DeFi"
      summary: "Prediction markets"
      operationId: "getPredictionMarkets"
      x-price: "$0.01"
      responses:
        "200":
          description: "Prediction markets"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/privacy:
    get:
      tags:
        - "DeFi"
      summary: "Privacy protocols"
      operationId: "getPrivacyProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "Privacy protocols"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/protocol/{slug}:
    get:
      tags:
        - "DeFi"
      summary: "Protocol details with TVL history"
      operationId: "getProtocolDetails"
      x-price: "$0.01"
      parameters:
        - name: "slug"
          in: "path"
          required: true
          description: "Protocol slug from /api/defi/protocols"
          schema:
            type: "string"
          example: "aave"
      responses:
        "200":
          description: "Protocol details with historical TVL"
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  name:
                    type: "string"
                  symbol:
                    type: "string"
                  description:
                    type: "string"
                  tvl:
                    type: "array"
                    description: "Historical TVL data points"
                    items:
                      type: "object"
                      properties:
                        date:
                          type: "integer"
                          description: "Unix timestamp"
                        totalLiquidityUSD:
                          type: "number"
                  chains:
                    type: "array"
                    items:
                      type: "string"
                  twitter:
                    type: "string"
                  url:
                    type: "string"
                  source:
                    type: "string"
                  timestamp:
                    type: "string"
                    format: "date-time"
              example:
                name: "Aave"
                symbol: "AAVE"
                description: "Aave is an Open Source and Non-Custodial protocol to earn interest on deposits and borrow assets"
                tvl:
                  - date: 1708214400
                    totalLiquidityUSD: 27800000000
                  - date: 1708128000
                    totalLiquidityUSD: 27650000000
                  - date: 1708041600
                    totalLiquidityUSD: 27500000000
                chains:
                  - "Ethereum"
                  - "Polygon"
                  - "Arbitrum"
                  - "Avalanche"
                twitter: "AaveAave"
                url: "https://aave.com"
                source: "defillama"
                timestamp: "2026-02-18T01:09:04.189Z"
                cached: false
                cachedAt: null
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/protocols:
    get:
      tags:
        - "DeFi"
      summary: "List DeFi protocols"
      operationId: "getapiDefiProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DeFiProtocolsResponse"
              example:
                protocols:
                  - name: "Binance CEX"
                    symbol: "BNB"
                    tvl: 140480523492.66
                    category: "CEX"
                    chains:
                      - "Ethereum"
                      - "Bitcoin"
                      - "Binance"
                      - "Solana"
                      - "Tron"
                    change_24h: -0.89
                    change_7d: 2.09
                  - name: "Aave V3"
                    symbol: "AAVE"
                    tvl: 26567506854.16
                    category: "Lending"
                    chains:
                      - "Ethereum"
                      - "Plasma"
                      - "Base"
                      - "Arbitrum"
                      - "Avalanche"
                    change_24h: -0.46
                    change_7d: -2.8
                count: 100
                total: 7091
                source: "defillama"
                timestamp: "2026-02-18T01:15:29.305Z"
                cached: false
                cachedAt: null
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List all DeFi protocols with TVL"
      parameters:
        - name: "category"
          in: "query"
          schema:
            type: "string"
          description: "Filter by category (lending, dex, bridge)"
          example: "defi"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Filter by chain"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/protocols/category/{category}:
    get:
      tags:
        - "DeFi"
      summary: "Protocols by category"
      operationId: "getProtocolsByCategory"
      x-price: "$0.01"
      parameters:
        - name: "category"
          in: "path"
          required: true
          description: "Category filter"
          schema:
            type: "string"
          example: "defi"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Filter by chain"
          example: "ethereum"
      responses:
        "200":
          description: "Category protocols"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "List all DeFi protocols with TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/revenue/{protocol}:
    get:
      tags:
        - "DeFi"
      summary: "Protocol revenue"
      operationId: "getProtocolRevenue"
      x-price: "$0.01"
      parameters:
        - name: "protocol"
          in: "path"
          required: true
          description: "DeFi protocol identifier"
          schema:
            type: "string"
          example: "aave"
      responses:
        "200":
          description: "Protocol revenue"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/stablecoins:
    get:
      tags:
        - "DeFi"
      summary: "Stablecoin market caps"
      operationId: "getapiDefiStablecoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DeFiStablecoinsResponse"
              example:
                stablecoins:
                  - name: "Tether"
                    symbol: "USDT"
                    pegType: "peggedUSD"
                    circulating: 183738702130.19
                    chains:
                      - "Ethereum"
                      - "Tron"
                      - "Solana"
                      - "Binance"
                      - "Polygon"
                  - name: "USD Coin"
                    symbol: "USDC"
                    pegType: "peggedUSD"
                    circulating: 56789012345.67
                    chains:
                      - "Ethereum"
                      - "Solana"
                      - "Polygon"
                      - "Arbitrum"
                      - "Base"
                  - name: "DAI"
                    symbol: "DAI"
                    pegType: "peggedUSD"
                    circulating: 4567890123.45
                    chains:
                      - "Ethereum"
                      - "Polygon"
                      - "Arbitrum"
                source: "defillama"
                timestamp: "2026-02-18T01:16:10.464Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Stablecoin market data and pegs"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/stablecoins/{asset}:
    get:
      tags:
        - "DeFi"
      summary: "Stablecoin details"
      operationId: "getStablecoin"
      x-price: "$0.01"
      parameters:
        - name: "asset"
          in: "path"
          required: true
          description: "Asset identifier (token symbol or address)"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Stablecoin details"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "USD Coin"
                symbol: "USDC"
                totalSupply: 23456789012.34
                circulatingSupply: 23450000000
                chains:
                  Ethereum: 15678901234.56
                  Polygon: 4567890123.45
                  Arbitrum: 2345678901.23
                price: 1
                pegDeviation: 0.0002
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Stablecoin market data and pegs"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/top-bridges:
    get:
      tags:
        - "DeFi"
      summary: "Top bridges by TVL"
      operationId: "getTopBridges"
      x-price: "$0.01"
      responses:
        "200":
          description: "Top bridges"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                bridges:
                  - rank: 1
                    name: "Across"
                    volume24h: 45678901.23
                    txCount24h: 12345
                  - rank: 2
                    name: "Stargate"
                    volume24h: 34567890.12
                    txCount24h: 9876
                  - rank: 3
                    name: "Synapse"
                    volume24h: 23456789.01
                    txCount24h: 7654
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/top-dexes:
    get:
      tags:
        - "DeFi"
      summary: "Top DEXes by TVL"
      operationId: "getTopDexes"
      x-price: "$0.01"
      responses:
        "200":
          description: "Top DEXes (may be empty if data unavailable)"
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  dexes:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        name:
                          type: "string"
                        slug:
                          type: "string"
                        tvl:
                          type: "number"
                        volume24h:
                          type: "number"
                        chains:
                          type: "array"
                          items:
                            type: "string"
                  source:
                    type: "string"
                  timestamp:
                    type: "string"
                    format: "date-time"
                  cached:
                    type: "boolean"
                  cachedAt:
                    type: "string"
                    format: "date-time"
                    nullable: true
              example:
                dexes: []
                source: "defillama"
                timestamp: "2026-02-18T01:18:49.981Z"
                cached: true
                cachedAt: "2026-02-18T01:15:29.308Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/top-lending:
    get:
      tags:
        - "DeFi"
      summary: "Top lending protocols"
      operationId: "getTopLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Top lending"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                protocols:
                  - rank: 1
                    name: "Aave"
                    tvl: 12345678901.23
                    borrowed: 5678901234.56
                    supplied: 18024580135.79
                  - rank: 2
                    name: "Compound"
                    tvl: 4567890123.45
                    borrowed: 2345678901.23
                    supplied: 6913568024.68
                  - rank: 3
                    name: "JustLend"
                    tvl: 3456789012.34
                    borrowed: 1987654321.09
                    supplied: 5444443333.43
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/top-liquid-staking:
    get:
      tags:
        - "DeFi"
      summary: "Top liquid staking protocols"
      operationId: "getTopLiquidStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Top liquid staking"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                protocols:
                  - rank: 1
                    name: "Lido"
                    tvl: 23456789012.34
                    apy: 3.2
                    token: "stETH"
                  - rank: 2
                    name: "Rocket Pool"
                    tvl: 2345678901.23
                    apy: 3.5
                    token: "rETH"
                  - rank: 3
                    name: "Frax Ether"
                    tvl: 1234567890.12
                    apy: 3.3
                    token: "frxETH"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/top-protocols:
    get:
      tags:
        - "DeFi"
      summary: "Top 20 protocols by TVL"
      operationId: "getTopProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "Top protocols"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DeFiTopProtocolsResponse"
              example:
                top20:
                  - name: "Binance CEX"
                    slug: "binance-cex"
                    tvl: 140480523492.66
                    change24h: -0.89
                    category: "CEX"
                    chains:
                      - "Ethereum"
                      - "Bitcoin"
                      - "Binance"
                      - "Solana"
                      - "Tron"
                  - name: "Aave V3"
                    slug: "aave-v3"
                    tvl: 26567506854.16
                    change24h: -0.46
                    category: "Lending"
                    chains:
                      - "Ethereum"
                      - "Plasma"
                      - "Base"
                      - "Arbitrum"
                      - "Avalanche"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 18904869556.49
                    change24h: -0.22
                    category: "Liquid Staking"
                    chains:
                      - "Ethereum"
                      - "Solana"
                source: "defillama"
                timestamp: "2026-02-18T01:15:29.305Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/tvl:
    get:
      tags:
        - "DeFi"
      summary: "Total TVL across all chains"
      operationId: "getDefiTvl"
      x-price: "$0.01"
      responses:
        "200":
          description: "Total TVL data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DeFiTVLSummary"
              example:
                totalTvl: 96077997634.14
                chainCount: 432
                topChains:
                  - name: "Ethereum"
                    tvl: 52345678901.23
                  - name: "Binance"
                    tvl: 12345678901.23
                  - name: "Solana"
                    tvl: 8765432109.87
                  - name: "Arbitrum"
                    tvl: 4321098765.43
                  - name: "Base"
                    tvl: 3210987654.32
                source: "defillama"
                timestamp: "2026-02-18T01:15:29.681Z"
                cached: false
                cachedAt: null
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Total Value Locked for a protocol"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Filter by chain (ethereum, arbitrum, etc.)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/tvl/categories:
    get:
      tags:
        - "DeFi"
      summary: "TVL by category"
      operationId: "getTvlByCategory"
      x-price: "$0.01"
      responses:
        "200":
          description: "Category TVL"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Total Value Locked for a protocol"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Filter by chain (ethereum, arbitrum, etc.)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/tvl/chain/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "TVL by chain"
      operationId: "getChainTvl"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Chain TVL"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                chain: "Ethereum"
                tvl: 45234567890.12
                protocols:
                  - name: "Lido"
                    tvl: 23456789012.34
                  - name: "Aave"
                    tvl: 12345678901.23
                  - name: "MakerDAO"
                    tvl: 9876543210.12
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Total Value Locked for a protocol"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/tvl/{protocol}:
    get:
      summary: "Get Protocol TVL"
      operationId: "getProtocolTvl"
      tags:
        - "DeFi"
        - "Analytics"
      description: "Get Total Value Locked (TVL) for any DeFi protocol tracked by DefiLlama.\n\n### Supported Protocols\nAave, Uniswap, Lido, MakerDAO, Curve, Compound, and 3000+ more\n\n### Response Includes\n- Current TVL in USD\n- 24h and 7d change\n- TVL breakdown by chain\n- Historical data available\n\n### Pricing\n- **$0.01** per request"
      parameters:
        - name: "protocol"
          in: "path"
          required: true
          description: "Protocol slug (e.g., aave, uniswap, lido)"
          schema:
            type: "string"
            example: "aave"
          example: "aave"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Filter by chain (ethereum, arbitrum, etc.)"
          example: "ethereum"
      responses:
        "200":
          description: "Protocol TVL data"
          content:
            application/json:
              example:
                protocol: "aave"
                name: "Aave"
                tvl: 12500000000
                change24h: 1.5
                category: "Lending"
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                url: "https://aave.com"
              schema:
                $ref: "#/components/schemas/TVLResponse"
        "400":
          description: "Bad Request - Invalid parameters or malformed request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Invalid parameter format"
                code: "INVALID_PARAMETER"
        "402":
          description: "Payment Required - Free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Resource not found"
                code: "NOT_FOUND"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
  /api/defi/uniswap:
    get:
      tags:
        - "Protocol"
      summary: "Uniswap stats"
      operationId: "getUniswap"
      x-price: "$0.01"
      responses:
        "200":
          description: "Uniswap data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                protocol: "Uniswap"
                tvl: 8901234567.89
                volume24h: 1234567890.12
                volume7d: 8901234567.89
                fees24h: 3456789.01
                topPools:
                  - pair: "ETH/USDC"
                    tvl: 987654321.09
                    volume24h: 234567890.12
                    fee: 0.05
                  - pair: "ETH/USDT"
                    tvl: 876543210.98
                    volume24h: 198765432.1
                    fee: 0.05
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/yields:
    get:
      summary: "Get Top DeFi Yields"
      operationId: "getDefiYields"
      tags:
        - "DeFi"
        - "Yields"
      description: "Get top-performing DeFi yield opportunities across all chains.\n\n### Filters Available\n- **chain**: Filter by blockchain\n- **project**: Filter by protocol\n- **minTvl**: Minimum TVL threshold\n- **stablecoin**: Only stablecoin pools\n\n### Response Includes\n- APY (base + reward)\n- TVL\n- Pool composition\n- Risk indicators\n\n### Pricing\n- **$0.01** per request"
      parameters:
        - name: "chain"
          in: "query"
          required: false
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
            example: "ethereum"
          example: "ethereum"
        - name: "limit"
          in: "query"
          required: false
          description: "Maximum number of results to return"
          schema:
            type: "integer"
            default: 20
          example: 10
        - name: "minApy"
          in: "query"
          schema:
            type: "number"
          description: "Minimum APY filter"
          example: 1
        - name: "stablecoin"
          in: "query"
          schema:
            type: "boolean"
          description: "Only stablecoin pools"
          example: true
      responses:
        "200":
          description: "DeFi yield opportunities"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DeFiYieldsResponse"
              example:
                pools:
                  - chain: "Sonic"
                    project: "spectra-v2"
                    symbol: "SDUSD"
                    tvlUsd: 10120
                    apyBase: 747793.01
                    apyReward: 0
                    apy: 747793.01
                    rewardTokens: null
                    pool: "6c4bf68a-2e39-4613-926b-8d63862d9f8f"
                    stablecoin: true
                    ilRisk: "no"
                    exposure: "single"
                  - chain: "Plasma"
                    project: "chateau"
                    symbol: "SCHUSD"
                    tvlUsd: 60861
                    apyBase: 733118.67
                    apyReward: null
                    apy: 733118.67
                    pool: "948fc371-3a60-41c2-a7a3-ab4c4bfeecba"
                    stablecoin: true
                source: "defillama"
                timestamp: "2026-02-18T01:16:10.464Z"
        "400":
          description: "Bad Request - Invalid parameters or malformed request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Invalid parameter format"
                code: "INVALID_PARAMETER"
        "402":
          description: "Payment Required - Free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
  /api/defi/yields/chain/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "Yields by chain"
      operationId: "getYieldsByChain"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
        - name: "minApy"
          in: "query"
          schema:
            type: "number"
          description: "Minimum APY filter"
          example: 1
        - name: "stablecoin"
          in: "query"
          schema:
            type: "boolean"
          description: "Only stablecoin pools"
          example: true
      responses:
        "200":
          description: "Chain yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                chain: "Ethereum"
                pools:
                  - pool: "USDC-USDT"
                    apy: 5.67
                    tvl: 123456789.12
                    protocol: "Curve"
                    ilRisk: "none"
                    stablecoin: true
                  - pool: "ETH-USDC"
                    apy: 8.45
                    tvl: 234567890.23
                    protocol: "Uniswap"
                    ilRisk: "high"
                    stablecoin: false
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "DeFi yield farming opportunities"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/defi/yields/pool/{pool}:
    get:
      tags:
        - "DeFi"
      summary: "Yield pool details with history"
      operationId: "getYieldPool"
      x-price: "$0.01"
      parameters:
        - name: "pool"
          in: "path"
          required: true
          description: "Pool UUID from /api/defi/yields"
          schema:
            type: "string"
          example: "6c4bf68a-2e39-4613-926b-8d63862d9f8f"
      responses:
        "200":
          description: "Pool details with historical APY/TVL"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DeFiYieldPoolDetail"
              example:
                pool: "6c4bf68a-2e39-4613-926b-8d63862d9f8f"
                history:
                  - timestamp: "2026-02-14T01:01:31.730Z"
                    tvlUsd: 10120
                    apy: 747793.01
                    apyBase: 747793.01
                    apyReward: 0
                  - timestamp: "2026-02-13T23:01:56.854Z"
                    tvlUsd: 10133
                    apy: 364921.94
                    apyBase: 364921.94
                    apyReward: 0
                  - timestamp: "2026-02-12T23:01:35.169Z"
                    tvlUsd: 10154
                    apy: 6251.87
                    apyBase: 6251.87
                    apyReward: 0
                source: "defillama"
                timestamp: "2026-02-18T01:16:17.670Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "DeFi yield farming opportunities"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/demo:
    get:
      tags:
        - "Free"
      summary: "Demo endpoint with sample ENS resolution (always free)"
      operationId: "getDemo"
      description: "Demonstrates API capabilities by resolving vitalik.eth. **Always free** - use this to test integration.\n\nReturns a real ENS profile to show what data is available.\n"
      responses:
        "200":
          description: "Demo ENS profile"
          content:
            application/json:
              schema:
                type: "object"
              example:
                demo: true
                name: "vitalik.eth"
                resolved:
                  address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                  avatar: "https://metadata.ens.domains/mainnet/avatar/vitalik.eth"
                note: "This is a free demo. Full profiles available at /api/ens/{name}"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
  /api/dex/aerodrome:
    get:
      tags:
        - "DeFi"
      summary: "Aerodrome DEX"
      operationId: "getAerodromeDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "Aerodrome"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/balancer:
    get:
      tags:
        - "DeFi"
      summary: "Balancer DEX"
      operationId: "getBalancerDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "Balancer"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/baseswap:
    get:
      tags:
        - "DeFi"
      summary: "BaseSwap DEX"
      operationId: "getBaseSwapDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "BaseSwap"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/camelot:
    get:
      tags:
        - "DeFi"
      summary: "Camelot DEX"
      operationId: "getCamelotDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "Camelot"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/compare/top:
    get:
      tags:
        - "DeFi"
      summary: "Top DEX comparison"
      operationId: "getTopDexComparison"
      x-price: "$0.01"
      responses:
        "200":
          description: "Comparison"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/compare/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "DEX comparison by chain"
      operationId: "getDexCompareByChain"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Comparison"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/curve:
    get:
      tags:
        - "Protocol"
      summary: "Curve stats"
      operationId: "getapiDexCurve"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/dodo:
    get:
      tags:
        - "DeFi"
      summary: "DODO DEX"
      operationId: "getDodoDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "DODO"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/hashflow:
    get:
      tags:
        - "DeFi"
      summary: "Hashflow DEX"
      operationId: "getHashflowDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "Hashflow"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/kyberswap:
    get:
      tags:
        - "DeFi"
      summary: "KyberSwap DEX"
      operationId: "getKyberSwapDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "KyberSwap"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/list:
    get:
      tags:
        - "DeFi"
      summary: "DEX list"
      operationId: "getDexList"
      x-price: "$0.01"
      responses:
        "200":
          description: "List"
          content:
            application/json:
              schema:
                type: "object"
              example:
                dexes:
                  - name: "Uniswap"
                    volume24h: 2340000000
                    tvl: 5670000000
                  - name: "Curve"
                    volume24h: 1230000000
                    tvl: 4560000000
                  - name: "PancakeSwap"
                    volume24h: 980000000
                    tvl: 3450000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/maverick:
    get:
      tags:
        - "DeFi"
      summary: "Maverick DEX"
      operationId: "getMaverickDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "Maverick"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/orca:
    get:
      tags:
        - "DeFi"
      summary: "Orca DEX"
      operationId: "getOrcaDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "Orca"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/pancakeswap:
    get:
      tags:
        - "Protocol"
      summary: "PancakeSwap stats"
      operationId: "getapiDexPancakeswap"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/quickswap:
    get:
      tags:
        - "DeFi"
      summary: "QuickSwap DEX"
      operationId: "getQuickSwapDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "QuickSwap"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/raydium:
    get:
      tags:
        - "DeFi"
      summary: "Raydium DEX"
      operationId: "getRaydiumDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "Raydium"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/spiritswap:
    get:
      tags:
        - "DeFi"
      summary: "SpiritSwap DEX"
      operationId: "getSpiritSwapDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "SpiritSwap"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/spookyswap:
    get:
      tags:
        - "DeFi"
      summary: "SpookySwap DEX"
      operationId: "getSpookySwapDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "SpookySwap"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/sushiswap:
    get:
      tags:
        - "Protocol"
      summary: "SushiSwap stats"
      operationId: "getapiDexSushiswap"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/syncswap:
    get:
      tags:
        - "DeFi"
      summary: "SyncSwap DEX"
      operationId: "getSyncSwapDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "SyncSwap"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/thena:
    get:
      tags:
        - "DeFi"
      summary: "Thena DEX"
      operationId: "getThenaDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "Thena"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/traderjoe:
    get:
      tags:
        - "DeFi"
      summary: "Trader Joe DEX"
      operationId: "getTraderJoeDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "Trader Joe"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/uniswap:
    get:
      tags:
        - "Protocol"
      summary: "Uniswap stats"
      operationId: "getapiDexUniswap"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/velodrome:
    get:
      tags:
        - "DeFi"
      summary: "Velodrome DEX"
      operationId: "getVelodromeDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "Velodrome"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/volumes:
    get:
      tags:
        - "Protocol"
      summary: "DEX volume ranking"
      operationId: "getapiDexVolumes"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/volumes/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "DEX volumes by chain"
      operationId: "getDexVolumesByChain"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Volumes"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/woofi:
    get:
      tags:
        - "DeFi"
      summary: "WOOFi DEX"
      operationId: "getWooFiDex"
      x-price: "$0.01"
      responses:
        "200":
          description: "WOOFi"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/dex/{protocol}:
    get:
      tags:
        - "Protocol"
      summary: "DEX protocol stats"
      operationId: "getapiDex"
      x-price: "$0.01"
      parameters:
        - name: "protocol"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Protocol slug"
          example: "aave"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Uniswap"
                volume24h: 2340000000
                tvl: 5670000000
                change24h: 8.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ecosystem/avalanche:
    get:
      tags:
        - "Utilities"
      summary: "Avalanche ecosystem"
      operationId: "getapiEcosystemAvalanche"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/ecosystem/avalanche not found"
                timestamp: "2026-02-18T05:40:53.879Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "sunset"
      x-deprecated-at: "2026-02-19"
      x-sunset-date: "2026-08-01"
  /api/ecosystem/bsc:
    get:
      tags:
        - "Utilities"
      summary: "BSC ecosystem"
      operationId: "getapiEcosystemBsc"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/ecosystem/bsc not found"
                timestamp: "2026-02-18T05:40:53.886Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "sunset"
      x-deprecated-at: "2026-02-19"
      x-sunset-date: "2026-08-01"
  /api/ecosystem/cosmos:
    get:
      tags:
        - "Utilities"
      summary: "Cosmos ecosystem"
      operationId: "getapiEcosystemCosmos"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "sunset"
      x-deprecated-at: "2026-02-19"
      x-sunset-date: "2026-08-01"
  /api/ecosystem/ethereum:
    get:
      tags:
        - "Utilities"
      summary: "Ethereum ecosystem"
      operationId: "getapiEcosystemEthereum"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/ecosystem/ethereum not found"
                timestamp: "2026-02-18T05:40:53.895Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "sunset"
      x-deprecated-at: "2026-02-19"
      x-sunset-date: "2026-08-01"
  /api/ecosystem/solana:
    get:
      tags:
        - "Utilities"
      summary: "Solana ecosystem"
      operationId: "getapiEcosystemSolana"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/ecosystem/solana not found"
                timestamp: "2026-02-18T05:40:53.903Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "sunset"
      x-deprecated-at: "2026-02-19"
      x-sunset-date: "2026-08-01"
  /api/emissions:
    get:
      tags:
        - "DeFi"
      summary: "Protocol emissions"
      operationId: "getapiEmissions"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/available/{name}:
    get:
      summary: "Check ENS Availability"
      operationId: "checkEnsAvailable"
      tags:
        - "Identity"
        - "ENS"
      description: "Check if an ENS name is available for registration.\n\n### Response Includes\n- Availability status\n- If taken: current owner, expiration\n- Registration price estimate\n\n### Pricing\n- **$0.001** per request"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name to check (without .eth)"
          schema:
            type: "string"
            example: "mycoolname"
          example: "vitalik.eth"
      responses:
        "200":
          description: "ENS name availability"
          content:
            application/json:
              example:
                name: "example.eth"
                available: true
                registrationPrice: "0.003 ETH"
                premium: false
              schema:
                type: "object"
                properties:
                  name:
                    type: "string"
                  available:
                    type: "boolean"
                  timestamp:
                    type: "string"
                  currentExpiry:
                    type: "string"
                    description: "Current expiration timestamp if name is registered"
                  registrationCost:
                    type: "string"
                    description: "Estimated registration cost in USD"
        "400":
          description: "Bad Request - Invalid parameters or malformed request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Invalid parameter format"
                code: "INVALID_PARAMETER"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Resource not found"
                code: "NOT_FOUND"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
  /api/ens/avatar/{name}:
    get:
      summary: "Get ENS Avatar URL"
      operationId: "getEnsAvatar"
      tags:
        - "Identity"
        - "ENS"
      description: "Get the avatar URL for an ENS name.\n\n### Supports\n- Direct URL avatars\n- NFT avatars (ERC-721, ERC-1155)\n- IPFS avatars (resolved to gateway)\n\n### Response\nAvatar URL ready to use in img tags.\n\n### Pricing\n- **$0.001** per request"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name (e.g., vitalik.eth)"
          schema:
            type: "string"
            example: "vitalik.eth"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Avatar URL for ENS name"
          content:
            application/json:
              example:
                name: "vitalik.eth"
                avatar: "https://metadata.ens.domains/mainnet/avatar/vitalik.eth"
                type: "uri"
              schema:
                type: "object"
                properties:
                  name:
                    type: "string"
                  avatar:
                    type: "string"
                    nullable: true
                  source:
                    type: "string"
                  timestamp:
                    type: "string"
        "400":
          description: "Bad Request - Invalid parameters or malformed request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Invalid parameter format"
                code: "INVALID_PARAMETER"
        "402":
          description: "Payment Required - Free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Resource not found"
                code: "NOT_FOUND"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
  /api/ens/batch-resolve:
    get:
      tags:
        - "ENS"
      summary: "Batch reverse resolve addresses to ENS names"
      description: "Resolve up to 100 Ethereum addresses to their ENS names and social profiles in a single request.\n\n**Free Tier:** 100 addresses/day\n**Paid:** $0.01 per batch via x402\n\nReturns array of resolved identities with optional social metadata.\n"
      operationId: "getEnsNatchResolve"
      x-price: "$0.01"
      parameters:
        - name: "addresses"
          in: "query"
          required: true
          schema:
            type: "string"
          description: "Comma-separated list of Ethereum addresses (up to 100)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045,0xb8c2C29ee19D8307cb7255e1Cd9CbDE883A267d5"
        - name: "include"
          in: "query"
          required: false
          schema:
            type: "string"
          description: "Optional fields to include: name,avatar,twitter,github,discord,email,url"
          example: "name,avatar,twitter"
      responses:
        "200":
          description: "Success - array of resolved identities"
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  results:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        address:
                          type: "string"
                        name:
                          type: "string"
                          nullable: true
                        avatar:
                          type: "string"
                          nullable: true
                        records:
                          type: "object"
                          additionalProperties: true
                  resolved:
                    type: "number"
                  total:
                    type: "number"
                  cached:
                    type: "boolean"
              example:
                results:
                  - address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                    name: "vitalik.eth"
                    avatar: "https://i.imgur.com/gF9Yaeg.jpg"
                  - address: "0xb8c2C29ee19D8307cb7255e1Cd9CbDE883A267d5"
                    name: "nick.eth"
                    avatar: null
                resolved: 2
                total: 2
                cached: false
        "400":
          description: "Bad request - invalid addresses or parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              examples:
                missing:
                  summary: "Missing addresses"
                  value:
                    error: "Query parameter \"addresses\" is required"
                    code: "MISSING_ADDRESSES"
                invalid:
                  summary: "Invalid address format"
                  value:
                    error: "Invalid Ethereum addresses: 0xinvalid"
                    code: "INVALID_ADDRESSES"
                tooMany:
                  summary: "Too many addresses"
                  value:
                    error: "Maximum 100 addresses allowed per request"
                    code: "TOO_MANY_ADDRESSES"
        "402":
          description: "Payment Required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
              example:
                error: true
                code: "PAYMENT_REQUIRED"
                message: "Free tier limit exceeded. You have 0 addresses remaining today."
                freeTier:
                  limit: 100
                  used: 100
                  remaining: 0
                payment:
                  required: true
                  price: "$0.01"
                  method: "x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/cost/{name}:
    get:
      tags:
        - "ENS"
      summary: "ENS registration cost"
      operationId: "getapiEnsCost"
      x-price: "$0.01"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSProfile"
              example:
                name: "example.eth"
                registrationCost:
                  wei: "5000000000000000"
                  eth: "0.005"
                  usd: 16.23
                renewalCost:
                  wei: "5000000000000000"
                  eth: "0.005"
                  usd: 16.23
                duration: 31536000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/domains/{address}:
    get:
      tags:
        - "ENS"
      summary: "All ENS domains owned"
      operationId: "getapiEnsDomains"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSProfile"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                name: "vitalik.eth"
                avatar: "https://example.com/avatar.png"
                display: "Vitalik Buterin"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/expiration/{name}:
    get:
      tags:
        - "ENS"
      summary: "ENS name expiration"
      operationId: "getEnsExpiration"
      x-price: "$0.01"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name (e.g., vitalik.eth)"
          schema:
            type: "string"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Expiration"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSProfile"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                name: "vitalik.eth"
                avatar: "https://example.com/avatar.png"
                display: "Vitalik Buterin"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/expiring/{days}:
    get:
      tags:
        - "ENS"
      summary: "Expiring names"
      operationId: "getEnsExpiring"
      x-price: "$0.02"
      parameters:
        - name: "days"
          in: "path"
          required: true
          description: "Number of days for historical data"
          schema:
            type: "integer"
          example: 7
      responses:
        "200":
          description: "Expiring"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSProfile"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                name: "vitalik.eth"
                avatar: "https://example.com/avatar.png"
                display: "Vitalik Buterin"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/history/{name}:
    get:
      tags:
        - "ENS"
      summary: "ENS name history"
      operationId: "getapiEnsHistory"
      x-price: "$0.02"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSProfile"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                name: "vitalik.eth"
                avatar: "https://example.com/avatar.png"
                display: "Vitalik Buterin"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/owner/{address}:
    get:
      tags:
        - "ENS"
      summary: "Owner lookup"
      operationId: "getEnsOwner"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Names"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSProfile"
              examples:
                owned:
                  summary: "Name with owner and registrant"
                  value:
                    name: "vitalik.eth"
                    owner: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                    registrant: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                    controller: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                    expires: "2028-05-01T00:00:00Z"
                    wrapped: false
                wrapped:
                  summary: "Wrapped name with fuses"
                  value:
                    name: "atv.eth"
                    owner: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    wrapped: true
                    wrapperOwner: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    fuses: 65
                    expires: "2034-11-09T00:00:00Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/records/{name}:
    get:
      tags:
        - "ENS"
      summary: "ENS text records"
      operationId: "getEnsRecords"
      x-price: "$0.02"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name (e.g., vitalik.eth)"
          schema:
            type: "string"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Records"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSProfile"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                name: "vitalik.eth"
                avatar: "https://example.com/avatar.png"
                display: "Vitalik Buterin"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get all text records for ENS name"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/registrations:
    get:
      tags:
        - "ENS"
      summary: "Recent ENS registrations"
      description: "Get recent ENS name registrations from The Graph subgraph.\n\nReturns the most recently registered ENS names with owner, dates, and cost.\n"
      operationId: "getEnsRegistrations"
      x-price: "$0.02"
      parameters:
        - name: "limit"
          in: "query"
          required: false
          description: "Number of registrations to return (max 100)"
          schema:
            type: "integer"
            default: 20
            minimum: 1
            maximum: 100
          example: 20
        - name: "since"
          in: "query"
          required: false
          description: "Unix timestamp - only return registrations after this time"
          schema:
            type: "integer"
          example: 1707800000
      responses:
        "200":
          description: "Registrations"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSProfile"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                name: "vitalik.eth"
                avatar: "https://example.com/avatar.png"
                display: "Vitalik Buterin"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/registrations/{address}:
    get:
      tags:
        - "ENS"
      summary: "ENS names owned by address"
      operationId: "getapiEnsRegistrations"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSProfile"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                name: "vitalik.eth"
                avatar: "https://example.com/avatar.png"
                display: "Vitalik Buterin"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/resolve/{name}:
    get:
      summary: "Resolve ENS to Address"
      operationId: "resolveEns"
      tags:
        - "Identity"
        - "ENS"
      description: "Simple ENS name to Ethereum address resolution.\n\n### Use Case\nQuick address lookup when you don't need full profile data.\n\n### Response\nJust the resolved address - fast and lightweight.\n\n### Pricing\n- **$0.001** per request"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name"
          schema:
            type: "string"
            example: "vitalik.eth"
          example: "vitalik.eth"
      responses:
        "200":
          description: "ENS name resolved to address"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSResolveResponse"
              example:
                name: "vitalik.eth"
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                resolver: "0x231b0Ee14048e9dCcD1d247744d114a4EB5E8E63"
                avatar: "https://i.seadn.io/s/raw/files/f7b0507e0b8b6fb5e64e39e3e7ec58ed.png"
                contentHash: "ipfs://bafybeico3uuyj3vphxpvbowchdwjlrlrh62awxscrnii7w7flu5z6fk77y"
                description: "The future of the decentralized internet."
                twitter: "ensdomains"
                url: "https://ens.domains"
        "400":
          description: "Bad Request - Invalid parameters or malformed request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Invalid parameter format"
                code: "INVALID_PARAMETER"
        "402":
          description: "Payment Required - Free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "404":
          description: "ENS name not found"
          content:
            application/json:
              example:
                error: true
                code: "ENS_NOT_FOUND"
                message: "ENS name not registered"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
  /api/ens/resolver/{name}:
    get:
      tags:
        - "ENS"
      summary: "ENS resolver info"
      operationId: "getEnsResolver"
      x-price: "$0.01"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name (e.g., vitalik.eth)"
          schema:
            type: "string"
          example: "vitalik.eth"
      responses:
        "200":
          description: "ENS resolver contract information"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSResolverResponse"
              example:
                name: "vitalik.eth"
                resolver: "0x231b0Ee14048e9dCcD1d247744d114a4EB5E8E63"
                hasResolver: true
                timestamp: "2026-02-09T06:30:00.000Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get ENS resolver contract address for a name"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/reverse/{address}:
    get:
      tags:
        - "ENS"
      summary: "Reverse resolve"
      operationId: "reverseEns"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Address resolved to primary ENS name"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSReverseResponse"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                name: "vitalik.eth"
                isPrimary: true
                resolver: "0x231b0Ee14048e9dCcD1d247744d114a4EB5E8E63"
                avatar: "https://metadata.ens.domains/mainnet/avatar/vitalik.eth"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Reverse resolve address to ENS name (primary name)"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/stats:
    get:
      tags:
        - "ENS"
      summary: "ENS protocol stats"
      operationId: "getapiEnsStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSProfile"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                name: "vitalik.eth"
                avatar: "https://example.com/avatar.png"
                display: "Vitalik Buterin"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/subdomains/{name}:
    get:
      tags:
        - "ENS"
      summary: "Subdomains of a name"
      operationId: "getapiEnsSubdomains"
      x-price: "$0.01"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSProfile"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                name: "vitalik.eth"
                avatar: "https://example.com/avatar.png"
                display: "Vitalik Buterin"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/transfers:
    get:
      tags:
        - "ENS"
      summary: "Recent transfers"
      operationId: "getEnsTransfers"
      x-price: "$0.02"
      responses:
        "200":
          description: "Transfers"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSProfile"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                name: "vitalik.eth"
                avatar: "https://example.com/avatar.png"
                display: "Vitalik Buterin"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/value/{name}:
    get:
      tags:
        - "ENS"
      summary: "ENS name valuation"
      operationId: "getEnsValue"
      x-price: "$0.02"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name (e.g., vitalik.eth)"
          schema:
            type: "string"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Valuation"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ENSProfile"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                name: "vitalik.eth"
                avatar: "https://example.com/avatar.png"
                display: "Vitalik Buterin"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Estimated value/appraisal for ENS name"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/ens/{name}:
    get:
      tags:
        - "Identity"
        - "ENS"
      summary: "Get ENS Profile"
      operationId: "getEnsProfile"
      x-price: "$0.01"
      description: "Retrieve comprehensive ENS profile data including address, avatar, and text records.\n\n### Features\n- Resolves ENS name to Ethereum address\n- Fetches avatar URL (supports NFT avatars)\n- Returns all text records (description, twitter, github, etc.)\n- Includes registration and expiration dates\n\n### Pricing\n- **$0.001** per request (free tier: 100/day)"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name (e.g., vitalik.eth)"
          schema:
            type: "string"
            example: "vitalik.eth"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Full ENS profile"
          content:
            application/json:
              example:
                name: "vitalik.eth"
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                avatar: "https://metadata.ens.domains/mainnet/avatar/vitalik.eth"
                records:
                  com.twitter: "VitalikButerin"
                  com.github: "vbuterin"
                  url: "https://vitalik.eth.limo"
                  description: "Ethereum co-founder"
                expiration: "2030-05-04T00:00:00.000Z"
                owner: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                resolver: "0x231b0Ee14048e9dCcD1d247744d114a4EB5E8E63"
              schema:
                $ref: "#/components/schemas/ENSProfile"
        "400":
          description: "Bad Request - Invalid parameters or malformed request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Invalid parameter format"
                code: "INVALID_PARAMETER"
        "404":
          description: "ENS name not found"
          content:
            application/json:
              example:
                error: true
                code: "NOT_FOUND"
                message: "ENS name not found or not registered"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/eth/burn:
    get:
      tags:
        - "Chain"
      summary: "ETH burn stats"
      operationId: "getapiEthBurn"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/eth/burn not found"
                timestamp: "2026-02-18T05:41:49.089Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "sunset"
      x-deprecated-at: "2026-02-19"
      x-sunset-date: "2026-08-01"
  /api/eth/price:
    get:
      tags:
        - "Chain"
      summary: "Current ETH price in multiple currencies"
      operationId: "getapiEthPrice"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "sunset"
      x-deprecated-at: "2026-02-19"
      x-sunset-date: "2026-08-01"
  /api/eth/staking:
    get:
      tags:
        - "Chain"
      summary: "ETH staking stats"
      operationId: "getapiEthStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/eth/staking not found"
                timestamp: "2026-02-18T05:41:49.097Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/eth/supply:
    get:
      tags:
        - "Chain"
      summary: "ETH supply breakdown"
      operationId: "getapiEthSupply"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/eth/supply not found"
                timestamp: "2026-02-18T05:41:49.103Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/eth/validators:
    get:
      tags:
        - "Chain"
      summary: "ETH validator stats"
      operationId: "getapiEthValidators"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/exchange/btc-reserves:
    get:
      tags:
        - "Utilities"
      summary: "Exchange BTC reserves"
      operationId: "getapiExchangeBtcreserves"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/exchange/eth-reserves:
    get:
      tags:
        - "Utilities"
      summary: "Exchange ETH reserves"
      operationId: "getapiExchangeEthreserves"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/expiration/{name}:
    get:
      tags:
        - "ENS"
      summary: "ENS expiration date and renewal info"
      operationId: "getapiExpiration"
      x-price: "$0.01"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/expiration/vitalik.eth not found"
                timestamp: "2026-02-18T05:41:49.109Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/explorer/address/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Address explorer link"
      operationId: "getapiExplorerAddress"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/explorer/tx/{hash}:
    get:
      tags:
        - "Utilities"
      summary: "Transaction explorer link"
      operationId: "getapiExplorerTx"
      x-price: "$0.01"
      parameters:
        - name: "hash"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Transaction or cast hash"
          example: "0xabc123def456789012345678901234567890abcd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/explorer/tx/0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef not found"
                timestamp: "2026-02-18T05:41:49.117Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/address/{address}:
    get:
      tags:
        - "Farcaster"
      summary: "Farcaster user by ETH address"
      description: "Look up a Farcaster user profile by their verified Ethereum address"
      operationId: "getFarcasterByAddress"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Farcaster user profile"
          content:
            application/json:
              schema:
                type: "object"
                required:
                  - "address"
                  - "fid"
                  - "username"
                  - "timestamp"
                properties:
                  address:
                    type: "string"
                    description: "Ethereum address queried"
                  fid:
                    type: "number"
                    description: "Farcaster ID"
                  username:
                    type: "string"
                    description: "Farcaster username"
                  displayName:
                    type: "string"
                    description: "Display name"
                  bio:
                    type: "string"
                    nullable: true
                    description: "User bio"
                  pfp:
                    type: "string"
                    format: "uri"
                    description: "Profile picture URL"
                  followerCount:
                    type: "number"
                  followingCount:
                    type: "number"
                  verifiedAddresses:
                    type: "object"
                    properties:
                      eth_addresses:
                        type: "array"
                        items:
                          type: "string"
                      sol_addresses:
                        type: "array"
                        items:
                          type: "string"
                      primary:
                        type: "object"
                        properties:
                          eth_address:
                            type: "string"
                          sol_address:
                            type: "string"
                  source:
                    type: "string"
                    description: "Data source (neynar, warpcast)"
                  timestamp:
                    type: "string"
                    format: "date-time"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                fid: 5650
                username: "vitalik.eth"
                displayName: "Vitalik Buterin"
                bio: "hullo"
                pfp: "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/471b3f42-fb38-44ef-0511-bcb7f7596e00/original"
                followerCount: 534575
                followingCount: 110
                verifiedAddresses:
                  eth_addresses:
                    - "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
                    - "0x96b6bb2bd2eba3b4fbefd7dbac448ad7b6cbf279"
                  sol_addresses:
                    - "47aHBDrF5Uw6Qm4npXZb2GLckssnUKhTmbTBRPKJUCH2"
                  primary:
                    eth_address: "0x96b6bb2bd2eba3b4fbefd7dbac448ad7b6cbf279"
                    sol_address: "47aHBDrF5Uw6Qm4npXZb2GLckssnUKhTmbTBRPKJUCH2"
                source: "neynar"
                timestamp: "2026-02-18T00:35:41.200Z"
        "404":
          description: "Address not found on Farcaster"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/cast/{hash}:
    get:
      tags:
        - "Farcaster"
      summary: "Farcaster cast by hash"
      operationId: "getapiFarcasterCast"
      x-price: "$0.01"
      parameters:
        - name: "hash"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Transaction or cast hash"
          example: "0xabc123def456789012345678901234567890abcd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
                example:
                  hash: "0x1234567890abcdef"
                  author:
                    fid: 3
                    username: "dwr.eth"
                  text: "gm"
                  timestamp: "2026-02-12T14:30:00Z"
                  likes: 234
                  recasts: 45
                  replies: 12
              example:
                hash: "0xabcdef1234567890"
                text: "This is an example cast on Farcaster!"
                author:
                  fid: 3
                  username: "dwr"
                  displayName: "Dan Romero"
                  pfpUrl: "https://i.imgur.com/example.png"
                timestamp: 1707393600000
                replies: 12
                recasts: 8
                reactions:
                  likes: 45
                  count: 45
                embeds:
                  - url: "https://example.com"
                channel:
                  id: "dev"
                  name: "dev"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/cast/{hash}/reactions:
    get:
      tags:
        - "Farcaster"
      summary: "Cast reactions (likes/recasts)"
      operationId: "getapiFarcasterCastReactions"
      x-price: "$0.01"
      parameters:
        - name: "hash"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Transaction or cast hash"
          example: "0xabc123def456789012345678901234567890abcd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                hash: "0xabcdef1234567890"
                reactions:
                  likes:
                    - fid: 456
                      username: "alice"
                      timestamp: 1707393650
                    - fid: 789
                      username: "bob"
                      timestamp: 1707393680
                  recasts:
                    - fid: 1011
                      username: "charlie"
                      timestamp: 1707393700
                counts:
                  likes: 2
                  recasts: 1
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/cast/{hash}/replies:
    get:
      tags:
        - "Farcaster"
      summary: "Cast replies/thread"
      operationId: "getapiFarcasterCastReplies"
      x-price: "$0.02"
      parameters:
        - name: "hash"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Transaction or cast hash"
          example: "0xabc123def456789012345678901234567890abcd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                hash: "0xabcdef1234567890"
                replies:
                  - hash: "0xreply123"
                    text: "Great post!"
                    author:
                      fid: 456
                      username: "alice"
                    timestamp: 1707393700
                count: 1
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/channel/{name}:
    get:
      tags:
        - "Farcaster"
      summary: "Farcaster channel info"
      operationId: "getapiFarcasterChannel"
      x-price: "$0.01"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "dev"
                name: "dev"
                description: "Developer discussions"
                imageUrl: "https://i.imgur.com/dev.png"
                createdAt: 1640000000000
                followerCount: 12345
                leadFid: 3
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/channel/{name}/feed:
    get:
      tags:
        - "Farcaster"
      summary: "Channel feed/casts"
      operationId: "getapiFarcasterChannelFeed"
      x-price: "$0.02"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                channel: "dev"
                casts:
                  - hash: "0xabc123"
                    text: "Dev channel post"
                    author:
                      fid: 3
                      username: "dwr"
                    timestamp: 1707393600000
                    reactions:
                      likes: 25
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/channels:
    get:
      tags:
        - "Farcaster"
      summary: "List Farcaster channels"
      description: "Get a list of Farcaster channels with their metadata"
      operationId: "getFarcasterChannels"
      x-price: "$0.01"
      parameters:
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
            default: 25
          description: "Maximum channels to return"
      responses:
        "200":
          description: "List of channels"
          content:
            application/json:
              schema:
                type: "object"
                required:
                  - "channels"
                properties:
                  channels:
                    type: "array"
                    items:
                      $ref: "#/components/schemas/FarcasterChannel"
              example:
                channels:
                  - id: "spraay"
                    name: "spraay"
                    description: "Batch crypto payments on Base. Send to 200+ wallets in one tx."
                    followerCount: 0
                    imageUrl: "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/554f6ca0-aac9-4dd1-cbc0-e492bccc4b00/original"
                  - id: "fruitling-valley"
                    name: "fruitling-valley"
                    description: "Fully onchain farming game. Live on Base."
                    followerCount: 185
                    imageUrl: "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/a7dbb6f9-c977-4862-38fd-5461fb38cf00/original"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/feed/{fid}:
    get:
      tags:
        - "Farcaster"
      summary: "Farcaster user feed"
      description: "Get recent casts from a Farcaster user's feed"
      operationId: "getFarcasterFeed"
      x-price: "$0.02"
      parameters:
        - name: "fid"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Farcaster user ID"
          example: "5650"
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
            default: 25
          description: "Max items to return"
          example: 10
      responses:
        "200":
          description: "User's feed casts"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/FarcasterFeedResponse"
              example:
                fid: "5650"
                casts:
                  - hash: "0xabc123def456"
                    text: "Hello Farcaster!"
                    author:
                      fid: 5650
                      username: "vitalik.eth"
                      displayName: "Vitalik Buterin"
                    timestamp: 1708214141
                    reactions:
                      likes: 1234
                      recasts: 89
                source: "warpcast"
                timestamp: "2026-02-18T00:35:41.380Z"
        "402":
          description: "Payment Required"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "404":
          description: "User not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/notifications/{fid}:
    get:
      tags:
        - "Farcaster"
      summary: "User notifications"
      operationId: "getapiFarcasterNotifications"
      x-price: "$0.02"
      parameters:
        - name: "fid"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Farcaster user ID"
          example: "3"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                fid: 3
                notifications:
                  - type: "mention"
                    castHash: "0xabc123"
                    from:
                      fid: 456
                      username: "alice"
                    timestamp: 1707393600
                  - type: "reply"
                    castHash: "0xdef456"
                    from:
                      fid: 789
                      username: "bob"
                    timestamp: 1707393500
                  - type: "like"
                    castHash: "0xghi789"
                    from:
                      fid: 1011
                      username: "charlie"
                    timestamp: 1707393400
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/power-badge:
    get:
      tags:
        - "Farcaster"
      summary: "Power badge users"
      operationId: "getapiFarcasterPowerbadge"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                users:
                  - fid: 3
                    username: "dwr"
                    hasPowerBadge: true
                  - fid: 1
                    username: "v"
                    hasPowerBadge: true
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/recent:
    get:
      tags:
        - "Farcaster"
      summary: "Recent popular casts"
      operationId: "getapiFarcasterRecent"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                casts:
                  - hash: "0xabc123"
                    text: "Recent cast example"
                    author:
                      fid: 456
                      username: "alice"
                    timestamp: 1707393600000
                    reactions:
                      likes: 10
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/search:
    get:
      tags:
        - "Farcaster"
      summary: "Search Farcaster casts"
      operationId: "getapiFarcasterSearch"
      x-price: "$0.02"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/stats:
    get:
      tags:
        - "Farcaster"
      summary: "Farcaster network stats"
      description: "Get Farcaster protocol statistics"
      operationId: "getFarcasterStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Network statistics"
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  note:
                    type: "string"
                    description: "API information note"
                  api:
                    type: "string"
                    description: "Data sources used"
                  hasNeynarKey:
                    type: "boolean"
                    description: "Whether Neynar API key is configured"
                  source:
                    type: "string"
                  timestamp:
                    type: "string"
                    format: "date-time"
              example:
                note: "Farcaster protocol stats"
                api: "warpcast + neynar"
                hasNeynarKey: true
                source: "aggregated"
                timestamp: "2026-02-18T00:50:44.581Z"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/trending:
    get:
      tags:
        - "Farcaster"
      summary: "Trending Farcaster content"
      description: "Get trending casts and content from Farcaster"
      operationId: "getFarcasterTrending"
      x-price: "$0.01"
      parameters:
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
            default: 25
          description: "Maximum items to return"
      responses:
        "200":
          description: "Trending content"
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  casts:
                    type: "array"
                    items:
                      $ref: "#/components/schemas/FarcasterCast"
                  source:
                    type: "string"
                  timestamp:
                    type: "string"
                    format: "date-time"
              example:
                casts: []
                source: "warpcast"
                timestamp: "2026-02-18T00:50:44.515Z"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/trending/casts:
    get:
      tags:
        - "Farcaster"
      summary: "Trending casts"
      description: "Get trending casts from Farcaster"
      operationId: "getFarcasterTrendingCasts"
      x-price: "$0.01"
      parameters:
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
            default: 25
          description: "Maximum casts to return"
      responses:
        "200":
          description: "Trending casts"
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  casts:
                    type: "array"
                    items:
                      $ref: "#/components/schemas/FarcasterCast"
                  source:
                    type: "string"
                  timestamp:
                    type: "string"
                    format: "date-time"
              example:
                casts:
                  - hash: "0xtrending123456789"
                    text: "This is a trending cast!"
                    author:
                      fid: 3
                      username: "dwr"
                    reactions:
                      likes: 500
                      recasts: 120
                source: "warpcast"
                timestamp: "2026-02-18T00:50:44.515Z"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/trending/users:
    get:
      tags:
        - "Farcaster"
      summary: "Trending users"
      operationId: "getapiFarcasterTrendingUsers"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                users:
                  - fid: 3
                    username: "dwr"
                    displayName: "Dan Romero"
                    followerGrowth: 1234
                    score: 98
                  - fid: 456
                    username: "trending-user"
                    displayName: "Trending User"
                    followerGrowth: 987
                    score: 95
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/user/{fid}:
    get:
      tags:
        - "Farcaster"
      summary: "Farcaster user by FID (Neynar)"
      operationId: "getapiFarcasterUser"
      x-price: "$0.01"
      parameters:
        - name: "fid"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Farcaster user ID"
          example: "3"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfpUrl: "https://i.imgur.com/aBcDeF.png"
                profile:
                  bio:
                    text: "Building Farcaster"
                followerCount: 234567
                followingCount: 1234
                verifications:
                  - "0x1234567890123456789012345678901234567890"
              schema:
                $ref: "#/components/schemas/FarcasterProfile"
                example:
                  fid: 3
                  username: "dwr.eth"
                  displayName: "Dan Romero"
                  pfp: "https://i.imgur.com/fR1e8Vj.jpg"
                  bio: "Building Farcaster"
                  followerCount: 145678
                  followingCount: 2345
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Farcaster user profile by FID or username"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/user/{fid}/casts:
    get:
      tags:
        - "Farcaster"
      summary: "User recent casts"
      operationId: "getapiFarcasterUserCasts"
      x-price: "$0.02"
      parameters:
        - name: "fid"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Farcaster user ID"
          example: "3"
      responses:
        "200":
          description: "User's recent casts"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/FarcasterCastsResponse"
              example:
                casts:
                  - hash: "0xabcdef1234567890"
                    text: "Hello Farcaster! This is a cast."
                    timestamp: 1707393600000
                    author:
                      fid: 3
                      username: "dwr"
                      displayName: "Dan Romero"
                    reactions:
                      likes: 45
                      recasts: 8
                      replies: 12
                    embeds: []
                next:
                  cursor: "eyJwYWdlIjoyfQ=="
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Get recent casts from a Farcaster user"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/user/{fid}/followers:
    get:
      tags:
        - "Farcaster"
      summary: "User followers"
      description: "Get paginated list of users following this Farcaster user"
      operationId: "getFarcasterUserFollowers"
      x-price: "$0.02"
      parameters:
        - name: "fid"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Farcaster user ID"
          example: "5650"
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
            default: 25
          description: "Maximum results"
      responses:
        "200":
          description: "List of followers"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/FarcasterFollowersResponse"
              example:
                users:
                  - fid: 123
                    username: "alice"
                    displayName: "Alice"
                    pfp: "https://i.imgur.com/alice.png"
                    followerCount: 1234
                  - fid: 456
                    username: "bob"
                    displayName: "Bob"
                    pfp: "https://i.imgur.com/bob.png"
                    followerCount: 5678
                next:
                  cursor: "eyJwYWdlIjoyfQ=="
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/user/{fid}/following:
    get:
      tags:
        - "Farcaster"
      summary: "User following"
      description: "Get paginated list of users this Farcaster user follows"
      operationId: "getFarcasterUserFollowing"
      x-price: "$0.02"
      parameters:
        - name: "fid"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Farcaster user ID"
          example: "5650"
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
            default: 25
          description: "Maximum results"
      responses:
        "200":
          description: "List of following"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/FarcasterFollowersResponse"
              example:
                users:
                  - fid: 789
                    username: "charlie"
                    displayName: "Charlie"
                    pfp: "https://i.imgur.com/charlie.png"
                    followerCount: 9012
                  - fid: 1011
                    username: "dana"
                    displayName: "Dana"
                    pfp: "https://i.imgur.com/dana.png"
                    followerCount: 3456
                next:
                  cursor: "eyJwYWdlIjoyfQ=="
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/user/{fid}/storage:
    get:
      tags:
        - "Farcaster"
      summary: "User storage usage"
      operationId: "getapiFarcasterUserStorage"
      x-price: "$0.01"
      parameters:
        - name: "fid"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Farcaster user ID"
          example: "3"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/FarcasterProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Farcaster user profile by FID or username"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/username/{username}:
    get:
      tags:
        - "Farcaster"
      summary: "User by username"
      operationId: "getapiFarcasterUsername"
      x-price: "$0.01"
      parameters:
        - name: "username"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Farcaster username (without @)"
          example: "dwr"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/FarcasterProfile"
              example:
                user:
                  object: "user"
                  fid: 3
                  username: "dwr"
                  display_name: "Dan Romero"
                  pfp_url: "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/bc698287-5adc-4cc5-a503-de16963ed900/original"
                  custody_address: "0x6b0bda3f2ffed5efc83fa8c024acff1dd45793f1"
                  profile:
                    bio:
                      text: "Interested in technology and other stuff."
                  follower_count: 627359
                  following_count: 68
                  verifications:
                    - "0x187c7b0393ebe86378128f2653d0930e33218899"
                    - "0x6ce09ed5526de4afe4a981ad86d17b2f5c92fea5"
                  verified_addresses:
                    eth_addresses:
                      - "0x187c7b0393ebe86378128f2653d0930e33218899"
                      - "0x6ce09ed5526de4afe4a981ad86d17b2f5c92fea5"
                    sol_addresses:
                      - "ExAqci8uUVKtqHqFW58fmwgMMY9PATfRGGyv6837j9Lx"
                  score: 0.99
                source: "neynar"
                timestamp: "2026-02-18T01:09:04.189Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Farcaster user profile by FID or username"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/users/bulk:
    get:
      tags:
        - "Farcaster"
      summary: "Bulk fetch users by FIDs"
      operationId: "getapiFarcasterUsersBulk"
      x-price: "$0.02"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/FarcasterProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Farcaster user profile by FID or username"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farcaster/{identifier}:
    get:
      summary: "Get Farcaster Profile"
      operationId: "getFarcasterProfile"
      tags:
        - "Identity"
        - "Social"
      description: "Get Farcaster user profile by FID, username, or connected address.\n\n### Identifier Types\n- **FID**: Numeric Farcaster ID (e.g., 5650)\n- **Username**: Farcaster username (e.g., vitalik.eth)\n- **Address**: Connected Ethereum address\n\n### Response Includes\n- Profile bio and avatar\n- Follower/following counts\n- Connected addresses\n- Power badge status\n\n### Pricing\n- **$0.01** per request"
      parameters:
        - name: "identifier"
          in: "path"
          required: true
          description: "FID, username, or address"
          schema:
            type: "string"
            example: "vitalik.eth"
          example: "dwr.eth"
      responses:
        "200":
          description: "Farcaster user profile"
          content:
            application/json:
              example:
                fid: 3
                username: "dwr.eth"
                displayName: "Dan Romero"
                bio: "Farcaster"
                pfp: "https://i.imgur.com/abcd1234.png"
                followerCount: 125000
                followingCount: 2500
                verifications:
                  - "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                activeStatus: "active"
              schema:
                $ref: "#/components/schemas/FarcasterUser"
        "400":
          description: "Bad Request - Invalid parameters or malformed request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Invalid parameter format"
                code: "INVALID_PARAMETER"
        "402":
          description: "Payment Required - Free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Resource not found"
                code: "NOT_FOUND"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
  /api/farms:
    get:
      tags:
        - "DeFi"
      summary: "Top yield farms"
      operationId: "getapiFarms"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/farms/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "Chain yield farms"
      operationId: "getFarmsByChain"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Chain name (ethereum, base, etc.)"
          example: "ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/farms/ethereum not found"
                timestamp: "2026-02-18T05:42:34.517Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/fees:
    get:
      tags:
        - "DeFi"
      summary: "Protocol fees overview"
      operationId: "getFeesOverview"
      x-price: "$0.01"
      responses:
        "200":
          description: "Fees"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/fees/arbitrum:
    get:
      tags:
        - "DeFi"
      summary: "Arbitrum fees"
      operationId: "getArbitrumFees"
      x-price: "$0.01"
      responses:
        "200":
          description: "Fees"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "arbitrum"
                totalFees24h: 532610
                totalFees7d: 3460803
                protocols:
                  - name: "Curve DEX"
                    fees24h: 283
                  - name: "Yearn Finance"
                    fees24h: 26
                  - name: "SushiSwap"
                    fees24h: 481
                  - name: "KyberSwap Classic"
                    fees24h: null
                  - name: "Hegic"
                    fees24h: 20
                  - name: "DODO AMM"
                    fees24h: 24
                  - name: "Tornado Cash"
                    fees24h: 0
                  - name: "Idle"
                    fees24h: 0
                  - name: "Index Coop"
                    fees24h: 0
                  - name: "dHEDGE Vaults"
                    fees24h: 300
                  - name: "PancakeSwap AMM"
                    fees24h: 45
                  - name: "Sablier Legacy"
                    fees24h: 3
                  - name: "Saddle Finance"
                    fees24h: 0
                  - name: "Alchemix"
                    fees24h: 0
                  - name: "Venus Core Pool"
                    fees24h: 64
                source: "defillama"
                timestamp: "2026-02-18T05:42:35.671Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/fees/base:
    get:
      tags:
        - "DeFi"
      summary: "Base fees"
      operationId: "getBaseFees"
      x-price: "$0.01"
      responses:
        "200":
          description: "Fees"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "base"
                totalFees24h: 2526487
                totalFees7d: 18134629
                protocols:
                  - name: "Curve DEX"
                    fees24h: 148
                  - name: "Yearn Finance"
                    fees24h: 97
                  - name: "SushiSwap"
                    fees24h: 16
                  - name: "Index Coop"
                    fees24h: 0
                  - name: "dHEDGE Vaults"
                    fees24h: 661
                  - name: "PancakeSwap AMM"
                    fees24h: 0
                  - name: "Sablier Legacy"
                    fees24h: 43
                  - name: "Venus Core Pool"
                    fees24h: 0
                  - name: "Vesper"
                    fees24h: 14
                  - name: "Quickswap Dex"
                    fees24h: 146
                  - name: "Beefy"
                    fees24h: 1091
                  - name: "Olympus DAO"
                    fees24h: 0
                  - name: "Impermax V2"
                    fees24h: null
                  - name: "Gamma"
                    fees24h: 121
                  - name: "Pendle"
                    fees24h: 15
                source: "defillama"
                timestamp: "2026-02-18T05:42:35.769Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/fees/ethereum:
    get:
      tags:
        - "DeFi"
      summary: "Ethereum fees"
      operationId: "getEthereumFees"
      x-price: "$0.01"
      responses:
        "200":
          description: "Fees"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "ethereum"
                totalFees24h: 8566721
                totalFees7d: 72167146
                protocols:
                  - name: "WBTC"
                    fees24h: 0
                  - name: "Curve DEX"
                    fees24h: 32058
                  - name: "Aave V2"
                    fees24h: 4875
                  - name: "Yearn Finance"
                    fees24h: 18026
                  - name: "Compound V2"
                    fees24h: 1276
                  - name: "Synthetix v1+v2"
                    fees24h: 0
                  - name: "Balancer V1"
                    fees24h: 283
                  - name: "Sky Lending"
                    fees24h: 1137203
                  - name: "SushiSwap"
                    fees24h: 2496
                  - name: "Nexus Mutual"
                    fees24h: 10233
                  - name: "KyberSwap Classic"
                    fees24h: null
                  - name: "dYdX V3"
                    fees24h: null
                  - name: "DODO AMM"
                    fees24h: 5184
                  - name: "Tornado Cash"
                    fees24h: 13564
                  - name: "Idle"
                    fees24h: 24
                source: "defillama"
                timestamp: "2026-02-18T05:42:35.897Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/fees/protocol/{name}:
    get:
      tags:
        - "DeFi"
      summary: "Protocol fees"
      operationId: "getFeesProtocol"
      x-price: "$0.01"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name (e.g., vitalik.eth)"
          schema:
            type: "string"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Fees"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/fees/revenue:
    get:
      tags:
        - "DeFi"
      summary: "Protocol revenue overview"
      operationId: "getRevenueOverview"
      x-price: "$0.01"
      responses:
        "200":
          description: "Revenue"
          content:
            application/json:
              schema:
                type: "object"
              example:
                totalRevenue24h: 33495701
                protocols:
                  - name: "WBTC"
                    revenue24h: 0
                  - name: "Curve DEX"
                    revenue24h: 8523
                    change24h: 29.33
                  - name: "Aave V2"
                    revenue24h: 14748
                    change24h: 159.28
                  - name: "Yearn Finance"
                    revenue24h: 1033
                    change24h: 1.08
                  - name: "Compound V2"
                    revenue24h: 1276
                    change24h: -28.91
                  - name: "Synthetix v1+v2"
                    revenue24h: 0
                  - name: "Balancer V1"
                    revenue24h: 0
                  - name: "Sky Lending"
                    revenue24h: 613068
                    change24h: 4.31
                  - name: "SushiSwap"
                    revenue24h: 580
                    change24h: -14.83
                  - name: "Nexus Mutual"
                    revenue24h: 5117
                    change24h: 4551.82
                  - name: "KyberSwap Classic"
                    revenue24h: null
                  - name: "dYdX V3"
                    revenue24h: null
                  - name: "DODO AMM"
                    revenue24h: 2221
                    change24h: -11.87
                  - name: "Tornado Cash"
                    revenue24h: 0
                  - name: "Idle"
                    revenue24h: 2
                    change24h: -99.92
                  - name: "Index Coop"
                    revenue24h: 0
                  - name: "Defi Saver"
                    revenue24h: 891
                    change24h: -47.59
                  - name: "Lido"
                    revenue24h: 130542
                    change24h: -3.77
                  - name: "dHEDGE Vaults"
                    revenue24h: 110
                    change24h: -38.89
                  - name: "PancakeSwap AMM"
                    revenue24h: 25273
                    change24h: -26.27
                source: "defillama"
                timestamp: "2026-02-18T05:42:37.952Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/fees/revenue/{protocol}:
    get:
      tags:
        - "DeFi"
      summary: "Protocol revenue"
      operationId: "getFeesRevenue"
      x-price: "$0.01"
      parameters:
        - name: "protocol"
          in: "path"
          required: true
          description: "DeFi protocol identifier"
          schema:
            type: "string"
          example: "aave"
      responses:
        "200":
          description: "Revenue"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                revenue24h: 13868
                revenue7d: 208562
                revenue30d: 2018386
                source: "defillama"
                timestamp: "2026-02-18T11:43:18.443Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/fees/top:
    get:
      tags:
        - "DeFi"
      summary: "Top fee generators"
      operationId: "getTopFees"
      x-price: "$0.01"
      responses:
        "200":
          description: "Top fees"
          content:
            application/json:
              schema:
                type: "object"
              example:
                topFeeGenerators:
                  - name: "Tether"
                    fees24h: 16331563
                    fees7d: 114419600
                    change24h: -0.04
                  - name: "Circle"
                    fees24h: 6374485
                    fees7d: 44462592
                    change24h: 0.02
                  - name: "PumpSwap"
                    fees24h: 2353915
                    fees7d: 12754968
                    change24h: 37.95
                  - name: "Hyperliquid Perps"
                    fees24h: 1670170
                    fees7d: 11512691
                    change24h: 30.53
                  - name: "Aave V3"
                    fees24h: 1637619
                    fees7d: 13000415
                    change24h: -12.59
                  - name: "Lido"
                    fees24h: 1305424
                    fees7d: 9418774
                    change24h: -3.77
                  - name: "Uniswap V3"
                    fees24h: 1188337
                    fees7d: 7830427
                    change24h: 82.25
                  - name: "Sky Lending"
                    fees24h: 1137203
                    fees7d: 8021008
                    change24h: -0.4
                  - name: "Jupiter Perpetual Exchange"
                    fees24h: 1119982
                    fees7d: 8081586
                    change24h: 7.58
                  - name: "pump.fun"
                    fees24h: 1088564
                    fees7d: 6256495
                    change24h: 18.32
                  - name: "Solana"
                    fees24h: 932163
                    fees7d: 4738521
                    change24h: 42.43
                  - name: "Tron"
                    fees24h: 784369
                    fees7d: 5926531
                    change24h: -8.92
                  - name: "BlackRock BUIDL"
                    fees24h: 715449
                    fees7d: 1266924
                    change24h: 4634
                  - name: "Uniswap V4"
                    fees24h: 641811
                    fees7d: 4441338
                    change24h: 14.01
                  - name: "Grayscale"
                    fees24h: 578115
                    fees7d: 4081539
                    change24h: -1.63
                  - name: "edgeX Perps"
                    fees24h: 567533
                    fees7d: 4530326
                    change24h: 0
                  - name: "Binance staked ETH"
                    fees24h: 551732
                    fees7d: 3995947
                    change24h: 1.51
                  - name: "KGeN"
                    fees24h: 537288
                    fees7d: 3016168
                    change24h: 57.34
                  - name: "ether.fi Liquid"
                    fees24h: 389168
                    fees7d: 2848924
                    change24h: -12.38
                  - name: "Sanctum Validator LSTs"
                    fees24h: 375961
                    fees7d: 1463256
                    change24h: 218481.98
                source: "defillama"
                timestamp: "2026-02-18T11:43:18.937Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/fees/{protocol}:
    get:
      tags:
        - "DeFi"
      summary: "Protocol fees history"
      operationId: "getapiFees"
      x-price: "$0.01"
      parameters:
        - name: "protocol"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Protocol slug"
          example: "aave"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/fees/aave not found"
                timestamp: "2026-02-18T11:43:18.946Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/followers/{name}:
    get:
      tags:
        - "Social"
      summary: "List of followers with ENS names"
      operationId: "getapiFollowers"
      x-price: "$0.02"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/followers/dwr.eth not found"
                timestamp: "2026-02-18T11:43:18.954Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/following/{name}:
    get:
      tags:
        - "Social"
      summary: "List of accounts being followed"
      operationId: "getapiFollowing"
      x-price: "$0.02"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/following/dwr.eth not found"
                timestamp: "2026-02-18T11:43:18.960Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/fortune:
    get:
      tags:
        - "Free"
      summary: "Security wisdom"
      operationId: "getFortune"
      responses:
        "200":
          description: "Random security tip"
          content:
            application/json:
              schema:
                type: "object"
              example:
                fortune: "Decentralization is not just technology, it is philosophy."
                category: "security"
                source: "ATV"
                timestamp: "2026-02-18T11:44:14.782Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
  /api/gas:
    get:
      tags:
        - "Free"
        - "Blockchain"
      summary: "Ethereum Gas Prices (Always Free)"
      operationId: "getGasPrices"
      x-price: "$0.001"
      responses:
        "200":
          description: "Current gas prices"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GasPricesExtended"
              example:
                chain: "ethereum"
                slow: 0.03
                standard: 0.04
                fast: 0.05
                unit: "gwei"
                source: "rpc"
                cached: false
                cachedAt: null
                timestamp: "2026-02-09T06:30:00.000Z"
        "400":
          description: "Bad Request - Invalid parameters or malformed request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Invalid parameter format"
                code: "INVALID_PARAMETER"
        "402":
          description: "Payment Required - Free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current Ethereum mainnet gas prices in Gwei. **Always free**.\n\n### Response Fields\n- **slow**: Safe low price (longer confirmation)\n- **standard**: Average price (normal confirmation)\n- **fast**: High price (fast confirmation)\n- **baseFee**: Current base fee\n\n### Use Cases\n- Estimate transaction costs\n- Choose optimal gas price\n- Monitor network congestion"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Network (ethereum, polygon, arbitrum)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/gas/all:
    get:
      tags:
        - "Chain"
      summary: "All chains gas"
      operationId: "getAllChainsGas"
      x-price: "$0.02"
      responses:
        "200":
          description: "Gas"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GasPrices"
              example:
                error: true
                code: "INVALID_CHAIN"
                message: "Supported chains: ethereum, base, arbitrum, optimism, polygon"
                timestamp: "2026-02-18T11:44:14.790Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Current gas prices for Ethereum"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Network (ethereum, polygon, arbitrum)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/gas/arbitrum:
    get:
      tags:
        - "Chain"
      summary: "Arbitrum gas prices"
      operationId: "getapiGasArbitrum"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GasPrices"
              example:
                chain: "arbitrum"
                slow: 0.02
                standard: 0.02
                fast: 0.02
                unit: "gwei"
                source: "rpc"
                _cache:
                  hit: false
                cached: false
                cachedAt: null
                timestamp: "2026-02-18T11:44:14.976Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Current gas prices for Ethereum"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Network (ethereum, polygon, arbitrum)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/gas/base:
    get:
      tags:
        - "Chain"
      summary: "Base chain gas prices"
      operationId: "getapiGasBase"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GasPrices"
              example:
                chain: "base"
                slow: 0
                standard: 0
                fast: 0
                unit: "gwei"
                source: "rpc"
                _cache:
                  hit: false
                cached: false
                cachedAt: null
                timestamp: "2026-02-18T11:44:15.124Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Current gas prices for Ethereum"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Network (ethereum, polygon, arbitrum)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/gas/bsc:
    get:
      tags:
        - "Chain"
      summary: "BSC gas"
      operationId: "getBscGas"
      x-price: "$0.01"
      responses:
        "200":
          description: "Gas"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GasPrices"
              example:
                error: true
                code: "INVALID_CHAIN"
                message: "Supported chains: ethereum, base, arbitrum, optimism, polygon"
                timestamp: "2026-02-18T11:44:15.137Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Current gas prices for Ethereum"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Network (ethereum, polygon, arbitrum)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/gas/chain/{chain}:
    get:
      tags:
        - "Chain"
      summary: "Gas by chain"
      operationId: "getGasByChain"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Gas"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GasPrices"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Current gas prices for Ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/gas/comparison:
    get:
      tags:
        - "Chain"
      summary: "Gas comparison"
      operationId: "getGasComparison"
      x-price: "$0.02"
      responses:
        "200":
          description: "Comparison"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GasPrices"
              example:
                error: true
                code: "INVALID_CHAIN"
                message: "Supported chains: ethereum, base, arbitrum, optimism, polygon"
                timestamp: "2026-02-18T11:45:02.094Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Current gas prices for Ethereum"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Network (ethereum, polygon, arbitrum)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/gas/estimate:
    get:
      tags:
        - "Chain"
      summary: "Gas estimate for tx types"
      operationId: "getapiGasEstimate"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GasPrices"
              example:
                error: true
                code: "INVALID_CHAIN"
                message: "Supported chains: ethereum, base, arbitrum, optimism, polygon"
                timestamp: "2026-02-18T11:45:02.102Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Current gas prices for Ethereum"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Network (ethereum, polygon, arbitrum)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/gas/ethereum:
    get:
      tags:
        - "Chain"
      summary: "Ethereum gas"
      operationId: "getEthereumGas"
      x-price: "$0.01"
      responses:
        "200":
          description: "Gas"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GasPrices"
              example:
                chain: "ethereum"
                slow: 0.03
                standard: 0.04
                fast: 0.05
                unit: "gwei"
                source: "rpc"
                _cache:
                  hit: false
                cached: false
                cachedAt: null
                timestamp: "2026-02-18T11:45:02.424Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Current gas prices for Ethereum"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Network (ethereum, polygon, arbitrum)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/gas/history:
    get:
      tags:
        - "Chain"
      summary: "Gas price history"
      operationId: "getapiGasHistory"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GasPrices"
              example:
                history:
                  - timestamp: 1707390000
                    fast: 45
                    standard: 38
                    slow: 32
                    baseFee: 30
                  - timestamp: 1707391800
                    fast: 48
                    standard: 40
                    slow: 34
                    baseFee: 31
                  - timestamp: 1707393600
                    fast: 45
                    standard: 38
                    slow: 32
                    baseFee: 30
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Current gas prices for Ethereum"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Network (ethereum, polygon, arbitrum)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/gas/optimism:
    get:
      tags:
        - "Chain"
      summary: "Optimism gas prices"
      operationId: "getapiGasOptimism"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GasPrices"
              example:
                chain: "optimism"
                slow: 0
                standard: 0
                fast: 0
                unit: "gwei"
                source: "rpc"
                _cache:
                  hit: false
                cached: false
                cachedAt: null
                timestamp: "2026-02-18T11:45:02.589Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Current gas prices for Ethereum"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Network (ethereum, polygon, arbitrum)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/gas/polygon:
    get:
      tags:
        - "Chain"
      summary: "Polygon gas prices"
      operationId: "getapiGasPolygon"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GasPrices"
              example:
                chain: "polygon"
                slow: 352
                standard: 440
                fast: 528
                unit: "gwei"
                source: "rpc"
                _cache:
                  hit: false
                cached: false
                cachedAt: null
                timestamp: "2026-02-18T11:45:02.887Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Current gas prices for Ethereum"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Network (ethereum, polygon, arbitrum)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/guild/{id}:
    get:
      tags:
        - "Social"
      summary: "Guild.xyz membership"
      operationId: "getapiGuild"
      x-price: "$0.01"
      parameters:
        - name: "id"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Unique identifier"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/guild/123 not found"
                timestamp: "2026-02-18T11:46:23.752Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/hacks:
    get:
      tags:
        - "Utilities"
      summary: "DeFi hacks tracker"
      operationId: "getapiHacks"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/historical/price/{token}:
    get:
      tags:
        - "Utilities"
      summary: "Historical token price"
      operationId: "getapiHistoricalPrice"
      x-price: "$0.02"
      parameters:
        - name: "token"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Token symbol or address"
          example: "ethereum"
        - name: "from"
          in: "query"
          schema:
            type: "string"
          description: "Start date (YYYY-MM-DD)"
          example: "2024-01-01"
        - name: "to"
          in: "query"
          schema:
            type: "string"
          description: "End date (YYYY-MM-DD)"
          example: "2024-12-31"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                symbol: "ETH"
                prices:
                  - timestamp: 1707350400
                    price: 3200.45
                    volume24h: 15200000000
                  - timestamp: 1707264000
                    price: 3178.92
                    volume24h: 14800000000
                  - timestamp: 1707177600
                    price: 3156.33
                    volume24h: 15400000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current price for a token (9-source fallback)"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/historical/tvl/{protocol}:
    get:
      tags:
        - "Utilities"
      summary: "Historical protocol TVL"
      operationId: "getapiHistoricalTvl"
      x-price: "$0.02"
      parameters:
        - name: "protocol"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Protocol slug"
          example: "aave"
        - name: "from"
          in: "query"
          schema:
            type: "string"
          description: "Start date (YYYY-MM-DD)"
          example: "2024-01-01"
        - name: "to"
          in: "query"
          schema:
            type: "string"
          description: "End date (YYYY-MM-DD)"
          example: "2024-12-31"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/activity:
    get:
      tags:
        - "L2"
      summary: "L2 activity stats"
      operationId: "getapiL2Activity"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "L2_ERROR"
                message: "Unexpected token '<', \"<!DOCTYPE \"... is not valid JSON"
                timestamp: "2026-02-18T11:46:24.344Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/arbitrum:
    get:
      tags:
        - "L2"
      summary: "Arbitrum L2 stats"
      operationId: "getArbitrumL2"
      x-price: "$0.01"
      responses:
        "200":
          description: "Arbitrum"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/balances/{address}:
    get:
      tags:
        - "L2"
      summary: "L2 balances across chains"
      operationId: "getapiL2Balances"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/base:
    get:
      tags:
        - "L2"
      summary: "Base L2 stats"
      operationId: "getBaseL2"
      x-price: "$0.01"
      responses:
        "200":
          description: "Base"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/blast:
    get:
      tags:
        - "L2"
      summary: "Blast L2 stats"
      operationId: "getBlastL2"
      x-price: "$0.01"
      responses:
        "200":
          description: "Blast"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "L2_ERROR"
                message: "Unexpected token '<', \"<!DOCTYPE \"... is not valid JSON"
                timestamp: "2026-02-18T11:46:24.539Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/comparison:
    get:
      tags:
        - "L2"
      summary: "L2 comparison"
      operationId: "getL2Comparison"
      x-price: "$0.02"
      responses:
        "200":
          description: "Comparison"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/fees:
    get:
      tags:
        - "L2"
      summary: "L2 fee comparison"
      operationId: "getapiL2Fees"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/linea:
    get:
      tags:
        - "L2"
      summary: "Linea L2 stats"
      operationId: "getLineaL2"
      x-price: "$0.01"
      responses:
        "200":
          description: "Linea"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "L2_ERROR"
                message: "Unexpected token '<', \"<!DOCTYPE \"... is not valid JSON"
                timestamp: "2026-02-18T11:47:16.286Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/mantle:
    get:
      tags:
        - "L2"
      summary: "Mantle L2 stats"
      operationId: "getMantleL2"
      x-price: "$0.01"
      responses:
        "200":
          description: "Mantle"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "L2_ERROR"
                message: "Unexpected token '<', \"<!DOCTYPE \"... is not valid JSON"
                timestamp: "2026-02-18T11:47:16.424Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/mode:
    get:
      tags:
        - "L2"
      summary: "Mode L2 stats"
      operationId: "getModeL2"
      x-price: "$0.01"
      responses:
        "200":
          description: "Mode"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "L2_ERROR"
                message: "Unexpected token '<', \"<!DOCTYPE \"... is not valid JSON"
                timestamp: "2026-02-18T11:47:16.562Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/optimism:
    get:
      tags:
        - "L2"
      summary: "Optimism L2 stats"
      operationId: "getOptimismL2"
      x-price: "$0.01"
      responses:
        "200":
          description: "Optimism"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/scaling:
    get:
      tags:
        - "L2"
      summary: "L2 scaling summary"
      operationId: "getapiL2Scaling"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/scroll:
    get:
      tags:
        - "L2"
      summary: "Scroll L2 stats"
      operationId: "getScrollL2"
      x-price: "$0.01"
      responses:
        "200":
          description: "Scroll"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "L2_ERROR"
                message: "Unexpected token '<', \"<!DOCTYPE \"... is not valid JSON"
                timestamp: "2026-02-18T11:47:56.536Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/starknet:
    get:
      tags:
        - "L2"
      summary: "Starknet L2 stats"
      operationId: "getStarknetL2"
      x-price: "$0.01"
      responses:
        "200":
          description: "Starknet"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "L2_ERROR"
                message: "Unexpected token '<', \"<!DOCTYPE \"... is not valid JSON"
                timestamp: "2026-02-18T11:47:56.685Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/tps:
    get:
      tags:
        - "L2"
      summary: "L2 TPS comparison"
      operationId: "getapiL2Tps"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/tvl/{project}:
    get:
      tags:
        - "L2"
      summary: "L2 project TVL"
      operationId: "getapiL2Tvl"
      x-price: "$0.01"
      parameters:
        - name: "project"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "project"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/l2/zksync:
    get:
      tags:
        - "L2"
      summary: "zkSync L2 stats"
      operationId: "getZkSyncL2"
      x-price: "$0.01"
      responses:
        "200":
          description: "zkSync"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "L2_ERROR"
                message: "Unexpected token '<', \"<!DOCTYPE \"... is not valid JSON"
                timestamp: "2026-02-18T11:47:56.835Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Layer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/leaderboard:
    get:
      tags:
        - "Social"
      summary: "Top accounts by follower count"
      operationId: "getapiLeaderboard"
      x-price: "$0.02"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/leaderboard not found"
                timestamp: "2026-02-18T11:47:56.842Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/aave:
    get:
      tags:
        - "DeFi"
      summary: "Aave stats"
      operationId: "getapiLendingAave"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/benqi:
    get:
      tags:
        - "DeFi"
      summary: "BENQI lending"
      operationId: "getBenqiLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "BENQI"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/by-chain/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "Lending by chain"
      operationId: "getLendingByChain"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Lending"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/compound:
    get:
      tags:
        - "DeFi"
      summary: "Compound stats"
      operationId: "getapiLendingCompound"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/cream:
    get:
      tags:
        - "DeFi"
      summary: "C.R.E.A.M. lending"
      operationId: "getCreamLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "CREAM"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/euler:
    get:
      tags:
        - "DeFi"
      summary: "Euler lending"
      operationId: "getEulerLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Euler"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/fluid:
    get:
      tags:
        - "DeFi"
      summary: "Fluid lending"
      operationId: "getFluidLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Fluid"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/fraxlend:
    get:
      tags:
        - "DeFi"
      summary: "Fraxlend"
      operationId: "getFraxlendLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Fraxlend"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/goldfinch:
    get:
      tags:
        - "DeFi"
      summary: "Goldfinch lending"
      operationId: "getGoldfinchLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Goldfinch"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/iron-bank:
    get:
      tags:
        - "DeFi"
      summary: "Iron Bank lending"
      operationId: "getIronBankLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Iron Bank"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/kamino:
    get:
      tags:
        - "DeFi"
      summary: "Kamino lending"
      operationId: "getKaminoLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Kamino"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/list:
    get:
      tags:
        - "DeFi"
      summary: "Lending protocols list"
      operationId: "getLendingList"
      x-price: "$0.01"
      responses:
        "200":
          description: "List"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/makerdao:
    get:
      tags:
        - "DeFi"
      summary: "MakerDAO stats"
      operationId: "getapiLendingMakerdao"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/maple:
    get:
      tags:
        - "DeFi"
      summary: "Maple lending"
      operationId: "getMapleLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Maple"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/morpho:
    get:
      tags:
        - "DeFi"
      summary: "Morpho lending"
      operationId: "getMorphoLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Morpho"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/notional:
    get:
      tags:
        - "DeFi"
      summary: "Notional lending"
      operationId: "getNotionalLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Notional"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/radiant:
    get:
      tags:
        - "DeFi"
      summary: "Radiant lending"
      operationId: "getRadiantLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Radiant"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/rates:
    get:
      tags:
        - "DeFi"
      summary: "Lending rates comparison"
      operationId: "getapiLendingRates"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/silo:
    get:
      tags:
        - "DeFi"
      summary: "Silo lending"
      operationId: "getSiloLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Silo"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/spark:
    get:
      tags:
        - "DeFi"
      summary: "Spark lending"
      operationId: "getSparkLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Spark"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/top:
    get:
      tags:
        - "DeFi"
      summary: "Top lending protocols"
      operationId: "getTopLendingProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "Top lending"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/venus:
    get:
      tags:
        - "DeFi"
      summary: "Venus lending"
      operationId: "getVenusLending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Venus"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/{protocol}:
    get:
      tags:
        - "DeFi"
      summary: "Lending protocol data"
      operationId: "getLendingProtocol"
      x-price: "$0.01"
      parameters:
        - name: "protocol"
          in: "path"
          required: true
          description: "DeFi protocol identifier"
          schema:
            type: "string"
          example: "aave"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lending/{protocol}/rates:
    get:
      tags:
        - "DeFi"
      summary: "Protocol lending rates"
      operationId: "getProtocolLendingRates"
      x-price: "$0.01"
      parameters:
        - name: "protocol"
          in: "path"
          required: true
          description: "DeFi protocol identifier"
          schema:
            type: "string"
          example: "aave"
      responses:
        "200":
          description: "Rates"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lens/address/{address}:
    get:
      tags:
        - "Social"
      summary: "Lens by ETH address"
      operationId: "getLensByAddress"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Profiles"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Wallet"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lens/explore:
    get:
      tags:
        - "Social"
      summary: "Explore Lens"
      operationId: "exploreLens"
      x-price: "$0.02"
      responses:
        "200":
          description: "Popular posts"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "DEPRECATED"
                message: "Explore feed requires authentication in Lens v3 API. Use /accounts for recent accounts."
                timestamp: "2026-02-18T11:50:18.148Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lens/profile/{handle}:
    get:
      tags:
        - "Social"
      summary: "Lens profile"
      operationId: "getLensProfile"
      x-price: "$0.02"
      parameters:
        - name: "handle"
          in: "path"
          required: true
          description: "Farcaster handle (without @)"
          schema:
            type: "string"
          example: "stani"
      responses:
        "200":
          description: "Profile"
          content:
            application/json:
              schema:
                type: "object"
              example:
                handle: "lens/vitalik"
                localName: "vitalik"
                address: "0xe4AaA97cdA406c6AF7C02a5260a8013910bd683C"
                name: "Vitalik Buterin"
                bio: "mi pinxe lo crino tcati"
                picture: "https://ik.imagekit.io/lens/6a5c67c2bff07e56d352d29cf0a858b67690dc25fc49d2f30ecf347d00348184_kX7EqG2mt.webp"
                score: 9990
                source: "lens"
                timestamp: "2026-02-18T12:01:26.537Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Lens Protocol profile"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/lens/profile/{handle}/followers:
    get:
      tags:
        - "Social"
      summary: "Lens followers"
      operationId: "getLensFollowers"
      x-price: "$0.02"
      parameters:
        - name: "handle"
          in: "path"
          required: true
          description: "Farcaster handle (without @)"
          schema:
            type: "string"
          example: "stani"
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
          description: "Maximum number of results to return"
          example: 10
      responses:
        "200":
          description: "Followers"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
        "501":
          description: "Not Implemented - Lens v3 requires authentication"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
      description: "⚠️ **DEPRECATED:** Lens v3 API requires authentication for this endpoint. Implementation is not currently planned.\n\nNOTE: Returns 501 - Lens v3 API requires authentication for this endpoint. Not currently implemented."
      deprecated: true
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      x-deprecation-notice: "Lens v3 API requires authentication for this endpoint. Implementation is not currently planned."
      x-deprecation-category: "upstream_breaking_change"
      x-migration-guide: "Lens v3 API requires OAuth authentication which is not supported by this API. Consider using the Lens v3 API directly with proper authentication, or use alternative social graph APIs (e.g., Farcaster via /api/farcaster endpoints)."
      x-removal-target: "v3.0.0 (TBD)"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/lens/profile/{handle}/following:
    get:
      tags:
        - "Social"
      summary: "Lens following"
      operationId: "getLensFollowing"
      x-price: "$0.02"
      parameters:
        - name: "handle"
          in: "path"
          required: true
          description: "Farcaster handle (without @)"
          schema:
            type: "string"
          example: "stani"
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
          description: "Maximum number of results to return"
          example: 10
      responses:
        "200":
          description: "Following"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "AUTH_REQUIRED"
                message: "Following endpoint requires Lens API authentication"
                timestamp: "2026-02-18T12:01:26.545Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
        "501":
          description: "Not Implemented - Lens v3 requires authentication"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
      description: "⚠️ **DEPRECATED:** Lens v3 API requires authentication for this endpoint. Implementation is not currently planned.\n\nNOTE: Returns 501 - Lens v3 API requires authentication for this endpoint. Not currently implemented."
      deprecated: true
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      x-deprecation-notice: "Lens v3 API requires authentication for this endpoint. Implementation is not currently planned."
      x-deprecation-category: "upstream_breaking_change"
      x-migration-guide: "Lens v3 API requires OAuth authentication which is not supported by this API. Consider using the Lens v3 API directly with proper authentication, or use alternative social graph APIs (e.g., Farcaster via /api/farcaster endpoints)."
      x-removal-target: "v3.0.0 (TBD)"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/lens/profile/{handle}/posts:
    get:
      tags:
        - "Social"
      summary: "Lens posts"
      operationId: "getLensPosts"
      x-price: "$0.02"
      parameters:
        - name: "handle"
          in: "path"
          required: true
          description: "Farcaster handle (without @)"
          schema:
            type: "string"
          example: "stani"
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
          description: "Maximum number of results to return"
          example: 10
      responses:
        "200":
          description: "Posts"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
        "501":
          description: "Not Implemented - Lens v3 requires authentication"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
      description: "⚠️ **DEPRECATED:** Lens v3 API requires authentication for this endpoint. Implementation is not currently planned.\n\nNOTE: Returns 501 - Lens v3 API requires authentication for this endpoint. Not currently implemented."
      deprecated: true
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      x-deprecation-notice: "Lens v3 API requires authentication for this endpoint. Implementation is not currently planned."
      x-deprecation-category: "upstream_breaking_change"
      x-migration-guide: "Lens v3 API requires OAuth authentication which is not supported by this API. Consider using the Lens v3 API directly with proper authentication, or use alternative social graph APIs (e.g., Farcaster via /api/farcaster endpoints)."
      x-removal-target: "v3.0.0 (TBD)"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/lens/search:
    get:
      tags:
        - "Social"
      summary: "Search Lens profiles"
      operationId: "searchLens"
      x-price: "$0.02"
      parameters:
        - name: "q"
          in: "query"
          required: true
          description: "Search query string"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Results"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "AUTH_REQUIRED"
                message: "Search requires Lens API authentication"
                timestamp: "2026-02-18T11:50:31.998Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
        "501":
          description: "Not Implemented - Lens v3 requires authentication"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
      description: "⚠️ **DEPRECATED:** Lens v3 API requires authentication for this endpoint. Implementation is not currently planned.\n\nNOTE: Returns 501 - Lens v3 API requires authentication for this endpoint. Not currently implemented."
      deprecated: true
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      x-deprecation-notice: "Lens v3 API requires authentication for this endpoint. Implementation is not currently planned."
      x-deprecation-category: "upstream_breaking_change"
      x-migration-guide: "Lens v3 API requires OAuth authentication which is not supported by this API. Consider using the Lens v3 API directly with proper authentication, or use alternative social graph APIs (e.g., Farcaster via /api/farcaster endpoints)."
      x-removal-target: "v3.0.0 (TBD)"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/lens/stats:
    get:
      tags:
        - "Social"
      summary: "Lens protocol stats"
      operationId: "getLensStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "410":
          description: "Gone - Feature removed in Lens v3"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ **DEPRECATED:** Global protocol stats were removed in Lens v3 API and are no longer available.\n\nDEPRECATED: Global protocol stats removed in Lens v3 API. Returns 410 Gone."
      deprecated: true
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      x-deprecation-notice: "Global protocol stats were removed in Lens v3 API and are no longer available."
      x-deprecation-category: "upstream_removed"
      x-migration-guide: "This endpoint returns 410 Gone. No direct replacement available. Consider aggregating data from individual profile queries or using third-party Lens analytics services."
      x-removal-target: "v3.0.0 (TBD)"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/liquidations:
    get:
      tags:
        - "DeFi"
      summary: "Protocol liquidations"
      operationId: "getapiLiquidations"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/liquidations/{protocol}:
    get:
      tags:
        - "DeFi"
      summary: "Protocol liquidation levels"
      operationId: "getLiquidationsByProtocol"
      x-price: "$0.01"
      parameters:
        - name: "protocol"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Protocol slug"
          example: "aave"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/liquidations/aave not found"
                timestamp: "2026-02-18T12:01:26.556Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/logs:
    get:
      tags:
        - "Chain"
      summary: "Contract event logs"
      operationId: "getapiLogs"
      x-price: "$0.02"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/cap:
    get:
      tags:
        - "Prices"
      summary: "Top coins by market cap"
      operationId: "getapiMarketCap"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/market/cap not found"
                timestamp: "2026-02-18T12:03:21.611Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/categories:
    get:
      tags:
        - "Prices"
      summary: "Market categories"
      operationId: "getCategories"
      x-price: "$0.01"
      responses:
        "200":
          description: "Categories"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/compare/{ids}:
    get:
      tags:
        - "Prices"
      summary: "Compare multiple coins"
      operationId: "compareCoins"
      x-price: "$0.02"
      parameters:
        - name: "ids"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Comma-separated coin IDs"
          example: "bitcoin"
      responses:
        "200":
          description: "Comparison"
          content:
            application/json:
              schema:
                type: "object"
              example:
                comparison:
                  - id: "bitcoin"
                    name: "Bitcoin"
                    symbol: "btc"
                    price: 67450
                    marketCap: 1346694096152
                    change24h: -0.61302
                    volume24h: 37173493604
                  - id: "ethereum"
                    name: "Ethereum"
                    symbol: "eth"
                    price: 1982.99
                    marketCap: 239080086837
                    change24h: 0.70123
                    volume24h: 23915156544
                source: "coingecko"
                timestamp: "2026-02-18T12:03:21.708Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/derivatives:
    get:
      tags:
        - "Prices"
      summary: "Derivatives market"
      operationId: "getDerivativesMarket"
      x-price: "$0.01"
      responses:
        "200":
          description: "Derivatives"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/derivatives/exchanges:
    get:
      tags:
        - "Prices"
      summary: "Derivatives exchanges"
      operationId: "getDerivativesExchanges"
      x-price: "$0.01"
      responses:
        "200":
          description: "Deriv exchanges"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/dominance:
    get:
      tags:
        - "Prices"
      summary: "BTC/ETH dominance"
      operationId: "getapiMarketDominance"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "ERROR"
                message: "An internal error occurred"
                timestamp: "2026-02-18T12:03:21.776Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/exchange/{id}:
    get:
      tags:
        - "Prices"
      summary: "Exchange details"
      operationId: "getExchange"
      x-price: "$0.01"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Unique identifier"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Exchange data"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "ERROR"
                message: "HTTP 404"
                timestamp: "2026-02-18T12:03:21.841Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/exchanges:
    get:
      tags:
        - "Prices"
      summary: "Exchange rankings"
      operationId: "getExchanges"
      x-price: "$0.01"
      responses:
        "200":
          description: "Exchanges"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/fear-greed:
    get:
      tags:
        - "Prices"
      summary: "Fear & Greed Index"
      operationId: "getapiMarketFeargreed"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Crypto Fear & Greed Index"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/fear-greed/history:
    get:
      tags:
        - "Prices"
      summary: "Fear & Greed history"
      operationId: "getFearGreedHistory"
      x-price: "$0.01"
      parameters:
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
          description: "Maximum number of results to return"
          example: 10
      responses:
        "200":
          description: "F&G history"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "ERROR"
                message: "An internal error occurred"
                timestamp: "2026-02-18T12:18:39.527Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Crypto Fear & Greed Index"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/gainers:
    get:
      tags:
        - "Prices"
      summary: "Top gainers 24h"
      operationId: "getapiMarketGainers"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/global:
    get:
      summary: "Global Market Stats"
      operationId: "getGlobalMarket"
      tags:
        - "Market"
        - "Analytics"
      description: "Get global cryptocurrency market statistics.\n\n### Response Includes\n- Total market cap\n- 24h trading volume\n- BTC/ETH dominance\n- Number of active cryptocurrencies\n- Fear & Greed Index\n\n### Pricing\n- **$0.01** per request"
      responses:
        "200":
          description: "Global market data"
          content:
            application/json:
              example:
                totalMarketCap: 2450000000000
                totalVolume24h: 85000000000
                btcDominance: 52.3
                ethDominance: 17.8
                activeCryptos: 12450
                fearGreedIndex: 65
                fearGreedLabel: "Greed"
                timestamp: "2026-02-08T03:15:00.000Z"
              schema:
                type: "object"
                properties:
                  totalMarketCap:
                    type: "number"
                  totalVolume24h:
                    type: "number"
                  btcDominance:
                    type: "number"
                  timestamp:
                    type: "string"
        "400":
          description: "Bad Request - Invalid parameters or malformed request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Invalid parameter format"
                code: "INVALID_PARAMETER"
        "402":
          description: "Payment Required - Free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
  /api/market/losers:
    get:
      tags:
        - "Prices"
      summary: "Top losers 24h"
      operationId: "getapiMarketLosers"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/movers/1h:
    get:
      tags:
        - "Prices"
      summary: "Top movers (1 hour)"
      operationId: "getMovers1h"
      x-price: "$0.01"
      responses:
        "200":
          description: "1h movers"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "ERROR"
                message: "r.json is not a function"
                timestamp: "2026-02-18T12:18:39.605Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/movers/24h:
    get:
      tags:
        - "Prices"
      summary: "Top movers (24 hours)"
      operationId: "getMovers24h"
      x-price: "$0.01"
      responses:
        "200":
          description: "24h movers"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "ERROR"
                message: "gainersRes.json is not a function"
                timestamp: "2026-02-18T12:18:39.678Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/movers/7d:
    get:
      tags:
        - "Prices"
      summary: "Top movers (7 days)"
      operationId: "getMovers7d"
      x-price: "$0.01"
      responses:
        "200":
          description: "7d movers"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "ERROR"
                message: "An internal error occurred"
                timestamp: "2026-02-18T12:18:39.881Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/sector/{id}:
    get:
      tags:
        - "Prices"
      summary: "Sector details"
      operationId: "getSector"
      x-price: "$0.01"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Unique identifier"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Sector data"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "ERROR"
                message: "HTTP 404"
                timestamp: "2026-02-18T12:18:39.954Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/sectors:
    get:
      tags:
        - "Prices"
      summary: "Market sectors"
      operationId: "getSectors"
      x-price: "$0.01"
      responses:
        "200":
          description: "Sectors"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/sentiment:
    get:
      tags:
        - "Prices"
      summary: "Market sentiment"
      operationId: "getSentiment"
      x-price: "$0.01"
      responses:
        "200":
          description: "Sentiment"
          content:
            application/json:
              schema:
                type: "object"
              example:
                value: 8
                classification: "Extreme Fear"
                updated: "1771372800"
                source: "alternative.me"
                timestamp: "2026-02-18T12:40:32.918Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/stats:
    get:
      tags:
        - "Prices"
      summary: "Detailed market stats"
      operationId: "getMarketStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Market statistics"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/top:
    get:
      tags:
        - "Prices"
      summary: "Top coins by market cap"
      operationId: "getTopCoins"
      x-price: "$0.01"
      parameters:
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
          description: "Maximum number of results to return"
          example: 10
      responses:
        "200":
          description: "Top coins"
          content:
            application/json:
              schema:
                type: "object"
              example:
                coins:
                  - rank: 1
                    name: "Bitcoin"
                    symbol: "btc"
                    price: 67417
                    marketCap: 1346819939782
                    volume24h: 36757562003
                    change24h: -0.9754
                  - rank: 2
                    name: "Ethereum"
                    symbol: "eth"
                    price: 1977.29
                    marketCap: 238211194240
                    volume24h: 24170310183
                    change24h: 0.34261
                  - rank: 3
                    name: "Tether"
                    symbol: "usdt"
                    price: 0.999675
                    marketCap: 183681563728
                    volume24h: 62673173931
                    change24h: 0.00225
                count: 20
                source: "coingecko"
                timestamp: "2026-02-18T12:40:33.014Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/trending:
    get:
      tags:
        - "Prices"
      summary: "Trending coins"
      operationId: "getTrending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Trending"
          content:
            application/json:
              schema:
                type: "object"
              example:
                coins:
                  - name: "Bitcoin"
                    symbol: "BTC"
                    marketCapRank: 1
                    priceBtc: 1
                    score: 0
                  - name: "World Liberty Financial"
                    symbol: "WLFI"
                    marketCapRank: 33
                    priceBtc: 0.0000018242006129534427
                    score: 1
                  - name: "Solana"
                    symbol: "SOL"
                    marketCapRank: 7
                    priceBtc: 0.0012299130912611523
                    score: 2
                nfts:
                  - name: "Bitcoin Shrooms"
                    symbol: "BITCOINSHROOMS"
                    floorPriceUsd: 0.33
                  - name: "Milady Maker"
                    symbol: "MIL"
                    floorPriceUsd: 1.19
                  - name: "Lil Pudgys"
                    symbol: "LilPudgys"
                    floorPriceUsd: 0.53
                  - name: "Pudgy Penguins"
                    symbol: "PPG"
                    floorPriceUsd: 4.389999
                  - name: "Azuki"
                    symbol: "AZUKI"
                    floorPriceUsd: 0.7499
                source: "coingecko"
                timestamp: "2026-02-18T12:40:33.140Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Trending tokens and protocols"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/trending/coins:
    get:
      tags:
        - "Prices"
      summary: "Trending coins only"
      operationId: "getTrendingCoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Trending coins"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Trending tokens and protocols"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/volume:
    get:
      tags:
        - "Prices"
      summary: "Top coins by volume"
      operationId: "getapiMarketVolume"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/market/{token}:
    get:
      tags:
        - "Prices"
      summary: "Token market data"
      operationId: "getapiMarket"
      x-price: "$0.01"
      parameters:
        - name: "token"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Token symbol or address"
          example: "ethereum"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented. Status: Planned feature. This route will return 404 in production.\n\nToken market data"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/movers/1h:
    get:
      tags:
        - "Prices"
      summary: "Top movers 1h"
      operationId: "getapiMovers1h"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Not Found"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/movers/1h not found"
                timestamp: "2026-02-18T12:40:33.202Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented. Status: Planned feature. This route will return 404 in production.\n\nTop movers 1h"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/movers/24h:
    get:
      tags:
        - "Prices"
      summary: "Top movers 24h"
      operationId: "getapiMovers24h"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Not Found"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/movers/24h not found"
                timestamp: "2026-02-18T13:05:48.345Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented. Status: Planned feature. This route will return 404 in production.\n\nTop movers 24h"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/movers/7d:
    get:
      tags:
        - "Prices"
      summary: "Top movers 7d"
      operationId: "getapiMovers7d"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Not Found"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/movers/7d not found"
                timestamp: "2026-02-18T13:05:48.379Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented. Status: Planned feature. This route will return 404 in production.\n\nTop movers 7d"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/multichain/bridges:
    get:
      tags:
        - "L2"
      summary: "Cross-chain bridge stats"
      operationId: "getapiMultichainBridges"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Arbitrum Bridge"
                volume24h: 234000000
                txCount24h: 45678
                chains:
                  - "ethereum"
                  - "arbitrum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/multichain/tvl:
    get:
      tags:
        - "L2"
      summary: "Multi-chain protocol TVL"
      operationId: "getapiMultichainTvl"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/multichain/{address}:
    get:
      tags:
        - "L2"
      summary: "Multi-chain ETH balances"
      operationId: "getapiMultichain"
      x-price: "$0.03"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented. Status: Planned feature. This route will return 404 in production.\n\nMulti-chain ETH balances"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/mutuals/{name}:
    get:
      tags:
        - "Social"
      summary: "Mutual followers (follow each other)"
      operationId: "getapiMutuals"
      x-price: "$0.03"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented. Status: Planned feature. This route will return 404 in production.\n\nMutual followers (follow each other)"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/network/arbitrum/status:
    get:
      tags:
        - "Chain"
      summary: "Arbitrum network status"
      operationId: "getArbitrumStatus"
      x-price: "$0.01"
      responses:
        "200":
          description: "Status"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/network/base/status:
    get:
      tags:
        - "Chain"
      summary: "Base network status"
      operationId: "getBaseStatus"
      x-price: "$0.01"
      responses:
        "200":
          description: "Status"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/network/ethereum/status:
    get:
      tags:
        - "Chain"
      summary: "Ethereum network status"
      operationId: "getEthereumStatus"
      x-price: "$0.01"
      responses:
        "200":
          description: "Status"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/network/events:
    get:
      tags:
        - "DeFi"
      summary: "Crypto events"
      operationId: "getCryptoEvents"
      x-price: "$0.02"
      responses:
        "200":
          description: "Events"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/network/events/upcoming:
    get:
      tags:
        - "DeFi"
      summary: "Upcoming events"
      operationId: "getUpcomingEvents"
      x-price: "$0.02"
      responses:
        "200":
          description: "Events"
          content:
            application/json:
              schema:
                type: "object"
              example:
                events:
                  - id: "63515-sec-etf-vaneck-decision"
                    date: "2018-07-10T12:00:00Z"
                    date_to: null
                    name: "SEC- ETF VanEck decision"
                    description: ""
                    is_conference: false
                    link: "https://www.criptonoticias.com/mercado-valores/etf-bitcoin-tratan-posibilidades-abiertas/"
                    proof_image_link: null
                  - id: "62955-super-conference"
                    date: "2018-09-28T20:00:00Z"
                    date_to: "2018-09-30T16:00:00Z"
                    name: "Super Conference"
                    description: "KWIC, Kitchener - Waterloo, ON, Canada. 29 September, 2018"
                    is_conference: true
                    link: "https://blockchainsuperconference.com/"
                    proof_image_link: "https://static.coinpaprika.com/storage/cdn/event_images/448695.jpg"
                  - id: "65459-blockchain-amp-bitcoin-conference-switzerland"
                    date: "2018-10-09T09:00:00Z"
                    date_to: "2018-10-09T18:00:00Z"
                    name: "Blockchain & Bitcoin Conference Switzerland"
                    description: "The second conference organized by Smile-Expo company in Geneva, the European fintech hub. The conference will also feature the demozone. "
                    is_conference: true
                    link: "https://switzerland.bc.events/?utm_source=pr_LY&utm_medium=listing&utm_campaign=coinpaprika.com"
                    proof_image_link: "https://static.coinpaprika.com/storage/cdn/event_images/6602959.jpg"
                source: "coinpaprika"
                timestamp: "2026-02-18T13:05:48.603Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/network/metrics/arbitrum:
    get:
      tags:
        - "Chain"
      summary: "Arbitrum metrics"
      operationId: "getArbitrumMetrics"
      x-price: "$0.01"
      responses:
        "200":
          description: "Metrics"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "arbitrum"
                blockHeight: 433403813
                gasPrice: 0.020592
                gasPriceUnit: "gwei"
                timestamp: "2026-02-18T13:11:55.826Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/network/metrics/base:
    get:
      tags:
        - "Chain"
      summary: "Base metrics"
      operationId: "getBaseMetrics"
      x-price: "$0.01"
      responses:
        "200":
          description: "Metrics"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "base"
                blockHeight: 42315484
                gasPrice: 0.011155642
                gasPriceUnit: "gwei"
                timestamp: "2026-02-18T13:11:55.914Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/network/metrics/btc:
    get:
      tags:
        - "Prices"
      summary: "BTC metrics"
      operationId: "getBtcMetrics"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/network/metrics/eth:
    get:
      tags:
        - "Prices"
      summary: "ETH metrics"
      operationId: "getEthMetrics"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/network/metrics/ethereum:
    get:
      tags:
        - "Chain"
      summary: "Ethereum metrics"
      operationId: "getEthereumMetrics"
      x-price: "$0.01"
      responses:
        "200":
          description: "Metrics"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "ethereum"
                blockHeight: 24483937
                gasPrice: 0.055982638
                gasPriceUnit: "gwei"
                timestamp: "2026-02-18T13:11:56.168Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/network/optimism/status:
    get:
      tags:
        - "Chain"
      summary: "Optimism network status"
      operationId: "getOptimismStatus"
      x-price: "$0.01"
      responses:
        "200":
          description: "Status"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/network/polygon/status:
    get:
      tags:
        - "Chain"
      summary: "Polygon network status"
      operationId: "getPolygonStatus"
      x-price: "$0.01"
      responses:
        "200":
          description: "Status"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/network/status/all:
    get:
      tags:
        - "Chain"
      summary: "All networks status"
      operationId: "getAllNetworksStatus"
      x-price: "$0.02"
      responses:
        "200":
          description: "Statuses"
          content:
            application/json:
              schema:
                type: "object"
              example:
                networks:
                  - network: "ethereum"
                    syncing: false
                    healthy: true
                    latencyMs: 132
                    timestamp: "2026-02-18T13:18:13.553Z"
                  - network: "base"
                    syncing: false
                    healthy: true
                    latencyMs: 56
                    timestamp: "2026-02-18T13:18:13.477Z"
                  - network: "arbitrum"
                    syncing: false
                    healthy: true
                    latencyMs: 124
                    timestamp: "2026-02-18T13:18:13.545Z"
                healthy: 8
                total: 9
                healthPercentage: 89
                timestamp: "2026-02-18T13:18:13.612Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/nft:
    get:
      tags:
        - "NFT"
      summary: "NFT overview"
      operationId: "getNftOverview"
      x-price: "$0.01"
      responses:
        "200":
          description: "Overview"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTCollectionsListResponse"
              example: &ref_0
                totalCollections: 100
                page: 1
                limit: 10
                count: 10
                collections:
                  - id: "cryptopunks"
                    name: "CryptoPunks"
                    symbol: "PUNK"
                    platform: "ethereum"
                    contract: "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB"
                  - id: "bored-ape-yacht-club"
                    name: "Bored Ape Yacht Club"
                    symbol: "BAYC"
                    platform: "ethereum"
                    contract: "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
                  - id: "pudgy-penguins"
                    name: "Pudgy Penguins"
                    symbol: "PPG"
                    platform: "ethereum"
                    contract: "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"
                  - id: "hypurr-hyperevm"
                    name: "Hypurr"
                    symbol: "HYPURR"
                    platform: "hyperevm"
                    contract: "0x9125e2d6827a00b0f8330d6ef7bef07730bac685"
                  - id: "autoglyphs"
                    name: "Autoglyphs"
                    symbol: "☵"
                    platform: "ethereum"
                    contract: "0xd4e4078ca3495de5b1d4db434bebc5a986197782"
                  - id: "chromie-squiggle-by-snowfro"
                    name: "Chromie Squiggle by Snowfro"
                    symbol: "BLOCKS"
                    platform: "ethereum"
                    contract: "0x059edd72cd353df5106d2b9cc5ab83a52287ac3a"
                  - id: "fidenza-by-tyler-hobbs"
                    name: "Fidenza by Tyler Hobbs"
                    symbol: "BLOCKS"
                    platform: "ethereum"
                    contract: "0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270"
                  - id: "mutant-ape-yacht-club"
                    name: "Mutant Ape Yacht Club"
                    symbol: "MAYC"
                    platform: "ethereum"
                    contract: "0x60e4d786628fea6478f785a6d7e704777c86a7c6"
                  - id: "veefriends"
                    name: "VeeFriends"
                    symbol: "VFT"
                    platform: "ethereum"
                    contract: "0xa3aee8bce55beea1951ef834b99f3ac60d1abeeb"
                  - id: "milady-maker"
                    name: "Milady Maker"
                    symbol: "MIL"
                    platform: "ethereum"
                    contract: "0x5af0d9827e0c53e4799bb226655a1de152a425a5"
                source: "coingecko"
                cached: false
                timestamp: "2026-02-18T04:15:59.760Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/nft/activity/{contract}:
    get:
      tags:
        - "NFT"
      summary: "NFT collection activity"
      operationId: "getapiNftActivity"
      x-price: "$0.02"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Contract address"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/azuki:
    get:
      tags:
        - "NFT"
      summary: "Azuki stats"
      operationId: "getapiNftAzuki"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/bayc:
    get:
      tags:
        - "NFT"
      summary: "BAYC floor & stats"
      operationId: "getapiNftBayc"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/blur:
    get:
      tags:
        - "NFT"
      summary: "Blur stats"
      operationId: "getBlurNft"
      x-price: "$0.01"
      responses:
        "200":
          description: "Blur"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTMarketplaceResponse"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/nft/collection/{id}:
    get:
      tags:
        - "NFT"
      summary: "NFT collection details"
      description: "Get detailed information about an NFT collection including floor price and volume"
      operationId: "getNftCollection"
      x-price: "$0.02"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Collection slug (e.g., cryptopunks, bored-ape-yacht-club)"
          schema:
            type: "string"
          example: "cryptopunks"
      responses:
        "200":
          description: "Collection details"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTCollectionResponse"
              example:
                id: "cryptopunks"
                name: "CryptoPunks"
                symbol: "PUNK"
                floorPrice: 29.85
                floorPriceUsd: 59440
                marketCap: 594039503
                volume24h: 69476
                owners: 3991
                totalSupply: 9994
                source: "coingecko"
                timestamp: "2026-02-18T00:35:53.752Z"
        "404":
          description: "Collection not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
              example:
                error: true
                code: "NFT_ERROR"
                message: "HTTP 404"
                timestamp: "2026-02-18T00:35:48.969Z"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/nft/collections:
    get:
      tags:
        - "NFT"
      summary: "List top NFT collections"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet a list of top NFT collections by market cap or volume"
      operationId: "getNftCollections"
      x-price: "$0.01"
      responses:
        "200":
          description: "List of collections"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTCollectionsListResponse"
              example: *ref_0
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
            default: 50
          description: "Max items to return"
          example: 10
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/lending:
    get:
      tags:
        - "NFT"
      summary: "NFT lending protocols"
      operationId: "getNftLendingProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "Lending"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTLendingProtocolsResponse"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-deprecation-category: "contract_mismatch"
      x-migration-guide: "docs/migrations/nft-endpoints-deprecation.md"
      description: "⚠️ **Contract Mismatch:** This endpoint currently returns NFT collection metadata instead of NFT lending protocol aggregation. This is a known issue documented in `docs/contract-truth-map.md`. \n\n**Status:** Deprecated due to response contract mismatch. The endpoint will be updated in a future release to return the correct data type, or replaced with a properly named endpoint.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/lending/arcade:
    get:
      tags:
        - "NFT"
      summary: "Arcade NFT lending"
      operationId: "getArcade"
      x-price: "$0.01"
      responses:
        "200":
          description: "Arcade"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTMarketplaceResponse"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/nft/lending/bend:
    get:
      tags:
        - "NFT"
      summary: "BendDAO NFT lending"
      operationId: "getBendDao"
      x-price: "$0.01"
      responses:
        "200":
          description: "BendDAO"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTMarketplaceResponse"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/nft/lending/nftfi:
    get:
      tags:
        - "NFT"
      summary: "NFTfi lending"
      operationId: "getNftFi"
      x-price: "$0.01"
      responses:
        "200":
          description: "NFTfi"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTMarketplaceResponse"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/nft/looksrare:
    get:
      tags:
        - "NFT"
      summary: "LooksRare stats"
      operationId: "getLooksRare"
      x-price: "$0.01"
      responses:
        "200":
          description: "LooksRare"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTMarketplaceResponse"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/nft/magiceden:
    get:
      tags:
        - "NFT"
      summary: "Magic Eden stats"
      operationId: "getMagicEden"
      x-price: "$0.01"
      responses:
        "200":
          description: "Magic Eden"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTMarketplaceResponse"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/nft/marketplaces:
    get:
      tags:
        - "NFT"
      summary: "NFT marketplaces"
      operationId: "getNftMarketplaces"
      x-price: "$0.01"
      responses:
        "200":
          description: "Marketplaces"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTMarketplacesResponse"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-deprecation-category: "contract_mismatch"
      x-migration-guide: "docs/migrations/nft-endpoints-deprecation.md"
      description: "⚠️ **Contract Mismatch:** This endpoint currently returns NFT collection metadata instead of marketplace aggregation. This is a known issue documented in `docs/contract-truth-map.md`. \n\n**Status:** Deprecated due to response contract mismatch. The endpoint will be updated in a future release to return the correct data type, or replaced with a properly named endpoint.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/opensea:
    get:
      tags:
        - "NFT"
      summary: "OpenSea stats"
      operationId: "getOpenSea"
      x-price: "$0.01"
      responses:
        "200":
          description: "OpenSea"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTMarketplaceResponse"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/nft/pudgy:
    get:
      tags:
        - "NFT"
      summary: "Pudgy Penguins stats"
      operationId: "getapiNftPudgy"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/punks:
    get:
      tags:
        - "NFT"
      summary: "CryptoPunks stats"
      operationId: "getapiNftPunks"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/rarible:
    get:
      tags:
        - "NFT"
      summary: "Rarible stats"
      operationId: "getRarible"
      x-price: "$0.01"
      responses:
        "200":
          description: "Rarible"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTMarketplaceResponse"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/nft/rarity/{contract}/{tokenId}:
    get:
      tags:
        - "NFT"
      summary: "NFT rarity score"
      operationId: "getapiNftRarity"
      x-price: "$0.02"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Contract address"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
        - name: "tokenId"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Token symbol or address"
          example: "1"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/trending:
    get:
      tags:
        - "NFT"
      summary: "Trending NFT collections"
      operationId: "getapiNftTrending"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTTrendingResponse"
              example:
                collections:
                  - address: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                    name: "Bored Ape Yacht Club"
                    floorPrice:
                      eth: 25.5
                      usd: 82743.75
                    volume24h: 234567.89
                    change24h: 12.34
                  - address: "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB"
                    name: "CryptoPunks"
                    floorPrice:
                      eth: 45.6
                      usd: 148001.52
                    volume24h: 345678.9
                    change24h: 8.9
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/nft/volume:
    get:
      tags:
        - "NFT"
      summary: "NFT market volume"
      operationId: "getapiNftVolume"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTVolumeResponse"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/x2y2:
    get:
      tags:
        - "NFT"
      summary: "X2Y2 stats"
      operationId: "getX2Y2"
      x-price: "$0.01"
      responses:
        "200":
          description: "X2Y2"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTMarketplaceResponse"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain (ethereum, polygon, base)"
          example: "ethereum"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/nft/{chain}/{contract}/{tokenId}:
    get:
      tags:
        - "NFT"
      summary: "NFT metadata"
      operationId: "getapiNft"
      x-price: "$0.02"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Chain name (ethereum, base, etc.)"
          example: "ethereum"
        - name: "contract"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Contract address"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
        - name: "tokenId"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Token symbol or address"
          example: "1"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nfts/{address}:
    get:
      tags:
        - "Wallet"
      summary: "NFT holdings summary"
      operationId: "getapiNfts"
      x-price: "$0.03"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                nfts:
                  - contractAddress: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                    tokenId: "1234"
                    name: "Bored Ape #1234"
                    collection: "Bored Ape Yacht Club"
                    image: "ipfs://QmExample1234"
                    attributes:
                      - trait_type: "Background"
                        value: "Blue"
                      - trait_type: "Fur"
                        value: "Brown"
                    lastSale:
                      price: 28.5
                      date: "2026-01-15T10:30:00.000Z"
                count: 1
                totalValueUSD: 92573.93
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/nonce/{address}:
    get:
      tags:
        - "Wallet"
      summary: "Address transaction count"
      operationId: "getapiNonce"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented. Status: Planned feature. This route will return 404 in production.\n\nAddress transaction count"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/options/chain/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "Options by chain"
      operationId: "getOptionsByChain"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Options"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/options/deribit:
    get:
      tags:
        - "Protocol"
      summary: "Deribit options data"
      operationId: "getapiOptionsDeribit"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/options/dopex:
    get:
      tags:
        - "DeFi"
      summary: "Dopex options"
      operationId: "getDopexOptions"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/options/hegic:
    get:
      tags:
        - "DeFi"
      summary: "Hegic options"
      operationId: "getHegicOptions"
      x-price: "$0.01"
      responses:
        "200":
          description: "Hegic"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Hegic"
                volume24h: 20
                volume7d: 28163
                chains:
                  - "Arbitrum"
                source: "defillama"
                timestamp: "2026-02-18T13:18:14.506Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/options/lyra:
    get:
      tags:
        - "DeFi"
      summary: "Lyra options"
      operationId: "getLyra"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/options/notional:
    get:
      tags:
        - "DeFi"
      summary: "Options notional"
      operationId: "getOptionsNotional"
      x-price: "$0.01"
      responses:
        "200":
          description: "Notional"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocols:
                  - total24h: 20
                    total48hto24h: 0
                    total7d: 28163
                    total14dto7d: 51921
                    total60dto30d: 107184
                    total30d: 206894
                    total1y: 1474845
                    totalAllTime: 10845254
                    average1y: 4051.771978021978
                    monthlyAverage1y: 123335.93901098902
                    change_7d: -99.64
                    change_1m: 81.82
                    change_7dover7d: -45.76
                    change_30dover30d: 93.03
                    breakdown24h:
                      arbitrum:
                        Hegic: 20
                    breakdown30d:
                      arbitrum:
                        Hegic: 206894
                    total7DaysAgo: 5547
                    total30DaysAgo: 11
                    defillamaId: "128"
                    name: "Hegic"
                    displayName: "Hegic"
                    module: "hegic"
                    category: "Options"
                    logo: "https://icons.llamao.fi/icons/protocols/hegic.jpg"
                    chains:
                      - "Arbitrum"
                    protocolType: "protocol"
                    methodologyURL: "https://github.com/DefiLlama/dimension-adapters/blob/master/options/hegic"
                    methodology:
                      UserFees: "Fees paid by users"
                      Fees: "Fees paid by users"
                      Revenue: "Treasury and token holders revenue"
                      ProtocolRevenue: "Fees going to treasury"
                      HoldersRevenue: "Fees going to governance token holders"
                      SupplySideRevenue: "LPs revenue"
                    slug: "hegic"
                    id: "128"
                source: "defillama"
                timestamp: "2026-02-18T13:33:44.254Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/options/opyn:
    get:
      tags:
        - "DeFi"
      summary: "Opyn options"
      operationId: "getOpynOptions"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/options/premia:
    get:
      tags:
        - "DeFi"
      summary: "Premia options"
      operationId: "getPremiaOptions"
      x-price: "$0.01"
      responses:
        "200":
          description: "Premia"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Premia"
                volume24h: null
                chains:
                  - "Ethereum"
                  - "Arbitrum"
                  - "Fantom"
                  - "OP Mainnet"
                source: "defillama"
                timestamp: "2026-02-18T13:33:44.885Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/options/ribbon:
    get:
      tags:
        - "DeFi"
      summary: "Ribbon options"
      operationId: "getRibbonOptions"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/options/volume:
    get:
      tags:
        - "Protocol"
      summary: "Options DEX volumes"
      operationId: "getapiOptionsVolume"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/oracles:
    get:
      tags:
        - "Utilities"
      summary: "Oracle TVS ranking"
      operationId: "getapiOracles"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/aevo:
    get:
      tags:
        - "DeFi"
      summary: "Aevo perps"
      operationId: "getAevoPerps"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Aevo"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/apex:
    get:
      tags:
        - "DeFi"
      summary: "ApeX perps"
      operationId: "getApexPerps"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "ApeX"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/bluefin:
    get:
      tags:
        - "DeFi"
      summary: "Bluefin perps"
      operationId: "getBluefinPerps"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Bluefin"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/cap:
    get:
      tags:
        - "DeFi"
      summary: "Cap perps"
      operationId: "getCapPerps"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Cap"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/chain/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "Perps by chain"
      operationId: "getPerpsByChain"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Perps"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/compare/top:
    get:
      tags:
        - "DeFi"
      summary: "Top perps comparison"
      operationId: "getTopPerps"
      x-price: "$0.01"
      responses:
        "200":
          description: "Comparison"
          content:
            application/json:
              schema:
                type: "object"
              example:
                ranking:
                  - rank: 1
                    name: "Hyperliquid Perps"
                    volume24h: 5424109051
                    volume7d: 34844052998
                    change24h: 54.14
                    dominance: "25.27%"
                    chains:
                      - "Hyperliquid L1"
                  - rank: 2
                    name: "Lighter Perps"
                    volume24h: 2447676250
                    volume7d: 14489312789
                    change24h: 7.09
                    dominance: "11.40%"
                    chains:
                      - "zkLighter"
                  - rank: 3
                    name: "Aster Perps"
                    volume24h: 2409337556
                    volume7d: 18404293161
                    change24h: 2.81
                    dominance: "11.22%"
                    chains:
                      - "Off Chain"
                totalVolume24h: 21464488907
                source: "defillama"
                timestamp: "2026-02-18T13:50:47.704Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/drift:
    get:
      tags:
        - "DeFi"
      summary: "Drift perps"
      operationId: "getDriftPerps"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Drift"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/dydx:
    get:
      tags:
        - "DeFi"
      summary: "dYdX perps"
      operationId: "getDydxPerps"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "dYdX"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/funding:
    get:
      tags:
        - "Protocol"
      summary: "Perp funding rates"
      operationId: "getapiPerpsFunding"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/gains:
    get:
      tags:
        - "DeFi"
      summary: "Gains Network perps"
      operationId: "getGainsPerps"
      x-price: "$0.01"
      responses:
        "200":
          description: "Gains"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/gmx:
    get:
      tags:
        - "DeFi"
      summary: "GMX perps"
      operationId: "getGmxPerps"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/hyperliquid:
    get:
      tags:
        - "DeFi"
      summary: "Hyperliquid perps"
      operationId: "getHyperliquidPerps"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Hyperliquid"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/kwenta:
    get:
      tags:
        - "DeFi"
      summary: "Kwenta perps"
      operationId: "getKwentaPerps"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Kwenta"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/level:
    get:
      tags:
        - "DeFi"
      summary: "Level perps"
      operationId: "getLevelPerps"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Level"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/list:
    get:
      tags:
        - "DeFi"
      summary: "Perps protocols list"
      operationId: "getPerpsList"
      x-price: "$0.01"
      responses:
        "200":
          description: "Protocols"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/mux:
    get:
      tags:
        - "DeFi"
      summary: "MUX perps"
      operationId: "getMuxPerps"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "MUX"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/oi:
    get:
      tags:
        - "Protocol"
      summary: "Perp open interest"
      operationId: "getapiPerpsOi"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/rage-trade:
    get:
      tags:
        - "DeFi"
      summary: "Rage Trade perps"
      operationId: "getRageTradePerps"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Rage Trade"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/vertex:
    get:
      tags:
        - "DeFi"
      summary: "Vertex perps"
      operationId: "getVertexPerps"
      x-price: "$0.01"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Vertex"
          content:
            application/json:
              schema:
                type: "object"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/volume:
    get:
      tags:
        - "Protocol"
      summary: "Perpetuals DEX volumes"
      operationId: "getapiPerpsVolume"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/perps/{protocol}:
    get:
      tags:
        - "DeFi"
      summary: "Perps protocol data"
      operationId: "getPerpsProtocol"
      x-price: "$0.01"
      parameters:
        - name: "protocol"
          in: "path"
          required: true
          description: "DeFi protocol identifier"
          schema:
            type: "string"
          example: "aave"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented. Status: Planned feature. This route will return 404 in production.\n\nPerps protocol data"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/poaps/{address}:
    get:
      tags:
        - "Social"
      summary: "POAP badges collection"
      operationId: "getapiPoaps"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented. Status: Planned feature. This route will return 404 in production.\n\nPOAP badges collection"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/portfolio/{address}:
    get:
      tags:
        - "ENS"
      summary: "ENS portfolio analysis with valuation"
      operationId: "getapiPortfolio"
      x-price: "$0.05"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                totalValueUSD: 30428.92
                breakdown:
                  eth: 16987.45
                  tokens: 6234.57
                  nfts: 7206.9
                chains:
                  ethereum:
                    valueUSD: 24194.35
                    nativeBalance: 5.23
                  polygon:
                    valueUSD: 4002.34
                    nativeBalance: 1234.56
                  arbitrum:
                    valueUSD: 2232.23
                    nativeBalance: 0.98
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/price/1inch:
    get:
      tags:
        - "Prices"
      summary: "1inch price"
      operationId: "getapiPrice1inch"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/aave:
    get:
      tags:
        - "Prices"
      summary: "Aave price"
      operationId: "getapiPriceAave"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/ai:
    get:
      tags:
        - "Prices"
      summary: "AI token prices"
      operationId: "getAiPrices"
      x-price: "$0.01"
      responses:
        "200":
          description: "AI prices"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Price"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/price/arb:
    get:
      tags:
        - "Prices"
      summary: "Arbitrum price"
      operationId: "getapiPriceArb"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/avax:
    get:
      tags:
        - "Prices"
      summary: "Avalanche price"
      operationId: "getapiPriceAvax"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/bal:
    get:
      tags:
        - "Prices"
      summary: "Balancer price"
      operationId: "getapiPriceBal"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/bnb:
    get:
      tags:
        - "Prices"
      summary: "BNB price"
      operationId: "getapiPriceBnb"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/btc:
    get:
      tags:
        - "Prices"
      summary: "Bitcoin price"
      operationId: "getapiPriceBtc"
      x-price: "$0.01"
      responses:
        "200":
          description: "Current BTC price"
          content:
            application/json:
              example:
                symbol: "BTC"
                price: 97542.18
                change24h: 2.45
                marketCap: 1920000000000
                source: "coingecko"
              schema:
                $ref: "#/components/schemas/PriceResponse"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/btc/24h:
    get:
      tags:
        - "Prices"
      summary: "BTC 24h stats"
      operationId: "getBtc24hStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "24h stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Price"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/price/comp:
    get:
      tags:
        - "Prices"
      summary: "Compound price"
      operationId: "getapiPriceComp"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/crv:
    get:
      tags:
        - "Prices"
      summary: "Curve price"
      operationId: "getapiPriceCrv"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/defi:
    get:
      tags:
        - "Prices"
      summary: "DeFi token prices"
      operationId: "getDefiPrices"
      x-price: "$0.01"
      responses:
        "200":
          description: "DeFi prices"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Price"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/price/doge:
    get:
      tags:
        - "Prices"
      summary: "Dogecoin price"
      operationId: "getapiPriceDoge"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/ens:
    get:
      tags:
        - "Prices"
      summary: "ENS token price"
      operationId: "getapiPriceEns"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/eth:
    get:
      tags:
        - "Prices"
      summary: "Ethereum price"
      operationId: "getapiPriceEth"
      x-price: "$0.01"
      responses:
        "200":
          description: "Current ETH price"
          content:
            application/json:
              example:
                symbol: "ETH"
                price: 2847.32
                change24h: 2.45
                marketCap: 342000000000
                source: "coingecko"
              schema:
                $ref: "#/components/schemas/PriceResponse"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/eth/24h:
    get:
      tags:
        - "Prices"
      summary: "ETH 24h stats"
      operationId: "getEth24hStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "24h stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Price"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/price/eth/multichain:
    get:
      tags:
        - "Prices"
      summary: "ETH multi-chain prices"
      operationId: "getEthMultichain"
      x-price: "$0.01"
      responses:
        "200":
          description: "Multi-chain ETH"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Price"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/price/historical/{token}:
    get:
      tags:
        - "Prices"
      summary: "Historical price at date"
      operationId: "getHistoricalPrice"
      x-price: "$0.01"
      parameters:
        - name: "token"
          in: "path"
          required: true
          description: "Token contract address or symbol"
          schema:
            type: "string"
          example: "ethereum"
        - name: "date"
          in: "query"
          required: true
          description: "Date in YYYY-MM-DD format"
          schema:
            type: "string"
          example: "example"
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      responses:
        "200":
          description: "Price"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Price"
              example:
                symbol: "ETH"
                prices:
                  - timestamp: 1707350400
                    price: 3200.45
                    volume24h: 15200000000
                  - timestamp: 1707264000
                    price: 3178.92
                    volume24h: 14800000000
                  - timestamp: 1707177600
                    price: 3156.33
                    volume24h: 15400000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current price for a token (9-source fallback)"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/price/history/{token}:
    get:
      tags:
        - "Prices"
      summary: "Token price history"
      operationId: "getapiPriceHistory"
      x-price: "$0.02"
      parameters:
        - name: "token"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Token symbol or address"
          example: "ethereum"
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current price for a token (9-source fallback)"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/price/l2:
    get:
      tags:
        - "Prices"
      summary: "L2 token prices"
      operationId: "getL2Prices"
      x-price: "$0.01"
      responses:
        "200":
          description: "L2 prices"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Price"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/price/ldo:
    get:
      tags:
        - "Prices"
      summary: "Lido price"
      operationId: "getapiPriceLdo"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/link:
    get:
      tags:
        - "Prices"
      summary: "Chainlink price"
      operationId: "getapiPriceLink"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/major:
    get:
      tags:
        - "Prices"
      summary: "Major crypto prices"
      operationId: "getMajorPrices"
      x-price: "$0.01"
      responses:
        "200":
          description: "Major prices"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Price"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/price/matic:
    get:
      tags:
        - "Prices"
      summary: "Polygon price"
      operationId: "getapiPriceMatic"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/meme:
    get:
      tags:
        - "Prices"
      summary: "Meme token prices"
      operationId: "getMemePrices"
      x-price: "$0.01"
      responses:
        "200":
          description: "Meme prices"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Price"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/price/mkr:
    get:
      tags:
        - "Prices"
      summary: "Maker price"
      operationId: "getapiPriceMkr"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/multi/{symbols}:
    get:
      tags:
        - "Prices"
      summary: "Multiple token prices"
      operationId: "getMultiPrices"
      x-price: "$0.02"
      parameters:
        - name: "symbols"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Comma-separated symbols"
          example: "ETH"
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      responses:
        "200":
          description: "Prices"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Price"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current price for a token (9-source fallback)"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/price/op:
    get:
      tags:
        - "Prices"
      summary: "Optimism price"
      operationId: "getapiPriceOp"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/pepe:
    get:
      tags:
        - "Prices"
      summary: "Pepe price"
      operationId: "getapiPricePepe"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/shib:
    get:
      tags:
        - "Prices"
      summary: "Shiba Inu price"
      operationId: "getapiPriceShib"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/snx:
    get:
      tags:
        - "Prices"
      summary: "Synthetix price"
      operationId: "getapiPriceSnx"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/sol:
    get:
      tags:
        - "Prices"
      summary: "Solana price"
      operationId: "getapiPriceSol"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/sushi:
    get:
      tags:
        - "Prices"
      summary: "Sushi price"
      operationId: "getapiPriceSushi"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/uni:
    get:
      tags:
        - "Prices"
      summary: "Uniswap price"
      operationId: "getapiPriceUni"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/usdc/multichain:
    get:
      tags:
        - "Prices"
      summary: "USDC multi-chain prices"
      operationId: "getUsdcMultichain"
      x-price: "$0.01"
      responses:
        "200":
          description: "Multi-chain USDC"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Price"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/price/wif:
    get:
      tags:
        - "Prices"
      summary: "dogwifhat price"
      operationId: "getapiPriceWif"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/yfi:
    get:
      tags:
        - "Prices"
      summary: "Yearn price"
      operationId: "getapiPriceYfi"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPrice"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      parameters:
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/price/{token}:
    get:
      tags:
        - "Prices"
        - "DeFi"
      summary: "Get Token Price"
      operationId: "getTokenPrice"
      x-price: "$0.01"
      description: "Get real-time price for any supported token with 9-source fallback for reliability.\n\n### Supported Tokens\nETH, BTC, USDC, USDT, DAI, LINK, UNI, AAVE, ARB, OP, MATIC, SOL, and 100+ more\n\n### Data Sources (fallback order)\n1. CoinGecko → 2. DefiLlama → 3. CoinCap → 4. Binance → 5+ more\n\n### Pricing\n- **$0.001** per request"
      parameters:
        - name: "token"
          in: "path"
          required: true
          description: "Token symbol (case-insensitive)"
          schema:
            type: "string"
            example: "eth"
          example: "ethereum"
        - name: "currency"
          in: "query"
          schema:
            type: "string"
            default: "usd"
          description: "Target currency (usd, eur, btc)"
          example: "usd"
      responses:
        "200":
          description: "Price data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Price"
                example:
                  symbol: "ETH"
                  price: 2847.32
                  change24h: 2.47
                  marketCap: 342156789012
                  volume24h: 18567234890
                  lastUpdated: "2026-02-12T21:30:00Z"
              examples:
                ethereum:
                  summary: "Ethereum price"
                  value:
                    token: "ethereum"
                    symbol: "ETH"
                    price: 2847.32
                    currency: "usd"
                    marketCap: 342456789012
                    volume24h: 28934567890
                    change24h: 2.45
                    lastUpdated: "2026-02-12T21:10:00Z"
                bitcoin:
                  summary: "Bitcoin price"
                  value:
                    token: "bitcoin"
                    symbol: "BTC"
                    price: 48234.56
                    currency: "usd"
                    marketCap: 945678901234
                    volume24h: 34567890123
                    change24h: -1.23
                    lastUpdated: "2026-02-12T21:10:00Z"
        "400":
          description: "Bad Request - Invalid parameters or malformed request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Invalid parameter format"
                code: "INVALID_PARAMETER"
        "402":
          description: "Payment Required - Free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Resource not found"
                code: "NOT_FOUND"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/prices:
    get:
      tags:
        - "Prices"
      summary: "Batch token prices"
      description: "**DEPRECATED** - Use /api/price/batch instead. This endpoint is not implemented."
      operationId: "getapiPrices"
      deprecated: true
      x-price: "$0.02"
      responses: {}
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/prices/batch:
    get:
      tags:
        - "Prices"
      summary: "Batch token prices"
      description: "**DEPRECATED** - Use /api/price/batch instead. This endpoint is not implemented."
      operationId: "getapiPricesBatch"
      deprecated: true
      x-price: "$0.01"
      responses: {}
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/profile/{name}:
    get:
      tags:
        - "ENS"
      summary: "Full identity profile with ENS records, socials, avatar"
      operationId: "getapiProfile"
      x-price: "$0.05"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
                example:
                  address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                  ensName: "vitalik.eth"
                  avatar: "https://metadata.ens.domains/mainnet/avatar/vitalik.eth"
                  farcaster:
                    fid: 5650
                    username: "vitalik.eth"
                    displayName: "Vitalik Buterin"
                    pfp: "https://i.imgur.com/gF9Yaeg.jpg"
                    bio: "Ethereum"
                  lens: null
              examples:
                complete:
                  summary: "Complete profile with ENS, Farcaster, and Lens data"
                  value:
                    address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                    name: "vitalik.eth"
                    avatar: "https://i.imgur.com/gF9Yaeg.jpg"
                    addresses:
                      eth: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                      btc: "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
                    records:
                      url: "https://vitalik.ca"
                      description: "Ethereum co-founder"
                      com.twitter: "VitalikButerin"
                      com.github: "vbuterin"
                    social:
                      farcaster:
                        fid: 5650
                        username: "vitalik"
                        displayName: "Vitalik Buterin"
                        pfp: "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/471b3f42-fb38-44ef-0511-bcb7f7596e00/original"
                      lens:
                        handle: "vitalik.lens"
                        profileId: "0x02"
                minimal:
                  summary: "Minimal profile (name + address only)"
                  value:
                    address: "0x983110309620D911731Ac0932219af06091b6744"
                    name: "garypalmerjr.eth"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/protocol/balancer:
    get:
      tags:
        - "Protocol"
      summary: "Balancer stats"
      operationId: "getapiProtocolBalancer"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/convex:
    get:
      tags:
        - "Protocol"
      summary: "Convex stats"
      operationId: "getapiProtocolConvex"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/eigenlayer:
    get:
      tags:
        - "Protocol"
      summary: "EigenLayer stats"
      operationId: "getapiProtocolEigenlayer"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/frax:
    get:
      tags:
        - "Protocol"
      summary: "Frax stats"
      operationId: "getapiProtocolFrax"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/gmx:
    get:
      tags:
        - "Protocol"
      summary: "GMX stats"
      operationId: "getapiProtocolGmx"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/hyperliquid:
    get:
      tags:
        - "Protocol"
      summary: "Hyperliquid stats"
      operationId: "getapiProtocolHyperliquid"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/instadapp:
    get:
      tags:
        - "Protocol"
      summary: "Instadapp stats"
      operationId: "getapiProtocolInstadapp"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/lido:
    get:
      tags:
        - "Protocol"
      summary: "Lido stats"
      operationId: "getapiProtocolLido"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/morpho:
    get:
      tags:
        - "Protocol"
      summary: "Morpho stats"
      operationId: "getapiProtocolMorpho"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/pendle:
    get:
      tags:
        - "Protocol"
      summary: "Pendle stats"
      operationId: "getapiProtocolPendle"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/rocketpool:
    get:
      tags:
        - "Protocol"
      summary: "Rocket Pool stats"
      operationId: "getapiProtocolRocketpool"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/synthetix:
    get:
      tags:
        - "Protocol"
      summary: "Synthetix stats"
      operationId: "getapiProtocolSynthetix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/yearn:
    get:
      tags:
        - "Protocol"
      summary: "Yearn stats"
      operationId: "getapiProtocolYearn"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/1inch:
    get:
      tags:
        - "Protocol"
      summary: "1inch Network"
      operationId: "get1inch"
      x-price: "$0.01"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/aave:
    get:
      tags:
        - "Protocol"
      summary: "Aave V3"
      operationId: "getAaveProtocol"
      x-price: "$0.01"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/balancer:
    get:
      tags:
        - "Protocol"
      summary: "Balancer stats"
      operationId: "getBalancer"
      x-price: "$0.01"
      responses:
        "200":
          description: "Balancer"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/blur:
    get:
      tags:
        - "Protocol"
      summary: "Blur stats"
      operationId: "getBlur"
      x-price: "$0.01"
      responses:
        "200":
          description: "Blur"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/blur/stats:
    get:
      tags:
        - "Protocol"
      summary: "Blur stats"
      operationId: "getBlurStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/categories:
    get:
      tags:
        - "Protocol"
      summary: "All categories"
      operationId: "getProtocolCategories"
      x-price: "$0.01"
      responses:
        "200":
          description: "Categories"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolCategories"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/category/bridges:
    get:
      tags:
        - "Protocol"
      summary: "Bridge protocols"
      operationId: "getBridgeProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "Bridges"
          content:
            application/json:
              schema:
                type: "array"
                items:
                  $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/category/derivatives:
    get:
      tags:
        - "Protocol"
      summary: "Derivatives protocols"
      operationId: "getDerivativesProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "Derivatives"
          content:
            application/json:
              schema:
                type: "array"
                items:
                  $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/category/dex:
    get:
      tags:
        - "Protocol"
      summary: "DEX protocols"
      operationId: "getDexProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "DEXes"
          content:
            application/json:
              schema:
                type: "array"
                items:
                  $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/category/lending:
    get:
      tags:
        - "Protocol"
      summary: "Lending protocols"
      operationId: "getLendingProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "Lending"
          content:
            application/json:
              schema:
                type: "array"
                items:
                  $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/category/staking:
    get:
      tags:
        - "Protocol"
      summary: "Staking protocols"
      operationId: "getStakingProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "Staking"
          content:
            application/json:
              schema:
                type: "array"
                items:
                  $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/chain/arbitrum:
    get:
      tags:
        - "Protocol"
      summary: "Arbitrum protocols"
      operationId: "getArbitrumProtocols"
      x-price: "$0.02"
      responses:
        "200":
          description: "Protocols"
          content:
            application/json:
              schema:
                type: "array"
                items:
                  $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/chain/avalanche:
    get:
      tags:
        - "Protocol"
      summary: "Avalanche protocols"
      operationId: "getAvalancheProtocols"
      x-price: "$0.02"
      responses:
        "200":
          description: "Protocols"
          content:
            application/json:
              schema:
                type: "array"
                items:
                  $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/chain/base:
    get:
      tags:
        - "Protocol"
      summary: "Base protocols"
      operationId: "getBaseProtocols"
      x-price: "$0.02"
      responses:
        "200":
          description: "Protocols"
          content:
            application/json:
              schema:
                type: "array"
                items:
                  $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/chain/bsc:
    get:
      tags:
        - "Protocol"
      summary: "BSC protocols"
      operationId: "getBscProtocols"
      x-price: "$0.02"
      responses:
        "200":
          description: "Protocols"
          content:
            application/json:
              schema:
                type: "array"
                items:
                  $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/chain/ethereum:
    get:
      tags:
        - "Protocol"
      summary: "Ethereum protocols"
      operationId: "getEthereumProtocols"
      x-price: "$0.02"
      responses:
        "200":
          description: "Protocols"
          content:
            application/json:
              schema:
                type: "array"
                items:
                  $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/chain/optimism:
    get:
      tags:
        - "Protocol"
      summary: "Optimism protocols"
      operationId: "getOptimismProtocols"
      x-price: "$0.02"
      responses:
        "200":
          description: "Protocols"
          content:
            application/json:
              schema:
                type: "array"
                items:
                  $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/chain/polygon:
    get:
      tags:
        - "Protocol"
      summary: "Polygon protocols"
      operationId: "getPolygonProtocols"
      x-price: "$0.02"
      responses:
        "200":
          description: "Protocols"
          content:
            application/json:
              schema:
                type: "array"
                items:
                  $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/chain/solana:
    get:
      tags:
        - "Protocol"
      summary: "Solana protocols"
      operationId: "getSolanaProtocols"
      x-price: "$0.02"
      responses:
        "200":
          description: "Protocols"
          content:
            application/json:
              schema:
                type: "array"
                items:
                  $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/compound:
    get:
      tags:
        - "Protocol"
      summary: "Compound V3"
      operationId: "getCompoundProtocol"
      x-price: "$0.01"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/convex:
    get:
      tags:
        - "Protocol"
      summary: "Convex stats"
      operationId: "getConvex"
      x-price: "$0.01"
      responses:
        "200":
          description: "Convex"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/convex/stats:
    get:
      tags:
        - "Protocol"
      summary: "Convex stats"
      operationId: "getConvexStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/curve:
    get:
      tags:
        - "Protocol"
      summary: "Curve Finance"
      operationId: "getCurveProtocol"
      x-price: "$0.01"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/dydx:
    get:
      tags:
        - "Protocol"
      summary: "dYdX stats"
      operationId: "getDYDX"
      x-price: "$0.01"
      responses:
        "200":
          description: "dYdX"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/dydx/stats:
    get:
      tags:
        - "Protocol"
      summary: "dYdX stats"
      operationId: "getDydxStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/eigenlayer:
    get:
      tags:
        - "Protocol"
      summary: "EigenLayer stats"
      operationId: "getEigenLayer"
      x-price: "$0.01"
      responses:
        "200":
          description: "EigenLayer"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/ethena:
    get:
      tags:
        - "Protocol"
      summary: "Ethena stats"
      operationId: "getEthena"
      x-price: "$0.01"
      responses:
        "200":
          description: "Ethena"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/etherfi:
    get:
      tags:
        - "Protocol"
      summary: "Ether.fi stats"
      operationId: "getEtherFi"
      x-price: "$0.01"
      responses:
        "200":
          description: "Ether.fi"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/etherfi/stats:
    get:
      tags:
        - "Protocol"
      summary: "Ether.fi stats"
      operationId: "getEtherFiStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/euler:
    get:
      tags:
        - "Protocol"
      summary: "Euler"
      operationId: "getEuler"
      x-price: "$0.01"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/euler/stats:
    get:
      tags:
        - "Protocol"
      summary: "Euler stats"
      operationId: "getEulerStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/frax:
    get:
      tags:
        - "Protocol"
      summary: "Frax stats"
      operationId: "getFrax"
      x-price: "$0.01"
      responses:
        "200":
          description: "Frax"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/frax/stats:
    get:
      tags:
        - "Protocol"
      summary: "Frax stats"
      operationId: "getFraxStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/gmx:
    get:
      tags:
        - "Protocol"
      summary: "GMX stats"
      operationId: "getGMX"
      x-price: "$0.01"
      responses:
        "200":
          description: "GMX"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/gmx/stats:
    get:
      tags:
        - "Protocol"
      summary: "GMX stats"
      operationId: "getGmxStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/hyperliquid:
    get:
      tags:
        - "Protocol"
      summary: "Hyperliquid stats"
      operationId: "getHyperliquid"
      x-price: "$0.01"
      responses:
        "200":
          description: "Hyperliquid"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/instadapp:
    get:
      tags:
        - "Protocol"
      summary: "Instadapp"
      operationId: "getInstadapp"
      x-price: "$0.01"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/instadapp/stats:
    get:
      tags:
        - "Protocol"
      summary: "Instadapp stats"
      operationId: "getInstadappStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/kelp:
    get:
      tags:
        - "Protocol"
      summary: "Kelp DAO stats"
      operationId: "getKelp"
      x-price: "$0.01"
      responses:
        "200":
          description: "Kelp"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/kelp/stats:
    get:
      tags:
        - "Protocol"
      summary: "Kelp stats"
      operationId: "getKelpStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/layerzero:
    get:
      tags:
        - "Protocol"
      summary: "LayerZero stats"
      operationId: "getLayerZero"
      x-price: "$0.01"
      responses:
        "200":
          description: "LayerZero"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/layerzero/stats:
    get:
      tags:
        - "Protocol"
      summary: "LayerZero stats"
      operationId: "getLayerZeroStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/lido:
    get:
      tags:
        - "Protocol"
      summary: "Lido stats"
      operationId: "getLido"
      x-price: "$0.01"
      responses:
        "200":
          description: "Lido"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/lido/stats:
    get:
      tags:
        - "Protocol"
      summary: "Lido stats"
      operationId: "getLidoStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/liquity:
    get:
      tags:
        - "Protocol"
      summary: "Liquity"
      operationId: "getLiquity"
      x-price: "$0.01"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/liquity/stats:
    get:
      tags:
        - "Protocol"
      summary: "Liquity stats"
      operationId: "getLiquityStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/maker:
    get:
      tags:
        - "Protocol"
      summary: "MakerDAO"
      operationId: "getMaker"
      x-price: "$0.01"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/mantle-lsp:
    get:
      tags:
        - "Protocol"
      summary: "Mantle LSP"
      operationId: "getMantleLsp"
      x-price: "$0.01"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/morpho:
    get:
      tags:
        - "Protocol"
      summary: "Morpho stats"
      operationId: "getMorpho"
      x-price: "$0.01"
      responses:
        "200":
          description: "Morpho"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/opensea:
    get:
      tags:
        - "Protocol"
      summary: "OpenSea"
      operationId: "getOpenSeaProtocol"
      x-price: "$0.01"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/opensea/stats:
    get:
      tags:
        - "Protocol"
      summary: "OpenSea stats"
      operationId: "getOpenSeaStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/pancakeswap:
    get:
      tags:
        - "Protocol"
      summary: "PancakeSwap"
      operationId: "getPancakeSwap"
      x-price: "$0.01"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/paraswap:
    get:
      tags:
        - "Protocol"
      summary: "ParaSwap"
      operationId: "getParaSwap"
      x-price: "$0.01"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/pendle:
    get:
      tags:
        - "Protocol"
      summary: "Pendle stats"
      operationId: "getPendle"
      x-price: "$0.01"
      responses:
        "200":
          description: "Pendle"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/pendle/stats:
    get:
      tags:
        - "Protocol"
      summary: "Pendle stats"
      operationId: "getPendleStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/polymarket:
    get:
      tags:
        - "Protocol"
      summary: "Polymarket stats"
      operationId: "getPolymarket"
      x-price: "$0.01"
      responses:
        "200":
          description: "Polymarket"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/puffer:
    get:
      tags:
        - "Protocol"
      summary: "Puffer stats"
      operationId: "getPuffer"
      x-price: "$0.01"
      responses:
        "200":
          description: "Puffer"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/puffer/stats:
    get:
      tags:
        - "Protocol"
      summary: "Puffer stats"
      operationId: "getPufferStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/rank/{rank}:
    get:
      tags:
        - "Protocol"
      summary: "Protocol by rank"
      operationId: "getProtocolByRank"
      x-price: "$0.01"
      parameters:
        - name: "rank"
          in: "path"
          required: true
          description: "Ranking position or type"
          schema:
            type: "integer"
          example: 10
      responses:
        "200":
          description: "Protocol"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/renzo:
    get:
      tags:
        - "Protocol"
      summary: "Renzo stats"
      operationId: "getRenzo"
      x-price: "$0.01"
      responses:
        "200":
          description: "Renzo"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/renzo/stats:
    get:
      tags:
        - "Protocol"
      summary: "Renzo stats"
      operationId: "getRenzoStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/rocketpool:
    get:
      tags:
        - "Protocol"
      summary: "Rocket Pool stats"
      operationId: "getRocketPool"
      x-price: "$0.01"
      responses:
        "200":
          description: "Rocket Pool"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/rocketpool/stats:
    get:
      tags:
        - "Protocol"
      summary: "Rocket Pool stats"
      operationId: "getRocketPoolStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/search:
    get:
      tags:
        - "Protocol"
      summary: "Search protocols"
      operationId: "searchProtocols"
      x-price: "$0.01"
      parameters:
        - name: "q"
          in: "query"
          required: true
          description: "Search query string"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Results"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stargate:
    get:
      tags:
        - "Protocol"
      summary: "Stargate stats"
      operationId: "getStargate"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stargate"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stargate/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stargate stats"
      operationId: "getStargateStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/aave:
    get:
      tags:
        - "Protocol"
      summary: "Aave detailed stats"
      operationId: "getAaveStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/balancer:
    get:
      tags:
        - "Protocol"
      summary: "Balancer detailed stats"
      operationId: "getBalancerStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/benqi:
    get:
      tags:
        - "Protocol"
      summary: "BENQI detailed stats"
      operationId: "getBenqiStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/compound:
    get:
      tags:
        - "Protocol"
      summary: "Compound detailed stats"
      operationId: "getCompoundStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/convex:
    get:
      tags:
        - "Protocol"
      summary: "Convex detailed stats"
      operationId: "getConvexStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/curve:
    get:
      tags:
        - "Protocol"
      summary: "Curve detailed stats"
      operationId: "getCurveStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/dydx:
    get:
      tags:
        - "Protocol"
      summary: "dYdX detailed stats"
      operationId: "getDydxStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/eigenlayer:
    get:
      tags:
        - "Protocol"
      summary: "EigenLayer detailed stats"
      operationId: "getEigenLayerStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/frax:
    get:
      tags:
        - "Protocol"
      summary: "Frax detailed stats"
      operationId: "getFraxStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/gmx:
    get:
      tags:
        - "Protocol"
      summary: "GMX detailed stats"
      operationId: "getGmxStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/instadapp:
    get:
      tags:
        - "Protocol"
      summary: "Instadapp detailed stats"
      operationId: "getInstadappStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/lido:
    get:
      tags:
        - "Protocol"
      summary: "Lido detailed stats"
      operationId: "getLidoStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/makerdao:
    get:
      tags:
        - "Protocol"
      summary: "MakerDAO detailed stats"
      operationId: "getMakerDaoStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/morpho:
    get:
      tags:
        - "Protocol"
      summary: "Morpho detailed stats"
      operationId: "getMorphoStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/pancakeswap:
    get:
      tags:
        - "Protocol"
      summary: "PancakeSwap detailed stats"
      operationId: "getPancakeswapStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/pendle:
    get:
      tags:
        - "Protocol"
      summary: "Pendle detailed stats"
      operationId: "getPendleStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/rocket-pool:
    get:
      tags:
        - "Protocol"
      summary: "Rocket Pool detailed stats"
      operationId: "getRocketPoolStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/sushiswap:
    get:
      tags:
        - "Protocol"
      summary: "SushiSwap detailed stats"
      operationId: "getSushiswapStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/trader-joe:
    get:
      tags:
        - "Protocol"
      summary: "Trader Joe detailed stats"
      operationId: "getTraderJoeStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/uniswap:
    get:
      tags:
        - "Protocol"
      summary: "Uniswap detailed stats"
      operationId: "getUniswapStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/venus:
    get:
      tags:
        - "Protocol"
      summary: "Venus detailed stats"
      operationId: "getVenusStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/stats/yearn:
    get:
      tags:
        - "Protocol"
      summary: "Yearn detailed stats"
      operationId: "getYearnStats"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/sushiswap:
    get:
      tags:
        - "Protocol"
      summary: "SushiSwap"
      operationId: "getSushiSwap"
      x-price: "$0.01"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/swell:
    get:
      tags:
        - "Protocol"
      summary: "Swell stats"
      operationId: "getSwell"
      x-price: "$0.01"
      responses:
        "200":
          description: "Swell"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/swell/stats:
    get:
      tags:
        - "Protocol"
      summary: "Swell stats"
      operationId: "getSwellStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/synthetix:
    get:
      tags:
        - "Protocol"
      summary: "Synthetix"
      operationId: "getSynthetix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/wormhole:
    get:
      tags:
        - "Protocol"
      summary: "Wormhole stats"
      operationId: "getWormhole"
      x-price: "$0.01"
      responses:
        "200":
          description: "Wormhole"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/wormhole/stats:
    get:
      tags:
        - "Protocol"
      summary: "Wormhole stats"
      operationId: "getWormholeStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/yearn:
    get:
      tags:
        - "Protocol"
      summary: "Yearn stats"
      operationId: "getYearn"
      x-price: "$0.01"
      responses:
        "200":
          description: "Yearn"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/yearn/stats:
    get:
      tags:
        - "Protocol"
      summary: "Yearn stats"
      operationId: "getYearnStatsSuffix"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolStats"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/{slug}:
    get:
      tags:
        - "Protocol"
      summary: "Protocol details"
      operationId: "getProtocol"
      x-price: "$0.01"
      parameters:
        - name: "slug"
          in: "path"
          required: true
          description: "URL-friendly identifier"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Protocol data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/{slug}/chains:
    get:
      tags:
        - "Protocol"
      summary: "Protocol chains"
      operationId: "getProtocolChains"
      x-price: "$0.01"
      parameters:
        - name: "slug"
          in: "path"
          required: true
          description: "URL-friendly identifier"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Chains"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nList supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/{slug}/fees:
    get:
      tags:
        - "Protocol"
      summary: "Protocol fees"
      operationId: "getProtocolsProtocolFees"
      x-price: "$0.01"
      parameters:
        - name: "slug"
          in: "path"
          required: true
          description: "URL-friendly identifier"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Fees"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/{slug}/revenue:
    get:
      tags:
        - "Protocol"
      summary: "Protocol revenue"
      operationId: "getProtocolsProtocolRevenue"
      x-price: "$0.01"
      parameters:
        - name: "slug"
          in: "path"
          required: true
          description: "URL-friendly identifier"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Revenue"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Protocol"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocols/{slug}/tvl:
    get:
      tags:
        - "Protocol"
      summary: "Protocol TVL history"
      operationId: "getProtocolTvlHistory"
      x-price: "$0.01"
      parameters:
        - name: "slug"
          in: "path"
          required: true
          description: "URL-friendly identifier"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "TVL history"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/raises:
    get:
      tags:
        - "Utilities"
      summary: "Recent funding raises"
      operationId: "getapiRaises"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/reputation/{name}:
    get:
      tags:
        - "Social"
      summary: "Social reputation score"
      operationId: "getapiReputation"
      x-price: "$0.03"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented. Status: Planned feature. This route will return 404 in production.\n\nSocial reputation score"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/revenue:
    get:
      tags:
        - "DeFi"
      summary: "Revenue overview"
      operationId: "getRevenue"
      x-price: "$0.01"
      responses:
        "200":
          description: "Revenue"
          content:
            application/json:
              schema:
                type: "object"
              example:
                totalRevenue24h: 33623994
                totalRevenue7d: 242766159
                protocols:
                  - name: "WBTC"
                    revenue24h: 0
                  - name: "Curve DEX"
                    revenue24h: 8876
                    change24h: 34.69
                  - name: "Aave V2"
                    revenue24h: 5477
                    change24h: -3.71
                  - name: "Yearn Finance"
                    revenue24h: 935
                    change24h: -8.51
                  - name: "Compound V2"
                    revenue24h: 1276
                    change24h: -28.91
                source: "defillama"
                timestamp: "2026-02-18T14:22:46.362Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/revenue/ethereum:
    get:
      tags:
        - "DeFi"
      summary: "Ethereum revenue"
      operationId: "getEthereumRevenue"
      x-price: "$0.01"
      responses:
        "200":
          description: "Revenue"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "ethereum"
                totalRevenue24h: 1959165
                protocols:
                  - name: "WBTC"
                    revenue24h: 0
                  - name: "Curve DEX"
                    revenue24h: 8444
                  - name: "Aave V2"
                    revenue24h: 3048
                  - name: "Yearn Finance"
                    revenue24h: 929
                  - name: "Compound V2"
                    revenue24h: 1276
                source: "defillama"
                timestamp: "2026-02-18T14:35:15.225Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/revenue/protocol/{name}:
    get:
      tags:
        - "DeFi"
      summary: "Protocol revenue"
      operationId: "getRevenueProtocol"
      x-price: "$0.01"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name (e.g., vitalik.eth)"
          schema:
            type: "string"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Revenue"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/revenue/top:
    get:
      tags:
        - "DeFi"
      summary: "Top revenue generators"
      operationId: "getTopRevenue"
      x-price: "$0.01"
      responses:
        "200":
          description: "Top revenue"
          content:
            application/json:
              schema:
                type: "object"
              example:
                topRevenueGenerators:
                  - name: "Tether"
                    revenue24h: 16330647
                    revenue7d: 114419600
                    change24h: -0.05
                  - name: "Circle"
                    revenue24h: 6358821
                    revenue7d: 44462592
                    change24h: -0.22
                  - name: "Hyperliquid Perps"
                    revenue24h: 1530265
                    revenue7d: 10448444
                    change24h: 32.11
                  - name: "pump.fun"
                    revenue24h: 1088564
                    revenue7d: 6256495
                    change24h: 18.32
                  - name: "Tron"
                    revenue24h: 784369
                    revenue7d: 5926531
                    change24h: -8.92
                source: "defillama"
                timestamp: "2026-02-18T14:35:15.600Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/revenue/{protocol}:
    get:
      tags:
        - "DeFi"
      summary: "Protocol revenue"
      operationId: "getapiRevenue"
      x-price: "$0.01"
      parameters:
        - name: "protocol"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Protocol slug"
          example: "aave"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented. Status: Planned feature. This route will return 404 in production.\n\nProtocol revenue"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/reverse/{address}:
    get:
      tags:
        - "ENS"
      summary: "Reverse resolve address to ENS name"
      operationId: "getapiReverse"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                name: "vitalik.eth"
                avatar: "https://metadata.ens.domains/mainnet/avatar/vitalik.eth"
                source: "ensideas"
                timestamp: "2026-02-18T14:35:15.725Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/safe/{address}:
    get:
      tags:
        - "Social"
      summary: "Safe/multisig info"
      operationId: "getapiSafe"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented. Status: Planned feature. This route will return 404 in production.\n\nSafe/multisig info"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/search/protocols:
    get:
      tags:
        - "Utilities"
      summary: "Search DeFi protocols"
      operationId: "getapiSearchProtocols"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocols:
                  - name: "Aave"
                    slug: "aave"
                    tvl: 27800000000
                    change24h: 2.5
                    chains:
                      - "ethereum"
                      - "polygon"
                      - "arbitrum"
                  - name: "Uniswap"
                    slug: "uniswap"
                    tvl: 18900000000
                    change24h: -1.2
                    chains:
                      - "ethereum"
                      - "arbitrum"
                      - "optimism"
                  - name: "Lido"
                    slug: "lido"
                    tvl: 34200000000
                    change24h: 3.1
                    chains:
                      - "ethereum"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/search/tokens:
    get:
      tags:
        - "Utilities"
      summary: "Search tokens"
      operationId: "getapiSearchTokens"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/security/address/{address}:
    get:
      tags:
        - "Security"
      summary: "Address security check"
      operationId: "getapiSecurityAddress"
      x-price: "$0.03"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/security/token/{chain}/{address}:
    get:
      tags:
        - "Security"
      summary: "Token security analysis"
      operationId: "getapiSecurityToken"
      x-price: "$0.03"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Chain name (ethereum, base, etc.)"
          example: "ethereum"
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Token security analysis"
          content:
            application/json:
              example:
                token: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
                name: "USD Coin"
                symbol: "USDC"
                riskScore: 1
                riskLevel: "low"
                flags: []
                verified: true
                holders: 2500000
              schema:
                type: "object"
                properties:
                  address:
                    type: "string"
                  chain:
                    type: "string"
                  risks:
                    type: "array"
                    items:
                      type: "object"
                  score:
                    type: "number"
                  timestamp:
                    type: "string"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/social/farcaster/address/{address}:
    get:
      tags:
        - "Social"
      summary: "Lookup by ETH address"
      operationId: "getFarcasterByAddressSocial"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Profile"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Wallet"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/cast/{hash}:
    get:
      tags:
        - "Social"
      summary: "Cast details"
      operationId: "getFarcasterCast"
      x-price: "$0.01"
      parameters:
        - name: "hash"
          in: "path"
          required: true
          description: "Transaction or cast hash"
          schema:
            type: "string"
          example: "0xabc123def456789012345678901234567890abcd"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Cast data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/cast/{hash}/reactions:
    get:
      tags:
        - "Social"
      summary: "Cast reactions"
      operationId: "getFarcasterCastReactions"
      x-price: "$0.01"
      parameters:
        - name: "hash"
          in: "path"
          required: true
          description: "Transaction or cast hash"
          schema:
            type: "string"
          example: "0xabc123def456789012345678901234567890abcd"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Reactions"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/cast/{hash}/replies:
    get:
      tags:
        - "Social"
      summary: "Cast replies"
      operationId: "getFarcasterCastReplies"
      x-price: "$0.01"
      parameters:
        - name: "hash"
          in: "path"
          required: true
          description: "Transaction or cast hash"
          schema:
            type: "string"
          example: "0xabc123def456789012345678901234567890abcd"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Replies"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/channel/{id}:
    get:
      tags:
        - "Social"
      summary: "Channel details"
      operationId: "getFarcasterChannel"
      x-price: "$0.01"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Unique identifier"
          schema:
            type: "string"
          example: "bitcoin"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Channel data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/channel/{name}/feed:
    get:
      tags:
        - "Social"
      summary: "Channel feed"
      operationId: "getFarcasterChannelFeed"
      x-price: "$0.02"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name (e.g., vitalik.eth)"
          schema:
            type: "string"
          example: "vitalik.eth"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Feed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/channels:
    get:
      tags:
        - "Social"
      summary: "All channels"
      operationId: "getFarcasterChannelsSocial"
      x-price: "$0.02"
      responses:
        "200":
          description: "Channels list"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/feed/{fid}:
    get:
      tags:
        - "Social"
      summary: "User feed"
      operationId: "getFarcasterFeedSocial"
      x-price: "$0.02"
      parameters:
        - name: "fid"
          in: "path"
          required: true
          description: "Farcaster user ID (numeric)"
          schema:
            type: "string"
          example: "3"
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
          description: "Maximum number of results to return"
          example: 10
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Feed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/notifications/{fid}:
    get:
      tags:
        - "Social"
      summary: "User notifications"
      operationId: "getFarcasterNotifications"
      x-price: "$0.02"
      parameters:
        - name: "fid"
          in: "path"
          required: true
          description: "Farcaster user ID (numeric)"
          schema:
            type: "string"
          example: "3"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Notifications"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/power-badge:
    get:
      tags:
        - "Social"
      summary: "Power badge holders"
      operationId: "getFarcasterPowerBadge"
      x-price: "$0.02"
      responses:
        "200":
          description: "Power badge users"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/recent:
    get:
      tags:
        - "Social"
      summary: "Recent popular casts"
      operationId: "getFarcasterRecent"
      x-price: "$0.02"
      responses:
        "200":
          description: "Recent casts"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/search:
    get:
      tags:
        - "Social"
      summary: "Search casts"
      operationId: "searchFarcasterCasts"
      x-price: "$0.02"
      parameters:
        - name: "q"
          in: "query"
          required: true
          description: "Search query string"
          schema:
            type: "string"
          example: "ethereum"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Search results"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/search/users:
    get:
      tags:
        - "Social"
      summary: "Search users"
      operationId: "searchFarcasterUsersSocial"
      x-price: "$0.02"
      parameters:
        - name: "q"
          in: "query"
          required: true
          description: "Search query string"
          schema:
            type: "string"
          example: "ethereum"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Search results"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/stats:
    get:
      tags:
        - "Social"
      summary: "Protocol stats"
      operationId: "getFarcasterStatsSocial"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stats"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/trending/casts:
    get:
      tags:
        - "Social"
      summary: "Trending casts"
      operationId: "getTrendingCasts"
      x-price: "$0.02"
      responses:
        "200":
          description: "Trending casts"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/trending/users:
    get:
      tags:
        - "Social"
      summary: "Trending users"
      operationId: "getTrendingUsers"
      x-price: "$0.02"
      responses:
        "200":
          description: "Trending users"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      parameters:
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/user/{fid}:
    get:
      tags:
        - "Social"
      summary: "User by FID"
      operationId: "getFarcasterUserByFid"
      x-price: "$0.02"
      parameters:
        - name: "fid"
          in: "path"
          required: true
          description: "Farcaster user ID (numeric)"
          schema:
            type: "string"
          example: "3"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "User data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFarcaster user profile by FID or username"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/user/{fid}/casts:
    get:
      tags:
        - "Social"
      summary: "User casts by FID"
      operationId: "getFarcasterUserCasts"
      x-price: "$0.02"
      parameters:
        - name: "fid"
          in: "path"
          required: true
          description: "Farcaster user ID (numeric)"
          schema:
            type: "string"
          example: "3"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Casts"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFarcaster user profile by FID or username"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/user/{fid}/followers:
    get:
      tags:
        - "Social"
      summary: "Followers by FID"
      operationId: "getFarcasterUserFollowersSocial"
      x-price: "$0.02"
      parameters:
        - name: "fid"
          in: "path"
          required: true
          description: "Farcaster user ID (numeric)"
          schema:
            type: "string"
          example: "3"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Followers"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFarcaster user profile by FID or username"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/user/{fid}/following:
    get:
      tags:
        - "Social"
      summary: "Following by FID"
      operationId: "getFarcasterUserFollowingSocial"
      x-price: "$0.02"
      parameters:
        - name: "fid"
          in: "path"
          required: true
          description: "Farcaster user ID (numeric)"
          schema:
            type: "string"
          example: "3"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Following"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFarcaster user profile by FID or username"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/user/{fid}/storage:
    get:
      tags:
        - "Social"
      summary: "User storage usage"
      operationId: "getFarcasterUserStorage"
      x-price: "$0.01"
      parameters:
        - name: "fid"
          in: "path"
          required: true
          description: "Farcaster user ID (numeric)"
          schema:
            type: "string"
          example: "3"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Storage"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFarcaster user profile by FID or username"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/username/{username}:
    get:
      tags:
        - "Social"
      summary: "User by username"
      operationId: "getFarcasterUserByUsername"
      x-price: "$0.02"
      parameters:
        - name: "username"
          in: "path"
          required: true
          description: "Social platform username"
          schema:
            type: "string"
          example: "dwr.eth"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "User data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFarcaster user profile by FID or username"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/users/bulk:
    get:
      tags:
        - "Social"
      summary: "Bulk user lookup"
      operationId: "getFarcasterUsersBulk"
      x-price: "$0.03"
      parameters:
        - name: "fids"
          in: "query"
          required: true
          description: "Comma-separated Farcaster user IDs"
          schema:
            type: "string"
          example: "bitcoin"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Users"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFarcaster user profile by FID or username"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/{identifier}:
    get:
      tags:
        - "Social"
      summary: "Farcaster profile"
      operationId: "getSocialFarcasterProfile"
      x-price: "$0.02"
      parameters:
        - name: "identifier"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Username or FID"
          example: "dwr.eth"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Profile data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/{identifier}/casts:
    get:
      tags:
        - "Social"
      summary: "User's casts"
      operationId: "getFarcasterCasts"
      x-price: "$0.02"
      parameters:
        - name: "identifier"
          in: "path"
          required: true
          description: "Resource identifier"
          schema:
            type: "string"
          example: "dwr.eth"
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
          description: "Maximum number of results to return"
          example: 10
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Casts list"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/{identifier}/followers:
    get:
      tags:
        - "Social"
      summary: "User's followers"
      operationId: "getFarcasterFollowers"
      x-price: "$0.02"
      parameters:
        - name: "identifier"
          in: "path"
          required: true
          description: "Resource identifier"
          schema:
            type: "string"
          example: "dwr.eth"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Followers"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/farcaster/{identifier}/following:
    get:
      tags:
        - "Social"
      summary: "User's following"
      operationId: "getFarcasterFollowing"
      x-price: "$0.02"
      parameters:
        - name: "identifier"
          in: "path"
          required: true
          description: "Resource identifier"
          schema:
            type: "string"
          example: "dwr.eth"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Following"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
              example:
                fid: 3
                username: "dwr"
                displayName: "Dan Romero"
                pfp: "https://example.com/pfp.jpg"
                followerCount: 123456
                followingCount: 567
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/social/{name}:
    get:
      tags:
        - "Social"
      summary: "Follower and following counts"
      operationId: "getapiSocial"
      x-price: "$0.01"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
        - name: "platforms"
          in: "query"
          schema:
            type: "string"
          description: "Filter platforms (ens,farcaster,lens)"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SocialProfile"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment required to access this resource"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.02 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.02"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/dai:
    get:
      tags:
        - "DeFi"
      summary: "DAI info"
      operationId: "getDaiInfo"
      x-price: "$0.01"
      responses:
        "200":
          description: "DAI"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                stablecoins:
                  - name: "Tether"
                    symbol: "USDT"
                    circulating: 95600000000
                    price: 0.9998
                  - name: "USD Coin"
                    symbol: "USDC"
                    circulating: 28450000000
                    price: 1.0001
                  - name: "DAI"
                    symbol: "DAI"
                    circulating: 5340000000
                    price: 1.0002
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/lusd:
    get:
      tags:
        - "DeFi"
      summary: "LUSD info"
      operationId: "getLusdInfo"
      x-price: "$0.01"
      responses:
        "200":
          description: "LUSD"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                stablecoins:
                  - name: "Tether"
                    symbol: "USDT"
                    circulating: 95600000000
                    price: 0.9998
                  - name: "USD Coin"
                    symbol: "USDC"
                    circulating: 28450000000
                    price: 1.0001
                  - name: "DAI"
                    symbol: "DAI"
                    circulating: 5340000000
                    price: 1.0002
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoin/dai:
    get:
      tags:
        - "DeFi"
      summary: "DAI stats"
      operationId: "getDai"
      x-price: "$0.01"
      responses:
        "200":
          description: "DAI"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                stablecoins:
                  - name: "Tether"
                    symbol: "USDT"
                    circulating: 95600000000
                    price: 0.9998
                  - name: "USD Coin"
                    symbol: "USDC"
                    circulating: 28450000000
                    price: 1.0001
                  - name: "DAI"
                    symbol: "DAI"
                    circulating: 5340000000
                    price: 1.0002
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoin/frax:
    get:
      tags:
        - "DeFi"
      summary: "FRAX stats"
      operationId: "getFraxStable"
      x-price: "$0.01"
      responses:
        "200":
          description: "FRAX"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                stablecoins:
                  - name: "Tether"
                    symbol: "USDT"
                    circulating: 95600000000
                    price: 0.9998
                  - name: "USD Coin"
                    symbol: "USDC"
                    circulating: 28450000000
                    price: 1.0001
                  - name: "DAI"
                    symbol: "DAI"
                    circulating: 5340000000
                    price: 1.0002
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoin/usdc:
    get:
      tags:
        - "DeFi"
      summary: "USDC stats"
      operationId: "getUsdc"
      x-price: "$0.01"
      responses:
        "200":
          description: "USDC"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                stablecoins:
                  - name: "Tether"
                    symbol: "USDT"
                    circulating: 95600000000
                    price: 0.9998
                  - name: "USD Coin"
                    symbol: "USDC"
                    circulating: 28450000000
                    price: 1.0001
                  - name: "DAI"
                    symbol: "DAI"
                    circulating: 5340000000
                    price: 1.0002
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoin/usdt:
    get:
      tags:
        - "DeFi"
      summary: "USDT stats"
      operationId: "getUsdt"
      x-price: "$0.01"
      responses:
        "200":
          description: "USDT"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                stablecoins:
                  - name: "Tether"
                    symbol: "USDT"
                    circulating: 95600000000
                    price: 0.9998
                  - name: "USD Coin"
                    symbol: "USDC"
                    circulating: 28450000000
                    price: 1.0001
                  - name: "DAI"
                    symbol: "DAI"
                    circulating: 5340000000
                    price: 1.0002
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoin/{asset}:
    get:
      tags:
        - "DeFi"
      summary: "Stablecoin details"
      operationId: "getStablecoinDetails"
      x-price: "$0.01"
      parameters:
        - name: "asset"
          in: "path"
          required: true
          description: "Asset identifier (token symbol or address)"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Details"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                stablecoins:
                  - name: "Tether"
                    symbol: "USDT"
                    circulating: 95600000000
                    price: 0.9998
                  - name: "USD Coin"
                    symbol: "USDC"
                    circulating: 28450000000
                    price: 1.0001
                  - name: "DAI"
                    symbol: "DAI"
                    circulating: 5340000000
                    price: 1.0002
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoin/{id}/chains:
    get:
      tags:
        - "DeFi"
      summary: "Stablecoin by chains"
      operationId: "getStablecoinChains"
      x-price: "$0.01"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Unique identifier"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Chains"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                chains:
                  - name: "Ethereum"
                    chainId: 1
                    tvl: 89500000000
                    protocols: 457
                  - name: "BSC"
                    chainId: 56
                    tvl: 12300000000
                    protocols: 234
                  - name: "Polygon"
                    chainId: 137
                    tvl: 8900000000
                    protocols: 189
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nList supported blockchain networks"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/chain/arbitrum:
    get:
      tags:
        - "DeFi"
      summary: "Arbitrum stablecoins"
      operationId: "getArbStablecoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stablecoins"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stablecoins/chain/avalanche:
    get:
      tags:
        - "DeFi"
      summary: "Avalanche stablecoins"
      operationId: "getAvaxStablecoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stablecoins"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stablecoins/chain/base:
    get:
      tags:
        - "DeFi"
      summary: "Base stablecoins"
      operationId: "getBaseStablecoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stablecoins"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stablecoins/chain/bsc:
    get:
      tags:
        - "DeFi"
      summary: "BSC stablecoins"
      operationId: "getBscStablecoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stablecoins"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stablecoins/chain/ethereum:
    get:
      tags:
        - "DeFi"
      summary: "Ethereum stablecoins"
      operationId: "getEthStablecoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stablecoins"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stablecoins/chain/fantom:
    get:
      tags:
        - "DeFi"
      summary: "Fantom stablecoins"
      operationId: "getFtmStablecoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stablecoins"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stablecoins/chain/optimism:
    get:
      tags:
        - "DeFi"
      summary: "Optimism stablecoins"
      operationId: "getOpStablecoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stablecoins"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stablecoins/chain/polygon:
    get:
      tags:
        - "DeFi"
      summary: "Polygon stablecoins"
      operationId: "getPolyStablecoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stablecoins"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stablecoins/chain/solana:
    get:
      tags:
        - "DeFi"
      summary: "Solana stablecoins"
      operationId: "getSolStablecoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stablecoins"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stablecoins/chain/tron:
    get:
      tags:
        - "DeFi"
      summary: "Tron stablecoins"
      operationId: "getTronStablecoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stablecoins"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stablecoins/chain/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "Stablecoins on chain"
      operationId: "getStablecoinsOnChain"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Stablecoins"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stablecoins/flows:
    get:
      tags:
        - "DeFi"
      summary: "Stablecoin flows"
      operationId: "getStablecoinFlows"
      x-price: "$0.02"
      responses:
        "200":
          description: "Flows"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                stablecoins:
                  - name: "Tether"
                    symbol: "USDT"
                    circulating: 95600000000
                    price: 0.9998
                  - name: "USD Coin"
                    symbol: "USDC"
                    circulating: 28450000000
                    price: 1.0001
                  - name: "DAI"
                    symbol: "DAI"
                    circulating: 5340000000
                    price: 1.0002
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stablecoins/marketcap:
    get:
      tags:
        - "DeFi"
      summary: "Stablecoin market cap"
      operationId: "getStablecoinMarketcap"
      x-price: "$0.01"
      responses:
        "200":
          description: "Market cap"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                stablecoins:
                  - name: "Tether"
                    symbol: "USDT"
                    circulating: 95600000000
                    price: 0.9998
                  - name: "USD Coin"
                    symbol: "USDC"
                    circulating: 28450000000
                    price: 1.0001
                  - name: "DAI"
                    symbol: "DAI"
                    circulating: 5340000000
                    price: 1.0002
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stablecoins/prices:
    get:
      tags:
        - "DeFi"
      summary: "Stablecoin prices"
      operationId: "getStablecoinPrices"
      x-price: "$0.01"
      responses:
        "200":
          description: "Prices"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Price"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get current price for a token (9-source fallback)"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stablecoins/usdc:
    get:
      tags:
        - "DeFi"
      summary: "USDC info"
      operationId: "getUsdcInfo"
      x-price: "$0.01"
      responses:
        "200":
          description: "USDC"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                stablecoins:
                  - name: "Tether"
                    symbol: "USDT"
                    circulating: 95600000000
                    price: 0.9998
                  - name: "USD Coin"
                    symbol: "USDC"
                    circulating: 28450000000
                    price: 1.0001
                  - name: "DAI"
                    symbol: "DAI"
                    circulating: 5340000000
                    price: 1.0002
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/usde:
    get:
      tags:
        - "DeFi"
      summary: "USDe info"
      operationId: "getUsdeInfo"
      x-price: "$0.01"
      responses:
        "200":
          description: "USDe"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                stablecoins:
                  - name: "Tether"
                    symbol: "USDT"
                    circulating: 95600000000
                    price: 0.9998
                  - name: "USD Coin"
                    symbol: "USDC"
                    circulating: 28450000000
                    price: 1.0001
                  - name: "DAI"
                    symbol: "DAI"
                    circulating: 5340000000
                    price: 1.0002
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/usdt:
    get:
      tags:
        - "DeFi"
      summary: "USDT info"
      operationId: "getUsdtInfo"
      x-price: "$0.01"
      responses:
        "200":
          description: "USDT"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StablecoinData"
              example:
                stablecoins:
                  - name: "Tether"
                    symbol: "USDT"
                    circulating: 95600000000
                    price: 0.9998
                  - name: "USD Coin"
                    symbol: "USDC"
                    circulating: 28450000000
                    price: 1.0001
                  - name: "DAI"
                    symbol: "DAI"
                    circulating: 5340000000
                    price: 1.0002
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/staking:
    get:
      tags:
        - "DeFi"
      summary: "Liquid staking overview"
      operationId: "getStakingOverview"
      x-price: "$0.01"
      responses:
        "200":
          description: "Overview"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
              example: &ref_1
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/binance-staked-eth:
    get:
      tags:
        - "DeFi"
      summary: "Binance staked ETH"
      operationId: "getBinanceStakedEth"
      x-price: "$0.01"
      responses:
        "200":
          description: "Binance ETH"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Binance staked ETH"
                tvl: 7229766349
                chains:
                  - "Ethereum"
                  - "Binance"
                source: "defillama"
                timestamp: "2026-02-18T15:35:17.006Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/eigenlayer:
    get:
      tags:
        - "DeFi"
      summary: "EigenLayer staking"
      operationId: "getEigenLayerStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "EigenLayer"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
              example: *ref_1
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/eth:
    get:
      tags:
        - "DeFi"
      summary: "ETH staking providers"
      operationId: "getapiStakingEth"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
              example: *ref_1
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/etherfi:
    get:
      tags:
        - "DeFi"
      summary: "Ether.fi staking"
      operationId: "getEtherFiStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Ether.fi"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "ether.fi"
                tvl: 5697399533.1915
                chains: []
                source: "defillama"
                timestamp: "2026-02-18T16:28:32.698Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/jito:
    get:
      tags:
        - "DeFi"
      summary: "Jito staking"
      operationId: "getJitoStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Jito"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Jito"
                tvl: 1046764934.46957
                chains: []
                source: "defillama"
                timestamp: "2026-02-18T16:37:09.477Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/karak:
    get:
      tags:
        - "DeFi"
      summary: "Karak staking"
      operationId: "getKarakStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Karak"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "OpenGDP Shared Security"
                tvl: 33992466
                chains:
                  - "Blast"
                  - "Fraxtal"
                  - "Ethereum"
                  - "Arbitrum"
                  - "Mantle"
                  - "K2"
                  - "Binance"
                source: "defillama"
                timestamp: "2026-02-18T16:37:10.432Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/kelp:
    get:
      tags:
        - "DeFi"
      summary: "Kelp staking"
      operationId: "getKelpStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Kelp"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "STAKING_ERROR"
                message: "HTTP 400"
                timestamp: "2026-02-18T16:37:10.683Z"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/lido:
    get:
      tags:
        - "DeFi"
      summary: "Lido staking"
      operationId: "getLidoStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Lido"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/liquid:
    get:
      tags:
        - "DeFi"
      summary: "Liquid staking tokens"
      operationId: "getapiStakingLiquid"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Not Found - Endpoint not implemented"
          content:
            application/json:
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/staking/liquid not found"
                timestamp: "2026-02-18T16:37:10.756Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/mantle-lsp:
    get:
      tags:
        - "DeFi"
      summary: "Mantle LSP staking"
      operationId: "getMantleLspStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Mantle LSP"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "STAKING_ERROR"
                message: "HTTP 400"
                timestamp: "2026-02-18T16:46:14.535Z"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/marinade:
    get:
      tags:
        - "DeFi"
      summary: "Marinade staking"
      operationId: "getMarinadeStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Marinade"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "STAKING_ERROR"
                message: "HTTP 400"
                timestamp: "2026-02-18T16:46:14.840Z"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/puffer:
    get:
      tags:
        - "DeFi"
      summary: "Puffer staking"
      operationId: "getPufferStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Puffer"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "STAKING_ERROR"
                message: "HTTP 400"
                timestamp: "2026-02-18T16:46:15.069Z"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/renzo:
    get:
      tags:
        - "DeFi"
      summary: "Renzo staking"
      operationId: "getRenzoStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Renzo"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Renzo"
                tvl: 381863727
                chains:
                  - "Base"
                  - "Blast"
                  - "Binance"
                  - "Solana"
                  - "Arbitrum"
                  - "Linea"
                  - "Ethereum"
                  - "Zircuit"
                  - "Mode"
                  - "Fraxtal"
                  - "Optimism"
                  - "Monad"
                  - "Sei"
                source: "defillama"
                timestamp: "2026-02-18T16:46:16.047Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/restaking:
    get:
      tags:
        - "DeFi"
      summary: "Restaking protocols"
      operationId: "getRestaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Restaking"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocols:
                  - name: "Symbiotic"
                    tvl: 365411095.5103245
                  - name: "Mantle Restaking"
                    tvl: 154452034.04898486
                  - name: "Mellow Restaking"
                    tvl: 61781840.58479702
                  - name: "Swell Liquid Restaking"
                    tvl: 33584996.98790191
                  - name: "Jito Restaking"
                    tvl: 16754591.527423559
                  - name: "Solayer Restaking"
                    tvl: 16064022.354798956
                  - name: "InceptionLRT (Isolated Restaking)"
                    tvl: 5392383.398155457
                  - name: "Adrastea Restaking Operator"
                    tvl: 1203628.8408933866
                  - name: "Milkyway Restaking"
                    tvl: 244962.61318486094
                  - name: "Affine Restaking"
                    tvl: 98797.01375505686
                source: "defillama"
                timestamp: "2026-02-18T16:46:16.306Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/rocketpool:
    get:
      tags:
        - "DeFi"
      summary: "Rocket Pool staking"
      operationId: "getRocketPoolStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Rocket Pool"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/swell:
    get:
      tags:
        - "DeFi"
      summary: "Swell staking"
      operationId: "getSwellStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Swell"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Swell"
                tvl: 135726291.87963
                chains: []
                source: "defillama"
                timestamp: "2026-02-18T16:53:24.746Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/staking/symbiotic:
    get:
      tags:
        - "DeFi"
      summary: "Symbiotic staking"
      operationId: "getSymbioticStaking"
      x-price: "$0.01"
      responses:
        "200":
          description: "Symbiotic"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Symbiotic"
                tvl: 365411095
                chains:
                  - "Ethereum"
                source: "defillama"
                timestamp: "2026-02-18T16:53:24.854Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/stats/defi:
    get:
      tags:
        - "Utilities"
      summary: "Global DeFi stats"
      operationId: "getapiStatsDefi"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stats/l2:
    get:
      tags:
        - "Utilities"
      summary: "L2 ecosystem stats"
      operationId: "getapiStatsL2"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Not Found - Endpoint not implemented"
          content:
            application/json:
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/stats/l2 not found"
                timestamp: "2026-02-18T20:19:22.948Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nLayer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stats/nft:
    get:
      tags:
        - "Utilities"
      summary: "Global NFT stats"
      operationId: "getapiStatsNft"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/time/block/{number}:
    get:
      tags:
        - "Utilities"
      summary: "Block timestamp"
      operationId: "getapiTimeBlock"
      x-price: "$0.01"
      parameters:
        - name: "number"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Block number"
          example: 19200000
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "ERROR"
                message: "Invalid time value"
                timestamp: "2026-02-18T16:53:25.071Z"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/time/unix/{timestamp}:
    get:
      tags:
        - "Utilities"
      summary: "Unix to ISO time"
      operationId: "getapiTimeUnix"
      x-price: "$0.01"
      parameters:
        - name: "timestamp"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Unix timestamp"
          example: "24h"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                input: "1739995200"
                unix: 1739995200
                unixMs: 1739995200000
                iso: "2025-02-19T20:00:00.000Z"
                utc: "Wed, 19 Feb 2025 20:00:00 GMT"
                relative: "363 days ago"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/token/holders/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Top token holders"
      operationId: "getapiTokenHolders"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/token/holders/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 not found"
                timestamp: "2026-02-18T20:19:22.988Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/token/info/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Token info by contract"
      operationId: "getapiTokenInfo"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/token/info/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 not found"
                timestamp: "2026-02-18T20:19:23.027Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/token/liquidity/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Token liquidity pools"
      operationId: "getapiTokenLiquidity"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/token/liquidity/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 not found"
                timestamp: "2026-02-18T20:19:23.071Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/token/supply/{contract}:
    get:
      tags:
        - "Utilities"
      summary: "Token supply info"
      operationId: "getapiTokenSupply"
      x-price: "$0.01"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Contract address"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/token/supply/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 not found"
                timestamp: "2026-02-18T20:19:23.109Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/ai:
    get:
      tags:
        - "Wallet"
      summary: "AI tokens"
      operationId: "getapiTokensAi"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenCategoryListResponse"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
              example:
                error: "Payment Required"
                code: "PAYMENT_REQUIRED"
                message: "Payment required: $0.01 USDC"
                payment:
                  scheme: "exact"
                  price: "$0.01"
                  network: "eip155:8453"
                  asset: "USDC"
                  payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/categories:
    get:
      tags:
        - "Prices"
      summary: "All token categories"
      operationId: "getTokenCategories"
      x-price: "$0.01"
      responses:
        "200":
          description: "Categories"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenCategoriesResponse"
              example:
                categories:
                  - id: "defi"
                    name: "DeFi"
                    tokenCount: 1234
                    marketCap: 123456789012.34
                  - id: "nft"
                    name: "NFT"
                    tokenCount: 567
                    marketCap: 23456789012.34
                  - id: "gaming"
                    name: "Gaming"
                    tokenCount: 345
                    marketCap: 12345678901.23
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/category/{category}:
    get:
      tags:
        - "Prices"
      summary: "Tokens by category"
      operationId: "getTokensByCategory"
      x-price: "$0.01"
      parameters:
        - name: "category"
          in: "path"
          required: true
          description: "Category filter"
          schema:
            type: "string"
          example: "defi"
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
          description: "Maximum number of results to return"
          example: 10
      responses:
        "200":
          description: "Tokens"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenCategoryListResponse"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "ERROR"
                message: "CoinGecko error: 401"
                timestamp: "2026-02-18T20:32:14.467Z"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/defi:
    get:
      tags:
        - "Wallet"
      summary: "DeFi governance tokens"
      operationId: "getapiTokensDefi"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenCategoryListResponse"
              example:
                tokens:
                  - symbol: "AAVE"
                    name: "Aave"
                    price: 234.56
                    marketCap: 3456789012.34
                    category: "Lending"
                  - symbol: "UNI"
                    name: "Uniswap"
                    price: 12.34
                    marketCap: 9876543210.12
                    category: "DEX"
                  - symbol: "MKR"
                    name: "Maker"
                    price: 2345.67
                    marketCap: 2345678901.23
                    category: "CDP"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/gainers:
    get:
      tags:
        - "Prices"
      summary: "Top gainers 24h"
      operationId: "getGainers"
      x-price: "$0.01"
      responses:
        "200":
          description: "Gainers"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenGainersResponse"
              example:
                gainers:
                  - name: "Bitcoin"
                    symbol: "btc"
                    price: 67524
                    marketCap: 1348931096767
                    change24h: -1.46569
                    volume24h: 37161402540
                    image: "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400"
                  - name: "Ethereum"
                    symbol: "eth"
                    price: 1996.94
                    marketCap: 240658726742
                    change24h: 0.56746
                    volume24h: 25401194196
                    image: "https://coin-images.coingecko.com/coins/images/279/large/ethereum.png?1696501628"
                  - name: "Tether"
                    symbol: "usdt"
                    price: 0.99951
                    marketCap: 183652472156
                    change24h: -0.00111
                    volume24h: 63888122241
                    image: "https://coin-images.coingecko.com/coins/images/325/large/Tether.png?1696501661"
                  - name: "XRP"
                    symbol: "xrp"
                    price: 1.48
                    marketCap: 90111662655
                    change24h: 0.12639
                    volume24h: 2239467171
                    image: "https://coin-images.coingecko.com/coins/images/44/large/xrp-symbol-white-128.png?1696501442"
                  - name: "BNB"
                    symbol: "bnb"
                    price: 617.37
                    marketCap: 84224343424
                    change24h: -1.49295
                    volume24h: 733698685
                    image: "https://coin-images.coingecko.com/coins/images/825/large/bnb-icon2_2x.png?1696501970"
                  - name: "USDC"
                    symbol: "usdc"
                    price: 0.999962
                    marketCap: 73492414396
                    change24h: 0.0137
                    volume24h: 5950331814
                    image: "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602"
                  - name: "Solana"
                    symbol: "sol"
                    price: 85.25
                    marketCap: 48470986809
                    change24h: -1.17508
                    volume24h: 3346333500
                    image: "https://coin-images.coingecko.com/coins/images/4128/large/solana.png?1718769756"
                  - name: "TRON"
                    symbol: "trx"
                    price: 0.28156
                    marketCap: 26639691060
                    change24h: -0.89321
                    volume24h: 539946130
                    image: "https://coin-images.coingecko.com/coins/images/1094/large/tron-logo.png?1696502193"
                  - name: "Dogecoin"
                    symbol: "doge"
                    price: 0.100797
                    marketCap: 17049654249
                    change24h: 0.36952
                    volume24h: 969964518
                    image: "https://coin-images.coingecko.com/coins/images/5/large/dogecoin.png?1696501409"
                  - name: "Figure Heloc"
                    symbol: "figr_heloc"
                    price: 1.031
                    marketCap: 15627421375
                    change24h: 1.37851
                    volume24h: 11280377
                    image: "https://coin-images.coingecko.com/coins/images/68480/large/figure.png?1755863954"
                  - name: "Bitcoin Cash"
                    symbol: "bch"
                    price: 565.66
                    marketCap: 11275629997
                    change24h: 0.16898
                    volume24h: 266940036
                    image: "https://coin-images.coingecko.com/coins/images/780/large/bitcoin-cash-circle.png?1696501932"
                  - name: "WhiteBIT Coin"
                    symbol: "wbt"
                    price: 51.32
                    marketCap: 10955897959
                    change24h: -0.7061
                    volume24h: 34929232
                    image: "https://coin-images.coingecko.com/coins/images/27045/large/wbt_token.png?1696526096"
                  - name: "Cardano"
                    symbol: "ada"
                    price: 0.282703
                    marketCap: 10400902751
                    change24h: -1.27028
                    volume24h: 363540278
                    image: "https://coin-images.coingecko.com/coins/images/975/large/cardano.png?1696502090"
                  - name: "USDS"
                    symbol: "usds"
                    price: 0.999856
                    marketCap: 9819182573
                    change24h: 0.03456
                    volume24h: 4060465
                    image: "https://coin-images.coingecko.com/coins/images/39926/large/usds.webp?1726666683"
                  - name: "LEO Token"
                    symbol: "leo"
                    price: 8.68
                    marketCap: 8002081530
                    change24h: 1.74028
                    volume24h: 1920699
                    image: "https://coin-images.coingecko.com/coins/images/8418/large/leo-token.png?1696508607"
                  - name: "Hyperliquid"
                    symbol: "hype"
                    price: 29.35
                    marketCap: 6985470638
                    change24h: -4.97854
                    volume24h: 198537509
                    image: "https://coin-images.coingecko.com/coins/images/50882/large/hyperliquid.jpg?1729431300"
                  - name: "Canton"
                    symbol: "cc"
                    price: 0.166572
                    marketCap: 6299342725
                    change24h: 3.0666
                    volume24h: 12004449
                    image: "https://coin-images.coingecko.com/coins/images/70468/large/Canton-Ticker_%281%29.png?1762826299"
                  - name: "Ethena USDe"
                    symbol: "usde"
                    price: 0.999233
                    marketCap: 6298210558
                    change24h: 0.03248
                    volume24h: 102655981
                    image: "https://coin-images.coingecko.com/coins/images/33613/large/usde.png?1733810059"
                  - name: "Chainlink"
                    symbol: "link"
                    price: 8.87
                    marketCap: 6287182128
                    change24h: -0.63254
                    volume24h: 239777471
                    image: "https://coin-images.coingecko.com/coins/images/877/large/Chainlink_Logo_500.png?1760023405"
                  - name: "Monero"
                    symbol: "xmr"
                    price: 334.52
                    marketCap: 6141688333
                    change24h: -1.54331
                    volume24h: 62573203
                    image: "https://coin-images.coingecko.com/coins/images/69/large/monero_logo.png?1696501460"
                source: "coingecko"
                timestamp: "2026-02-18T04:16:02.130Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/gainers/7d:
    get:
      tags:
        - "Prices"
      summary: "Top gainers 7d"
      operationId: "getGainers7d"
      x-price: "$0.01"
      responses:
        "200":
          description: "Gainers 7d"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenGainersResponse"
              example:
                gainers7d:
                  - name: "Bitcoin"
                    symbol: "btc"
                    price: 66343
                    marketCap: 1325154384826
                    change24h: -1.95361
                    volume24h: 35062381307
                    image: "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400"
                  - name: "Ethereum"
                    symbol: "eth"
                    price: 1942.86
                    marketCap: 234179123013
                    change24h: -2.57216
                    volume24h: 20269236906
                    image: "https://coin-images.coingecko.com/coins/images/279/large/ethereum.png?1696501628"
                  - name: "Tether"
                    symbol: "usdt"
                    price: 0.999636
                    marketCap: 183678720075
                    change24h: 0.00319
                    volume24h: 59098766267
                    image: "https://coin-images.coingecko.com/coins/images/325/large/Tether.png?1696501661"
                  - name: "XRP"
                    symbol: "xrp"
                    price: 1.42
                    marketCap: 86727337470
                    change24h: -3.86333
                    volume24h: 2013204122
                    image: "https://coin-images.coingecko.com/coins/images/44/large/xrp-symbol-white-128.png?1696501442"
                  - name: "BNB"
                    symbol: "bnb"
                    price: 604.48
                    marketCap: 82309356840
                    change24h: -2.25927
                    volume24h: 790449502
                    image: "https://coin-images.coingecko.com/coins/images/825/large/bnb-icon2_2x.png?1696501970"
                  - name: "USDC"
                    symbol: "usdc"
                    price: 0.999902
                    marketCap: 73605667687
                    change24h: -0.00604
                    volume24h: 5334182924
                    image: "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602"
                  - name: "Solana"
                    symbol: "sol"
                    price: 81.1
                    marketCap: 46073233456
                    change24h: -4.44162
                    volume24h: 3412467199
                    image: "https://coin-images.coingecko.com/coins/images/4128/large/solana.png?1718769756"
                  - name: "TRON"
                    symbol: "trx"
                    price: 0.278395
                    marketCap: 26371100109
                    change24h: -1.31638
                    volume24h: 468463987
                    image: "https://coin-images.coingecko.com/coins/images/1094/large/tron-logo.png?1696502193"
                  - name: "Dogecoin"
                    symbol: "doge"
                    price: 0.098605
                    marketCap: 16635269252
                    change24h: -2.13676
                    volume24h: 716727406
                    image: "https://coin-images.coingecko.com/coins/images/5/large/dogecoin.png?1696501409"
                  - name: "Figure Heloc"
                    symbol: "figr_heloc"
                    price: 1.033
                    marketCap: 15731602387
                    change24h: 0.16081
                    volume24h: 28287425
                    image: "https://coin-images.coingecko.com/coins/images/68480/large/figure.png?1755863954"
                  - name: "Bitcoin Cash"
                    symbol: "bch"
                    price: 552.86
                    marketCap: 11055424843
                    change24h: -2.63727
                    volume24h: 246057226
                    image: "https://coin-images.coingecko.com/coins/images/780/large/bitcoin-cash-circle.png?1696501932"
                  - name: "WhiteBIT Coin"
                    symbol: "wbt"
                    price: 50.22
                    marketCap: 10726618013
                    change24h: -2.1053
                    volume24h: 50797621
                    image: "https://coin-images.coingecko.com/coins/images/27045/large/wbt_token.png?1696526096"
                  - name: "Cardano"
                    symbol: "ada"
                    price: 0.273761
                    marketCap: 10068122099
                    change24h: -3.09315
                    volume24h: 318451156
                    image: "https://coin-images.coingecko.com/coins/images/975/large/cardano.png?1696502090"
                  - name: "USDS"
                    symbol: "usds"
                    price: 0.999801
                    marketCap: 9817174342
                    change24h: -0.01583
                    volume24h: 4273454
                    image: "https://coin-images.coingecko.com/coins/images/39926/large/usds.webp?1726666683"
                  - name: "LEO Token"
                    symbol: "leo"
                    price: 8.52
                    marketCap: 7849202502
                    change24h: -1.87466
                    volume24h: 2675686
                    image: "https://coin-images.coingecko.com/coins/images/8418/large/leo-token.png?1696508607"
                  - name: "Hyperliquid"
                    symbol: "hype"
                    price: 28.77
                    marketCap: 6871635745
                    change24h: -2.42037
                    volume24h: 168829319
                    image: "https://coin-images.coingecko.com/coins/images/50882/large/hyperliquid.jpg?1729431300"
                  - name: "Canton"
                    symbol: "cc"
                    price: 0.169146
                    marketCap: 6390677607
                    change24h: 1.05628
                    volume24h: 9064421
                    image: "https://coin-images.coingecko.com/coins/images/70468/large/Canton-Ticker_%281%29.png?1762826299"
                  - name: "Ethena USDe"
                    symbol: "usde"
                    price: 0.999007
                    marketCap: 6301705940
                    change24h: 0.00137
                    volume24h: 70663676
                    image: "https://coin-images.coingecko.com/coins/images/33613/large/usde.png?1733810059"
                  - name: "Monero"
                    symbol: "xmr"
                    price: 330.06
                    marketCap: 6083766820
                    change24h: -0.80937
                    volume24h: 70406041
                    image: "https://coin-images.coingecko.com/coins/images/69/large/monero_logo.png?1696501460"
                  - name: "Chainlink"
                    symbol: "link"
                    price: 8.56
                    marketCap: 6057521716
                    change24h: -3.3738
                    volume24h: 226043540
                    image: "https://coin-images.coingecko.com/coins/images/877/large/Chainlink_Logo_500.png?1760023405"
                source: "coingecko"
                timestamp: "2026-02-18T20:32:14.632Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/gaming:
    get:
      tags:
        - "Wallet"
      summary: "Gaming tokens"
      operationId: "getapiTokensGaming"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenCategoryListResponse"
              example:
                tokens:
                  - symbol: "AXS"
                    name: "Axie Infinity"
                    price: 12.34
                    marketCap: 1234567890.12
                    game: "Axie Infinity"
                  - symbol: "SAND"
                    name: "The Sandbox"
                    price: 0.89
                    marketCap: 987654321.09
                    game: "The Sandbox"
                  - symbol: "MANA"
                    name: "Decentraland"
                    price: 0.67
                    marketCap: 876543210.98
                    game: "Decentraland"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/high-volume:
    get:
      tags:
        - "Prices"
      summary: "High volume tokens"
      operationId: "getHighVolumeTokens"
      x-price: "$0.01"
      responses:
        "200":
          description: "High volume"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenCategoryListResponse"
              example:
                highVolume:
                  - name: "Tether"
                    symbol: "usdt"
                    price: 0.999636
                    marketCap: 183678720075
                    change24h: 0.00319
                    volume24h: 59098766267
                    image: "https://coin-images.coingecko.com/coins/images/325/large/Tether.png?1696501661"
                  - name: "Bitcoin"
                    symbol: "btc"
                    price: 66343
                    marketCap: 1325154384826
                    change24h: -1.95361
                    volume24h: 35062381307
                    image: "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400"
                  - name: "Ethereum"
                    symbol: "eth"
                    price: 1942.86
                    marketCap: 234179123013
                    change24h: -2.57216
                    volume24h: 20269236906
                    image: "https://coin-images.coingecko.com/coins/images/279/large/ethereum.png?1696501628"
                  - name: "USDC"
                    symbol: "usdc"
                    price: 0.999902
                    marketCap: 73605667687
                    change24h: -0.00604
                    volume24h: 5334182924
                    image: "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602"
                  - name: "Solana"
                    symbol: "sol"
                    price: 81.1
                    marketCap: 46073233456
                    change24h: -4.44162
                    volume24h: 3412467199
                    image: "https://coin-images.coingecko.com/coins/images/4128/large/solana.png?1718769756"
                  - name: "XRP"
                    symbol: "xrp"
                    price: 1.42
                    marketCap: 86727337470
                    change24h: -3.86333
                    volume24h: 2013204122
                    image: "https://coin-images.coingecko.com/coins/images/44/large/xrp-symbol-white-128.png?1696501442"
                  - name: "USD1"
                    symbol: "usd1"
                    price: 0.999956
                    marketCap: 5137389247
                    change24h: 0.02771
                    volume24h: 1599424619
                    image: "https://coin-images.coingecko.com/coins/images/54977/large/USD1_1000x1000_transparent.png?1749297002"
                  - name: "BNB"
                    symbol: "bnb"
                    price: 604.48
                    marketCap: 82309356840
                    change24h: -2.25927
                    volume24h: 790449502
                    image: "https://coin-images.coingecko.com/coins/images/825/large/bnb-icon2_2x.png?1696501970"
                  - name: "Dogecoin"
                    symbol: "doge"
                    price: 0.098605
                    marketCap: 16635269252
                    change24h: -2.13676
                    volume24h: 716727406
                    image: "https://coin-images.coingecko.com/coins/images/5/large/dogecoin.png?1696501409"
                  - name: "TRON"
                    symbol: "trx"
                    price: 0.278395
                    marketCap: 26371100109
                    change24h: -1.31638
                    volume24h: 468463987
                    image: "https://coin-images.coingecko.com/coins/images/1094/large/tron-logo.png?1696502193"
                  - name: "World Liberty Financial"
                    symbol: "wlfi"
                    price: 0.121014
                    marketCap: 3295954981
                    change24h: 16.14447
                    volume24h: 445874194
                    image: "https://coin-images.coingecko.com/coins/images/50767/large/wlfi.png?1756438915"
                  - name: "Sui"
                    symbol: "sui"
                    price: 0.931323
                    marketCap: 3581970882
                    change24h: -3.52526
                    volume24h: 431063059
                    image: "https://coin-images.coingecko.com/coins/images/26375/large/sui-ocean-square.png?1727791290"
                  - name: "Aave"
                    symbol: "aave"
                    price: 121.79
                    marketCap: 1849937548
                    change24h: -4.04987
                    volume24h: 346922645
                    image: "https://coin-images.coingecko.com/coins/images/12645/large/aave-token-round.png?1720472354"
                  - name: "Pepe"
                    symbol: "pepe"
                    price: 0.00000423
                    marketCap: 1778790066
                    change24h: -3.96818
                    volume24h: 319291324
                    image: "https://coin-images.coingecko.com/coins/images/29850/large/pepe-token.jpeg?1696528776"
                  - name: "Cardano"
                    symbol: "ada"
                    price: 0.273761
                    marketCap: 10068122099
                    change24h: -3.09315
                    volume24h: 318451156
                    image: "https://coin-images.coingecko.com/coins/images/975/large/cardano.png?1696502090"
                  - name: "Zcash"
                    symbol: "zec"
                    price: 272.01
                    marketCap: 4503600586
                    change24h: -4.90224
                    volume24h: 308969816
                    image: "https://coin-images.coingecko.com/coins/images/486/large/circle-zcash-color.png?1696501740"
                  - name: "Tether Gold"
                    symbol: "xaut"
                    price: 4955.02
                    marketCap: 2580658072
                    change24h: 2.05801
                    volume24h: 273707006
                    image: "https://coin-images.coingecko.com/coins/images/10481/large/Tether_Gold.png?1696510471"
                  - name: "Litecoin"
                    symbol: "ltc"
                    price: 53.19
                    marketCap: 4086489125
                    change24h: -1.59618
                    volume24h: 272669033
                    image: "https://coin-images.coingecko.com/coins/images/2/large/litecoin.png?1696501400"
                  - name: "Bitcoin Cash"
                    symbol: "bch"
                    price: 552.86
                    marketCap: 11055424843
                    change24h: -2.63727
                    volume24h: 246057226
                    image: "https://coin-images.coingecko.com/coins/images/780/large/bitcoin-cash-circle.png?1696501932"
                  - name: "Chainlink"
                    symbol: "link"
                    price: 8.56
                    marketCap: 6057521716
                    change24h: -3.3738
                    volume24h: 226043540
                    image: "https://coin-images.coingecko.com/coins/images/877/large/Chainlink_Logo_500.png?1760023405"
                source: "coingecko"
                timestamp: "2026-02-18T20:32:14.831Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/holders/{contract}:
    get:
      tags:
        - "Prices"
      summary: "Token holders"
      operationId: "getTokenHolders"
      x-price: "$0.02"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          description: "Smart contract address (0x format)"
          schema:
            type: "string"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
      responses:
        "200":
          description: "Holders"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenHoldersResponse"
              example:
                contract: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
                symbol: "USDC"
                totalHolders: 1234567
                topHolders:
                  - address: "0x1234567890123456789012345678901234567890"
                    balance: "5678901234000000"
                    share: 24.3
                  - address: "0x2345678901234567890123456789012345678901"
                    balance: "3456789012000000"
                    share: 14.8
                  - address: "0x3456789012345678901234567890123456789012"
                    balance: "2345678901000000"
                    share: 10
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/info/{address}:
    get:
      tags:
        - "Prices"
      summary: "Token info by contract address"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet token metadata and current price by contract address"
      operationId: "getTokenInfo"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Token contract address (0x format)"
          schema:
            type: "string"
          example: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain network (ethereum, base, polygon, etc)"
          example: "ethereum"
      responses:
        "200":
          description: "Token information"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenInfoResponse"
              example:
                address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
                chain: "ethereum"
                symbol: "USDC"
                price: 0.9999757034484806
                decimals: 6
                confidence: 0.99
                source: "defillama"
                timestamp: "2026-02-18T04:16:00.943Z"
        "404":
          description: "Token not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/l2:
    get:
      tags:
        - "Wallet"
      summary: "L2 native tokens"
      operationId: "getapiTokensL2"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenCategoryListResponse"
              example:
                tokens:
                  - symbol: "ARB"
                    name: "Arbitrum"
                    price: 1.23
                    marketCap: 1234567890.12
                    chain: "Arbitrum"
                  - symbol: "OP"
                    name: "Optimism"
                    price: 2.34
                    marketCap: 2345678901.23
                    chain: "Optimism"
                  - symbol: "MATIC"
                    name: "Polygon"
                    price: 0.89
                    marketCap: 8901234567.89
                    chain: "Polygon"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nLayer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/losers:
    get:
      tags:
        - "Prices"
      summary: "Top losers 24h"
      operationId: "getLosers"
      x-price: "$0.01"
      responses:
        "200":
          description: "Losers"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenLosersResponse"
              example:
                losers:
                  - name: "Bitcoin"
                    symbol: "btc"
                    price: 67524
                    marketCap: 1348931096767
                    change24h: -1.46569
                    volume24h: 37161402540
                    image: "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400"
                  - name: "Ethereum"
                    symbol: "eth"
                    price: 1996.94
                    marketCap: 240658726742
                    change24h: 0.56746
                    volume24h: 25401194196
                    image: "https://coin-images.coingecko.com/coins/images/279/large/ethereum.png?1696501628"
                  - name: "Tether"
                    symbol: "usdt"
                    price: 0.99951
                    marketCap: 183652472156
                    change24h: -0.00111
                    volume24h: 63888122241
                    image: "https://coin-images.coingecko.com/coins/images/325/large/Tether.png?1696501661"
                  - name: "XRP"
                    symbol: "xrp"
                    price: 1.48
                    marketCap: 90111662655
                    change24h: 0.12639
                    volume24h: 2239467171
                    image: "https://coin-images.coingecko.com/coins/images/44/large/xrp-symbol-white-128.png?1696501442"
                  - name: "BNB"
                    symbol: "bnb"
                    price: 617.37
                    marketCap: 84224343424
                    change24h: -1.49295
                    volume24h: 733698685
                    image: "https://coin-images.coingecko.com/coins/images/825/large/bnb-icon2_2x.png?1696501970"
                  - name: "USDC"
                    symbol: "usdc"
                    price: 0.999962
                    marketCap: 73492414396
                    change24h: 0.0137
                    volume24h: 5950331814
                    image: "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602"
                  - name: "Solana"
                    symbol: "sol"
                    price: 85.25
                    marketCap: 48470986809
                    change24h: -1.17508
                    volume24h: 3346333500
                    image: "https://coin-images.coingecko.com/coins/images/4128/large/solana.png?1718769756"
                  - name: "TRON"
                    symbol: "trx"
                    price: 0.28156
                    marketCap: 26639691060
                    change24h: -0.89321
                    volume24h: 539946130
                    image: "https://coin-images.coingecko.com/coins/images/1094/large/tron-logo.png?1696502193"
                  - name: "Dogecoin"
                    symbol: "doge"
                    price: 0.100797
                    marketCap: 17049654249
                    change24h: 0.36952
                    volume24h: 969964518
                    image: "https://coin-images.coingecko.com/coins/images/5/large/dogecoin.png?1696501409"
                  - name: "Figure Heloc"
                    symbol: "figr_heloc"
                    price: 1.031
                    marketCap: 15627421375
                    change24h: 1.37851
                    volume24h: 11280377
                    image: "https://coin-images.coingecko.com/coins/images/68480/large/figure.png?1755863954"
                  - name: "Bitcoin Cash"
                    symbol: "bch"
                    price: 565.66
                    marketCap: 11275629997
                    change24h: 0.16898
                    volume24h: 266940036
                    image: "https://coin-images.coingecko.com/coins/images/780/large/bitcoin-cash-circle.png?1696501932"
                  - name: "WhiteBIT Coin"
                    symbol: "wbt"
                    price: 51.32
                    marketCap: 10955897959
                    change24h: -0.7061
                    volume24h: 34929232
                    image: "https://coin-images.coingecko.com/coins/images/27045/large/wbt_token.png?1696526096"
                  - name: "Cardano"
                    symbol: "ada"
                    price: 0.282703
                    marketCap: 10400902751
                    change24h: -1.27028
                    volume24h: 363540278
                    image: "https://coin-images.coingecko.com/coins/images/975/large/cardano.png?1696502090"
                  - name: "USDS"
                    symbol: "usds"
                    price: 0.999856
                    marketCap: 9819182573
                    change24h: 0.03456
                    volume24h: 4060465
                    image: "https://coin-images.coingecko.com/coins/images/39926/large/usds.webp?1726666683"
                  - name: "LEO Token"
                    symbol: "leo"
                    price: 8.68
                    marketCap: 8002081530
                    change24h: 1.74028
                    volume24h: 1920699
                    image: "https://coin-images.coingecko.com/coins/images/8418/large/leo-token.png?1696508607"
                  - name: "Hyperliquid"
                    symbol: "hype"
                    price: 29.35
                    marketCap: 6985470638
                    change24h: -4.97854
                    volume24h: 198537509
                    image: "https://coin-images.coingecko.com/coins/images/50882/large/hyperliquid.jpg?1729431300"
                  - name: "Canton"
                    symbol: "cc"
                    price: 0.166572
                    marketCap: 6299342725
                    change24h: 3.0666
                    volume24h: 12004449
                    image: "https://coin-images.coingecko.com/coins/images/70468/large/Canton-Ticker_%281%29.png?1762826299"
                  - name: "Ethena USDe"
                    symbol: "usde"
                    price: 0.999233
                    marketCap: 6298210558
                    change24h: 0.03248
                    volume24h: 102655981
                    image: "https://coin-images.coingecko.com/coins/images/33613/large/usde.png?1733810059"
                  - name: "Chainlink"
                    symbol: "link"
                    price: 8.87
                    marketCap: 6287182128
                    change24h: -0.63254
                    volume24h: 239777471
                    image: "https://coin-images.coingecko.com/coins/images/877/large/Chainlink_Logo_500.png?1760023405"
                  - name: "Monero"
                    symbol: "xmr"
                    price: 334.52
                    marketCap: 6141688333
                    change24h: -1.54331
                    volume24h: 62573203
                    image: "https://coin-images.coingecko.com/coins/images/69/large/monero_logo.png?1696501460"
                source: "coingecko"
                timestamp: "2026-02-18T04:16:02.201Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/memecoins:
    get:
      tags:
        - "Wallet"
      summary: "Top memecoins"
      operationId: "getapiTokensMemecoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenCategoryListResponse"
              example:
                tokens:
                  - symbol: "DOGE"
                    name: "Dogecoin"
                    price: 0.12
                    marketCap: 17890123456.78
                    change24h: 5.67
                  - symbol: "SHIB"
                    name: "Shiba Inu"
                    price: 0.000012
                    marketCap: 7123456789.01
                    change24h: -2.34
                  - symbol: "PEPE"
                    name: "Pepe"
                    price: 0.0000023
                    marketCap: 967890123.45
                    change24h: 12.45
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/new:
    get:
      tags:
        - "Prices"
      summary: "New tokens"
      operationId: "getNewTokens"
      x-price: "$0.01"
      responses:
        "200":
          description: "New tokens"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenCategoryListResponse"
              example:
                tokens:
                  - address: "0x1234567890123456789012345678901234567890"
                    symbol: "NEWTOKEN"
                    name: "New Token"
                    createdAt: 1707350400
                    initialPrice: 0.001
                    currentPrice: 0.0015
                    liquidity: 123456.78
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/ohlc/{id}:
    get:
      tags:
        - "Prices"
      summary: "Token OHLC data"
      operationId: "getTokenOhlc"
      x-price: "$0.01"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Unique identifier"
          schema:
            type: "string"
          example: "bitcoin"
        - name: "days"
          in: "query"
          schema:
            type: "integer"
          description: "Number of days for historical data"
          example: 7
      responses:
        "200":
          description: "OHLC data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenOHLCResponse"
              example:
                token: "bitcoin"
                days: 7
                ohlc:
                  - timestamp: "2026-02-12T00:00:00.000Z"
                    open: 67537
                    high: 68115
                    low: 66908
                    close: 66938
                  - timestamp: "2026-02-12T04:00:00.000Z"
                    open: 66994
                    high: 67912
                    low: 66994
                    close: 67465
                  - timestamp: "2026-02-12T08:00:00.000Z"
                    open: 67524
                    high: 67557
                    low: 66660
                    close: 67111
                  - timestamp: "2026-02-12T12:00:00.000Z"
                    open: 67178
                    high: 68161
                    low: 66881
                    close: 68098
                  - timestamp: "2026-02-12T16:00:00.000Z"
                    open: 68105
                    high: 68309
                    low: 67108
                    close: 67257
                  - timestamp: "2026-02-12T20:00:00.000Z"
                    open: 67107
                    high: 67116
                    low: 65243
                    close: 65860
                  - timestamp: "2026-02-13T00:00:00.000Z"
                    open: 65787
                    high: 66350
                    low: 65349
                    close: 66185
                  - timestamp: "2026-02-13T04:00:00.000Z"
                    open: 66192
                    high: 66668
                    low: 65895
                    close: 66433
                  - timestamp: "2026-02-13T08:00:00.000Z"
                    open: 66461
                    high: 66566
                    low: 66030
                    close: 66161
                  - timestamp: "2026-02-13T12:00:00.000Z"
                    open: 66168
                    high: 67018
                    low: 66168
                    close: 66991
                  - timestamp: "2026-02-13T16:00:00.000Z"
                    open: 67126
                    high: 69075
                    low: 66917
                    close: 68601
                  - timestamp: "2026-02-13T20:00:00.000Z"
                    open: 68569
                    high: 69277
                    low: 68569
                    close: 68994
                  - timestamp: "2026-02-14T00:00:00.000Z"
                    open: 68928
                    high: 68978
                    low: 68718
                    close: 68839
                  - timestamp: "2026-02-14T04:00:00.000Z"
                    open: 68849
                    high: 69068
                    low: 68767
                    close: 68923
                  - timestamp: "2026-02-14T08:00:00.000Z"
                    open: 68947
                    high: 69274
                    low: 68713
                    close: 69274
                  - timestamp: "2026-02-14T12:00:00.000Z"
                    open: 69190
                    high: 70352
                    low: 69190
                    close: 70352
                  - timestamp: "2026-02-14T16:00:00.000Z"
                    open: 70434
                    high: 70434
                    low: 69287
                    close: 69764
                  - timestamp: "2026-02-14T20:00:00.000Z"
                    open: 69762
                    high: 69857
                    low: 69342
                    close: 69846
                  - timestamp: "2026-02-15T00:00:00.000Z"
                    open: 69826
                    high: 70183
                    low: 69700
                    close: 69766
                  - timestamp: "2026-02-15T04:00:00.000Z"
                    open: 69774
                    high: 69907
                    low: 69347
                    close: 69907
                  - timestamp: "2026-02-15T08:00:00.000Z"
                    open: 69961
                    high: 70777
                    low: 69961
                    close: 70665
                  - timestamp: "2026-02-15T12:00:00.000Z"
                    open: 70786
                    high: 70898
                    low: 70230
                    close: 70260
                  - timestamp: "2026-02-15T16:00:00.000Z"
                    open: 70267
                    high: 70333
                    low: 68823
                    close: 68957
                  - timestamp: "2026-02-15T20:00:00.000Z"
                    open: 69061
                    high: 69061
                    low: 68096
                    close: 68305
                  - timestamp: "2026-02-16T00:00:00.000Z"
                    open: 68283
                    high: 68994
                    low: 68137
                    close: 68717
                  - timestamp: "2026-02-16T04:00:00.000Z"
                    open: 68781
                    high: 68927
                    low: 68161
                    close: 68385
                  - timestamp: "2026-02-16T08:00:00.000Z"
                    open: 68378
                    high: 68833
                    low: 68269
                    close: 68520
                  - timestamp: "2026-02-16T12:00:00.000Z"
                    open: 68543
                    high: 68979
                    low: 68396
                    close: 68718
                  - timestamp: "2026-02-16T16:00:00.000Z"
                    open: 68817
                    high: 69999
                    low: 67382
                    close: 67572
                  - timestamp: "2026-02-16T20:00:00.000Z"
                    open: 67513
                    high: 68145
                    low: 67513
                    close: 67935
                  - timestamp: "2026-02-17T00:00:00.000Z"
                    open: 67882
                    high: 68908
                    low: 67874
                    close: 68908
                  - timestamp: "2026-02-17T04:00:00.000Z"
                    open: 68852
                    high: 69088
                    low: 68411
                    close: 68528
                  - timestamp: "2026-02-17T08:00:00.000Z"
                    open: 68466
                    high: 68636
                    low: 67960
                    close: 68425
                  - timestamp: "2026-02-17T12:00:00.000Z"
                    open: 68359
                    high: 68395
                    low: 67710
                    close: 67818
                  - timestamp: "2026-02-17T16:00:00.000Z"
                    open: 67833
                    high: 68164
                    low: 66725
                    close: 67274
                  - timestamp: "2026-02-17T20:00:00.000Z"
                    open: 67352
                    high: 68071
                    low: 66952
                    close: 67807
                  - timestamp: "2026-02-18T00:00:00.000Z"
                    open: 67790
                    high: 67832
                    low: 67419
                    close: 67489
                  - timestamp: "2026-02-18T04:00:00.000Z"
                    open: 67479
                    high: 67610
                    low: 66895
                    close: 67610
                  - timestamp: "2026-02-18T08:00:00.000Z"
                    open: 67606
                    high: 68153
                    low: 67492
                    close: 68122
                  - timestamp: "2026-02-18T12:00:00.000Z"
                    open: 68088
                    high: 68328
                    low: 67166
                    close: 67512
                  - timestamp: "2026-02-18T16:00:00.000Z"
                    open: 67379
                    high: 68118
                    low: 66834
                    close: 67797
                  - timestamp: "2026-02-18T20:00:00.000Z"
                    open: 67663
                    high: 67663
                    low: 65907
                    close: 66160
                source: "coingecko"
                timestamp: "2026-02-18T20:32:14.994Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/price/steth:
    get:
      tags:
        - "Prices"
      summary: "stETH price"
      operationId: "getStethPrice"
      x-price: "$0.01"
      responses:
        "200":
          description: "stETH price"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPriceResponse"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/price/wbtc:
    get:
      tags:
        - "Prices"
      summary: "WBTC price"
      operationId: "getWbtcPrice"
      x-price: "$0.01"
      responses:
        "200":
          description: "WBTC price"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPriceResponse"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/price/weth:
    get:
      tags:
        - "Prices"
      summary: "WETH price"
      operationId: "getWethPrice"
      x-price: "$0.01"
      responses:
        "200":
          description: "WETH price"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenPriceResponse"
              example:
                symbol: "ETH"
                price: 3245.67
                change24h: 2.34
                volume24h: 15600000000
                marketCap: 389000000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet current price for a token (9-source fallback)"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/privacy:
    get:
      tags:
        - "Prices"
      summary: "Privacy tokens list"
      operationId: "getPrivacyTokensList"
      x-price: "$0.01"
      responses:
        "200":
          description: "Privacy tokens"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenCategoryListResponse"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "ERROR"
                message: "CoinGecko error: 401"
                timestamp: "2026-02-18T20:37:38.829Z"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/rwa:
    get:
      tags:
        - "Wallet"
      summary: "RWA tokens"
      operationId: "getapiTokensRwa"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenCategoryListResponse"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "ERROR"
                message: "DefiLlama error: undefined"
                timestamp: "2026-02-18T20:37:39.124Z"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/stablecoins:
    get:
      tags:
        - "Wallet"
      summary: "All stablecoins"
      operationId: "getapiTokensStablecoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenStablecoinsResponse"
              example:
                stablecoins:
                  - name: "Tether"
                    symbol: "USDT"
                    circulating: 95600000000
                    price: 0.9998
                  - name: "USD Coin"
                    symbol: "USDC"
                    circulating: 28450000000
                    price: 1.0001
                  - name: "DAI"
                    symbol: "DAI"
                    circulating: 5340000000
                    price: 1.0002
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/storage:
    get:
      tags:
        - "Prices"
      summary: "Storage tokens list"
      operationId: "getStorageTokensList"
      x-price: "$0.01"
      responses:
        "200":
          description: "Storage tokens"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenCategoryListResponse"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "ERROR"
                message: "CoinGecko error: 401"
                timestamp: "2026-02-18T20:37:39.175Z"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/supply/{contract}:
    get:
      tags:
        - "Prices"
      summary: "Token supply"
      operationId: "getTokenSupply"
      x-price: "$0.01"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          description: "Smart contract address (0x format)"
          schema:
            type: "string"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
      responses:
        "200":
          description: "Supply"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenSupplyResponse"
              example:
                contract: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
                chain: "ethereum"
                note: "Supply data requires RPC call or indexer"
                timestamp: "2026-02-18T20:37:39.213Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/symbol/{symbol}:
    get:
      tags:
        - "Prices"
      summary: "Lookup by symbol"
      operationId: "lookupBySymbol"
      x-price: "$0.01"
      parameters:
        - name: "symbol"
          in: "path"
          required: true
          description: "Token symbol (ETH, USDC, etc)"
          schema:
            type: "string"
          example: "ETH"
      responses:
        "200":
          description: "Matches"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TokenSymbolLookupResponse"
              example:
                symbol: "ETH"
                matches:
                  - id: "ethereum"
                    name: "Ethereum"
                    symbol: "ETH"
                    marketCapRank: 2
                source: "coingecko"
                timestamp: "2026-02-18T20:37:39.349Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/{address}:
    get:
      tags:
        - "Wallet"
      summary: "ERC20 token balances"
      operationId: "getapiTokens"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/tokens/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 not found"
                timestamp: "2026-02-18T20:40:48.097Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/transactions/avatar/{name}:
    get:
      tags:
        - "ENS"
      summary: "ENS avatar URL"
      operationId: "getEnsAvatarUrl"
      x-price: "$0.01"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name (e.g., vitalik.eth)"
          schema:
            type: "string"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Avatar"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/transactions/avatar/vitalik.eth not found"
                timestamp: "2026-02-18T20:40:48.138Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/transactions/contract/code/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Contract bytecode"
      operationId: "getContractBytecode"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain network (ethereum, base, polygon, etc)"
          example: "ethereum"
      responses:
        "200":
          description: "Code"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/transactions/contract/code/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 not found"
                timestamp: "2026-02-18T20:44:08.453Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/transactions/contract/source/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Contract source code"
      operationId: "getContractSource"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain network (ethereum, base, polygon, etc)"
          example: "ethereum"
      responses:
        "200":
          description: "Source"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/transactions/contract/source/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 not found"
                timestamp: "2026-02-18T20:44:08.494Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/transactions/contract/verify/{address}:
    get:
      tags:
        - "Security"
      summary: "Contract verification status"
      operationId: "getContractVerification"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain network (ethereum, base, polygon, etc)"
          example: "ethereum"
      responses:
        "200":
          description: "Verification"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/transactions/contract/verify/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 not found"
                timestamp: "2026-02-18T20:44:08.535Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/transactions/profile/{name}:
    get:
      tags:
        - "ENS"
      summary: "ENS profile"
      operationId: "getEnsTransactionProfile"
      x-price: "$0.02"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name (e.g., vitalik.eth)"
          schema:
            type: "string"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Profile"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/transactions/profile/vitalik.eth not found"
                timestamp: "2026-02-18T20:40:48.176Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/transactions/reverse/{address}:
    get:
      tags:
        - "ENS"
      summary: "Reverse ENS lookup"
      operationId: "reverseEnsLookup"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Name"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/transactions/reverse/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 not found"
                timestamp: "2026-02-18T20:40:48.218Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/transactions/timestamp:
    get:
      tags:
        - "Utilities"
      summary: "Current timestamp"
      operationId: "getTimestamp"
      x-price: "$0.005"
      responses:
        "200":
          description: "Timestamp"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Not Found - Endpoint not implemented"
          content:
            application/json:
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/transactions/timestamp not found"
                timestamp: "2026-02-18T20:40:48.255Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/transactions/tx/{hash}:
    get:
      tags:
        - "Chain"
      summary: "Transaction details"
      operationId: "getTransaction"
      x-price: "$0.01"
      parameters:
        - name: "hash"
          in: "path"
          required: true
          description: "Transaction or cast hash"
          schema:
            type: "string"
          example: "0xabc123def456789012345678901234567890abcd"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain network (ethereum, base, polygon, etc)"
          example: "ethereum"
      responses:
        "200":
          description: "Transaction"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/transactions/tx/0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060 not found"
                timestamp: "2026-02-18T20:44:08.577Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/transactions/tx/{hash}/receipt:
    get:
      tags:
        - "Chain"
      summary: "Transaction receipt"
      operationId: "getTxReceipt"
      x-price: "$0.01"
      parameters:
        - name: "hash"
          in: "path"
          required: true
          description: "Transaction or cast hash"
          schema:
            type: "string"
          example: "0xabc123def456789012345678901234567890abcd"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
          description: "Blockchain network (ethereum, base, polygon, etc)"
          example: "ethereum"
      responses:
        "200":
          description: "Receipt"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/transactions/tx/0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060/receipt not found"
                timestamp: "2026-02-18T20:44:08.622Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/transactions/{address}:
    get:
      tags:
        - "Utilities"
      summary: "Recent transaction history"
      operationId: "getapiTransactions"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                transactions:
                  - hash: "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
                    from: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                    to: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
                    value: "1000000000000000000"
                    valueETH: 1
                    valueUSD: 3245.67
                    gasUsed: "21000"
                    gasPrice: "50000000000"
                    timestamp: 1707393600
                    blockNumber: 19234567
                    status: "success"
                    type: "transfer"
                count: 1
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/transfers/{address}:
    get:
      tags:
        - "Wallet"
      summary: "ERC20 token transfer history"
      operationId: "getapiTransfers"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/transfers/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 not found"
                timestamp: "2026-02-18T16:23:33.203Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/treasury/{protocol}:
    get:
      tags:
        - "DeFi"
      summary: "Protocol treasury"
      operationId: "getapiTreasury"
      x-price: "$0.01"
      parameters:
        - name: "protocol"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Protocol slug"
          example: "aave"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/treasury/aave not found"
                timestamp: "2026-02-18T18:31:48.052Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/trending:
    get:
      tags:
        - "Prices"
      summary: "Trending ENS registrations and transfers"
      operationId: "getapiTrending"
      x-price: "$0.02"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                tokens:
                  - symbol: "ETH"
                    name: "Ethereum"
                    price: 3245.67
                    change24h: 5.67
                    trendScore: 98
                  - symbol: "BTC"
                    name: "Bitcoin"
                    price: 65432.1
                    change24h: 3.45
                    trendScore: 96
                  - symbol: "SOL"
                    name: "Solana"
                    price: 123.45
                    change24h: 12.34
                    trendScore: 92
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/trending/categories:
    get:
      tags:
        - "Prices"
      summary: "Trending categories"
      operationId: "getTrendingCategories"
      x-price: "$0.01"
      responses:
        "200":
          description: "Categories"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/trending/coins:
    get:
      tags:
        - "Prices"
      summary: "Trending coins (CoinGecko)"
      operationId: "getapiTrendingCoins"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/trending/gainers:
    get:
      tags:
        - "Prices"
      summary: "Top gainers"
      operationId: "getTrendingGainers"
      x-price: "$0.01"
      responses:
        "200":
          description: "Gainers"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/trending/losers:
    get:
      tags:
        - "Prices"
      summary: "Top losers"
      operationId: "getTrendingLosers"
      x-price: "$0.01"
      responses:
        "200":
          description: "Losers"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/trending/nfts:
    get:
      tags:
        - "NFT"
      summary: "Trending NFTs"
      operationId: "getTrendingNfts"
      x-price: "$0.01"
      responses:
        "200":
          description: "NFTs"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "CryptoPunks"
                symbol: "PUNK"
                totalSupply: 10000
                floorPrice: 45.67
                volume24h: 234.56
                owners: 3456
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/trending/tokens:
    get:
      tags:
        - "Prices"
      summary: "Trending tokens"
      operationId: "getapiTrendingTokens"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/trending/volume:
    get:
      tags:
        - "Prices"
      summary: "Volume leaders"
      operationId: "getTrendingVolume"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tvl/categories:
    get:
      tags:
        - "DeFi"
      summary: "All categories TVL"
      operationId: "getAllCategoriesTvl"
      x-price: "$0.01"
      responses:
        "200":
          description: "Categories"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/category/{category}:
    get:
      tags:
        - "DeFi"
      summary: "Category TVL"
      operationId: "getCategoryTvl"
      x-price: "$0.01"
      parameters:
        - name: "category"
          in: "path"
          required: true
          description: "Category filter"
          schema:
            type: "string"
          example: "defi"
      responses:
        "200":
          description: "Category TVL"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/chain/{name}:
    get:
      tags:
        - "Utilities"
      summary: "Chain TVL breakdown"
      operationId: "getapiTvlChain"
      x-price: "$0.01"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "ENS name or identifier"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tvl/l2/comparison:
    get:
      tags:
        - "L2"
      summary: "L2 TVL comparison"
      operationId: "getL2TvlComparison"
      x-price: "$0.02"
      responses:
        "200":
          description: "L2 comparison"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nLayer 2 network stats and TVL"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/ranking:
    get:
      tags:
        - "DeFi"
      summary: "TVL ranking"
      operationId: "getTvlRanking"
      x-price: "$0.02"
      responses:
        "200":
          description: "Ranking"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/top:
    get:
      tags:
        - "Utilities"
      summary: "Top TVL protocols"
      operationId: "getapiTvlTop"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ProtocolTVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tvl/all-chains:
    get:
      tags:
        - "DeFi"
      summary: "All chains TVL"
      operationId: "getAllChainsTvl"
      x-price: "$0.02"
      responses:
        "200":
          description: "All chains"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tvl/category/bridge:
    get:
      tags:
        - "DeFi"
      summary: "Bridge category TVL"
      operationId: "getBridgeTvl"
      x-price: "$0.01"
      responses:
        "200":
          description: "Bridge TVL"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tvl/category/cdp:
    get:
      tags:
        - "DeFi"
      summary: "CDP category TVL"
      operationId: "getCdpTvl"
      x-price: "$0.01"
      responses:
        "200":
          description: "CDP TVL"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tvl/category/derivatives:
    get:
      tags:
        - "DeFi"
      summary: "Derivatives category TVL"
      operationId: "getDerivativesTvl"
      x-price: "$0.01"
      responses:
        "200":
          description: "Derivatives TVL"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tvl/category/dex:
    get:
      tags:
        - "DeFi"
      summary: "DEX category TVL"
      operationId: "getDexTvl"
      x-price: "$0.01"
      responses:
        "200":
          description: "DEX TVL"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tvl/category/lending:
    get:
      tags:
        - "DeFi"
      summary: "Lending category TVL"
      operationId: "getLendingTvl"
      x-price: "$0.01"
      responses:
        "200":
          description: "Lending TVL"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tvl/category/liquid-staking:
    get:
      tags:
        - "DeFi"
      summary: "Liquid staking TVL"
      operationId: "getLiquidStakingTvl"
      x-price: "$0.01"
      responses:
        "200":
          description: "LS TVL"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tvl/category/yield:
    get:
      tags:
        - "DeFi"
      summary: "Yield category TVL"
      operationId: "getYieldTvl"
      x-price: "$0.01"
      responses:
        "200":
          description: "Yield TVL"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tvl/global:
    get:
      tags:
        - "DeFi"
      summary: "Global TVL"
      operationId: "getGlobalTvl"
      x-price: "$0.01"
      responses:
        "200":
          description: "Global TVL"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tvl/global/history:
    get:
      tags:
        - "DeFi"
      summary: "Global TVL history"
      operationId: "getGlobalTvlHistory"
      x-price: "$0.02"
      responses:
        "200":
          description: "History"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tvl/history/{protocol}:
    get:
      tags:
        - "DeFi"
      summary: "Protocol TVL history"
      operationId: "getProtocolTvlHistoryApi"
      x-price: "$0.01"
      parameters:
        - name: "protocol"
          in: "path"
          required: true
          description: "DeFi protocol identifier"
          schema:
            type: "string"
          example: "aave"
      responses:
        "200":
          description: "History"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tvl/snapshot/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "Chain TVL snapshot"
      operationId: "getTvlSnapshot"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Snapshot"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TVL"
              example:
                name: "Aave"
                slug: "aave"
                tvl: 27800000000
                change24h: 2.5
                change7d: 8.3
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                  - "avalanche"
                category: "Lending"
                description: "Decentralized lending protocol"
                url: "https://aave.com"
                twitter: "@AaveAave"
                audit: true
                auditLinks:
                  - "https://aave.com/security"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/tx/{hash}:
    get:
      tags:
        - "Chain"
      summary: "Transaction details"
      operationId: "getapiTx"
      x-price: "$0.01"
      parameters:
        - name: "hash"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Transaction or cast hash"
          example: "0xabc123def456789012345678901234567890abcd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                hash: "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060"
                chain: "ethereum"
                from: "0xa1e4380a3b1f749673e270229993ee55f35663b4"
                to: "0x5df9b87991262f6ba471f09758cde1c0fc1de734"
                value: "3.1337e-14"
                gasPrice: "50000.00 gwei"
                gasUsed: 21000
                blockNumber: 46147
                status: "success"
                nonce: 0
                timestamp: "2026-02-18T16:23:33.128Z"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/txs/{address}:
    get:
      tags:
        - "Wallet"
      summary: "Recent transaction history"
      operationId: "getapiTxs"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/txs/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 not found"
                timestamp: "2026-02-18T16:23:33.167Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/unlocks:
    get:
      tags:
        - "DeFi"
      summary: "Token unlock schedule"
      operationId: "getapiUnlocks"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                results: []
                total: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/usage:
    get:
      tags:
        - "Free"
      summary: "Your API usage"
      operationId: "getUsage"
      responses:
        "200":
          description: "Your API usage stats"
          content:
            application/json:
              example:
                used: 27
                limit: 100
                remaining: 73
                tier: "anonymous"
                resetsAt: "2026-02-09T00:00:00.000Z"
              schema:
                type: "object"
                properties:
                  requestsToday:
                    type: "number"
                  limit:
                    type: "number"
                  remaining:
                    type: "number"
                  tier:
                    type: "string"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
  /api/validators/ethereum:
    get:
      tags:
        - "Chain"
      summary: "Ethereum validators"
      operationId: "getapiValidatorsEthereum"
      x-price: "$0.01"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Not Found - Endpoint not implemented"
          content:
            application/json:
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/validators/ethereum not found"
                timestamp: "2026-02-18T18:31:48.169Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/verified/{address}:
    get:
      tags:
        - "Security"
      summary: "Check if contract is verified"
      operationId: "getapiVerified"
      x-price: "$0.001"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/verified/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 not found"
                timestamp: "2026-02-18T16:23:33.245Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/verify-sig:
    post:
      tags:
        - "Security"
      summary: "Verify Ethereum signature"
      operationId: "postapiVerifysig"
      x-price: "$0.05"
      requestBody:
        required: true
        description: "Message, signature, and expected signer address"
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/VerifySignatureRequest"
            examples:
              valid:
                summary: "Valid signature verification"
                value:
                  message: "Sign this message to verify your wallet"
                  signature: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"
                  address: "0x701B4937e6c943789ffA74CC8601813b2D87B454"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Not Found - Endpoint not implemented"
          content:
            application/json:
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint POST /api/verify-sig not found"
                timestamp: "2026-02-18T19:51:01.614Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/arbitrum:
    get:
      tags:
        - "DeFi"
      summary: "Arbitrum volume"
      operationId: "getArbVolume"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/avalanche:
    get:
      tags:
        - "DeFi"
      summary: "Avalanche volume"
      operationId: "getAvaxVolumeShort"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/base:
    get:
      tags:
        - "DeFi"
      summary: "Base volume"
      operationId: "getBaseVol"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/bsc:
    get:
      tags:
        - "DeFi"
      summary: "BSC volume"
      operationId: "getBscVolumeShort"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/celo:
    get:
      tags:
        - "DeFi"
      summary: "Celo volume"
      operationId: "getCeloVolumeShort"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/cex-vs-dex:
    get:
      tags:
        - "DeFi"
      summary: "CEX vs DEX"
      operationId: "getCexVsDexVol"
      x-price: "$0.02"
      responses:
        "200":
          description: "Comparison"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/ethereum:
    get:
      tags:
        - "DeFi"
      summary: "Ethereum volume"
      operationId: "getEthVolume"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/exchange/volumes:
    get:
      tags:
        - "Prices"
      summary: "Exchange volumes"
      operationId: "getExchangeVolumes"
      x-price: "$0.02"
      responses:
        "200":
          description: "Volumes"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/fantom:
    get:
      tags:
        - "DeFi"
      summary: "Fantom volume"
      operationId: "getFtmVolumeShort"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/gnosis:
    get:
      tags:
        - "DeFi"
      summary: "Gnosis volume"
      operationId: "getGnosisVolumeShort"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/linea:
    get:
      tags:
        - "DeFi"
      summary: "Linea volume"
      operationId: "getLineaVolumeShort"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/mantle:
    get:
      tags:
        - "DeFi"
      summary: "Mantle volume"
      operationId: "getMantleVolumeShort"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/mode:
    get:
      tags:
        - "DeFi"
      summary: "Mode volume"
      operationId: "getModeVolumeShort"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/moonbeam:
    get:
      tags:
        - "DeFi"
      summary: "Moonbeam volume"
      operationId: "getMoonbeamVolumeShort"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/optimism:
    get:
      tags:
        - "DeFi"
      summary: "Optimism volume"
      operationId: "getOpVolumeShort"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment required - free tier exhausted"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequired"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/polygon:
    get:
      tags:
        - "DeFi"
      summary: "Polygon volume"
      operationId: "getPolyVolumeShort"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/scroll:
    get:
      tags:
        - "DeFi"
      summary: "Scroll volume"
      operationId: "getScrollVolumeShort"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/solana:
    get:
      tags:
        - "DeFi"
      summary: "Solana volume"
      operationId: "getSolVolumeShort"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/blast:
    get:
      tags:
        - "DeFi"
      summary: "Blast DEX volume"
      operationId: "getBlastVolume"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/global:
    get:
      tags:
        - "DeFi"
      summary: "Global DEX volume"
      operationId: "getGlobalVolume"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/top-dexes:
    get:
      tags:
        - "DeFi"
      summary: "Top DEXes by volume"
      operationId: "getTopDexesByVolume"
      x-price: "$0.01"
      responses:
        "200":
          description: "Top DEXes"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/zksync:
    get:
      tags:
        - "DeFi"
      summary: "zkSync DEX volume"
      operationId: "getZkSyncVolume"
      x-price: "$0.01"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/volume/volumes/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "Chain DEX volume"
      operationId: "getChainVolume"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Volume"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volumes/{chain}:
    get:
      tags:
        - "Utilities"
      summary: "Chain DEX volume"
      operationId: "getapiVolumes"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Chain name (ethereum, base, etc.)"
          example: "ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                volume24h: 45600000000
                change24h: 12.5
                volumeByChain:
                  ethereum: 23400000000
                  arbitrum: 8900000000
                  polygon: 6700000000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/wallet/age/{address}:
    get:
      tags:
        - "Wallet"
      summary: "Wallet age (first transaction date)"
      operationId: "getapiWalletAge"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Blockchain network"
          example: "ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/WalletOverview"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/wallet/balance/{address}:
    get:
      tags:
        - "Wallet"
      summary: "Multi-chain balance"
      operationId: "getWalletBalance"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x format)"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Blockchain network"
          example: "ethereum"
      responses:
        "200":
          description: "Balances"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Wallet"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      description: "Get ETH and token balances for address"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/wallet/checksum/{address}:
    get:
      tags:
        - "Wallet"
      summary: "Checksum address"
      operationId: "getapiWalletChecksum"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Blockchain network"
          example: "ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/WalletOverview"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/wallet/first-tx/{address}:
    get:
      tags:
        - "Wallet"
      summary: "Wallet first transaction date"
      operationId: "getapiWalletFirsttx"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Blockchain network"
          example: "ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/WalletOverview"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/wallet/nonce/{address}:
    get:
      tags:
        - "Wallet"
      summary: "Wallet transaction count (nonce)"
      operationId: "getapiWalletNonce"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Blockchain network"
          example: "ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/WalletOverview"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/wallet/pnl/{address}:
    get:
      tags:
        - "Wallet"
      summary: "Wallet profit/loss"
      operationId: "getapiWalletPnl"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Blockchain network"
          example: "ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/WalletOverview"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/wallet/validate/{address}:
    get:
      tags:
        - "Wallet"
      summary: "Validate address"
      operationId: "getapiWalletValidate"
      x-price: "$0.01"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Ethereum address (0x...)"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "chain"
          in: "query"
          schema:
            type: "string"
            default: "ethereum"
          description: "Blockchain network"
          example: "ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/WalletOverview"
              example:
                address: "0x1234567890abcdef1234567890abcdef12345678"
                balance: "12.456789"
                balanceUsd: 40567.89
                tokens:
                  - symbol: "ETH"
                    balance: "12.456789"
                    balanceUsd: 40567.89
                  - symbol: "USDC"
                    balance: "5000.00"
                    balanceUsd: 5000
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/whales/{token}:
    get:
      tags:
        - "Utilities"
      summary: "Token whale holders"
      operationId: "getapiWhales"
      x-price: "$0.02"
      parameters:
        - name: "token"
          in: "path"
          required: true
          schema:
            type: "string"
          description: "Token symbol or address"
          example: "ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/whales/eth not found"
                timestamp: "2026-02-18T18:31:48.209Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/aave:
    get:
      tags:
        - "DeFi"
      summary: "Aave yields"
      operationId: "getAaveYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Aave yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/btc:
    get:
      tags:
        - "DeFi"
      summary: "BTC asset yields"
      operationId: "getBtcAssetYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "BTC yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/chain/arbitrum:
    get:
      tags:
        - "DeFi"
      summary: "Arbitrum chain yields"
      operationId: "getArbChainYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/chain/base:
    get:
      tags:
        - "DeFi"
      summary: "Base chain yields"
      operationId: "getBaseChainYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/chain/ethereum:
    get:
      tags:
        - "DeFi"
      summary: "Ethereum chain yields"
      operationId: "getEthChainYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/chain/optimism:
    get:
      tags:
        - "DeFi"
      summary: "Optimism chain yields"
      operationId: "getOpChainYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/chain/polygon:
    get:
      tags:
        - "DeFi"
      summary: "Polygon chain yields"
      operationId: "getPolyChainYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/compound:
    get:
      tags:
        - "DeFi"
      summary: "Compound yields"
      operationId: "getCompoundYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Compound yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/convex:
    get:
      tags:
        - "DeFi"
      summary: "Convex yields"
      operationId: "getConvexYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Convex yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/curve:
    get:
      tags:
        - "DeFi"
      summary: "Curve yields"
      operationId: "getCurveYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Curve yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/eigenlayer:
    get:
      tags:
        - "DeFi"
      summary: "EigenLayer yields"
      operationId: "getEigenLayerYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "EigenLayer yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/eth:
    get:
      tags:
        - "DeFi"
      summary: "ETH asset yields"
      operationId: "getEthAssetYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "ETH yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/high-apy:
    get:
      tags:
        - "DeFi"
      summary: "High APY yields"
      operationId: "getHighApyYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "High APY"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/lido:
    get:
      tags:
        - "DeFi"
      summary: "Lido yields"
      operationId: "getLidoYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Lido yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/median/{chain}:
    get:
      tags:
        - "DeFi"
      summary: "Median yield by chain"
      operationId: "getMedianYield"
      x-price: "$0.01"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Blockchain network (ethereum, base, polygon, etc)"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Median"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/pendle:
    get:
      tags:
        - "DeFi"
      summary: "Pendle yields"
      operationId: "getPendleYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Pendle yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/pool/{uuid}:
    get:
      tags:
        - "DeFi"
      summary: "Pool by UUID"
      operationId: "getPoolByUuid"
      x-price: "$0.01"
      parameters:
        - name: "uuid"
          in: "path"
          required: true
          description: "Universally unique identifier"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Pool data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/project/{name}:
    get:
      tags:
        - "DeFi"
      summary: "Yields by project"
      operationId: "getYieldsByProject"
      x-price: "$0.01"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name (e.g., vitalik.eth)"
          schema:
            type: "string"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Project yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Resource not found"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/stables:
    get:
      tags:
        - "DeFi"
      summary: "Stablecoin yields"
      operationId: "getStablesYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Stable yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/top:
    get:
      tags:
        - "DeFi"
      summary: "Top yields by TVL"
      operationId: "getTopYieldsByTvl"
      x-price: "$0.01"
      responses:
        "200":
          description: "Top yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/yearn:
    get:
      tags:
        - "DeFi"
      summary: "Yearn yields"
      operationId: "getYearnYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Yearn yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
      deprecated: true
      x-implemented: false
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n"
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/chain/avalanche:
    get:
      tags:
        - "DeFi"
      summary: "Avalanche yields"
      operationId: "getAvalancheYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Avalanche yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/chain/bsc:
    get:
      tags:
        - "DeFi"
      summary: "BSC yields"
      operationId: "getBscYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "BSC yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/chain/solana:
    get:
      tags:
        - "DeFi"
      summary: "Solana yields"
      operationId: "getSolanaYields"
      x-price: "$0.01"
      responses:
        "200":
          description: "Solana yields"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                chain: "Ethereum"
                chainId: 1
                tvl: 89500000000
                protocols: 457
                users24h: 456789
                transactions24h: 1234567
                gasPrice: 25.5
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/yields/search:
    get:
      tags:
        - "DeFi"
      summary: "Search yields"
      operationId: "searchYields"
      x-price: "$0.01"
      parameters:
        - name: "q"
          in: "query"
          required: true
          description: "Search query string"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Results"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/YieldPool"
              example:
                pool: "0x1234567890123456789012345678901234565678"
                project: "Aave"
                symbol: "aDAI"
                chain: "Ethereum"
                tvlUsd: 1234567890
                apy: 4.56
                apyBase: 2.34
                apyReward: 2.22
                il7d: 0
        "400":
          description: "Bad request - invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error - Something went wrong on our end"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: "Internal server error"
                code: "INTERNAL_ERROR"
      security:
        - {}
        - ApiKeyAuth: []
        - X402Payment: []
  /api/agent:
    get:
      tags:
        - "Agent"
      summary: "Discover registered agents"
      operationId: "listAgents"
      description: "List all registered AI agent identities with optional filtering by capability"
      parameters:
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
            default: 50
            maximum: 100
          description: "Maximum number of agents to return (1-100)"
          example: 10
        - name: "offset"
          in: "query"
          schema:
            type: "integer"
            default: 0
          description: "Pagination offset"
          example: "example_value"
        - name: "capability"
          in: "query"
          schema:
            type: "string"
          description: "Filter by capability (x402-payments, siwe-auth, xmtp-messaging, ens-resolution)"
          example: "example"
      responses:
        "200":
          description: "List of agent identities with pagination"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AgentIdentityList"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited - Too many requests"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
  /api/agent/schema:
    get:
      tags:
        - "Agent"
      summary: "Agent identity JSON schema"
      operationId: "getAgentSchema"
      description: "Returns JSON Schema definition for agent identity structure (draft-07)"
      responses:
        "200":
          description: "JSON Schema for agent identity format"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/JsonSchema"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited - Too many requests"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
  /api/agent/register:
    post:
      tags:
        - "Agent"
      summary: "Register agent identity"
      operationId: "registerAgent"
      description: "Register new agent identity on aboutme.eth (requires x402 payment).\n\n**Pricing:**\n- 5+ chars: $0.97\n- 4 chars: $4.97\n- 3 chars: $19.97\n- 1-2 chars: $97.00\n\nPayment via x402 protocol (USDC on Base network).\n"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: "object"
              required:
                - "name"
                - "owner"
              properties:
                name:
                  type: "string"
                  description: "Agent name (3-63 alphanumeric chars, auto-appends .aboutme.eth)"
                  example: "myagent"
                owner:
                  type: "string"
                  description: "Ethereum address that will own this agent identity"
                  pattern: "^0x[a-fA-F0-9]{40}$"
                  example: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                capabilities:
                  type: "array"
                  items:
                    type: "string"
                    enum:
                      - "xmtp"
                  description: "Optional capabilities to enable (x402, siwe, ens are default)"
                profile:
                  type: "object"
                  description: "Optional profile metadata"
                  properties:
                    description:
                      type: "string"
                      example: "AI agent for Web3 identity verification"
                    url:
                      type: "string"
                      format: "uri"
                      example: "https://atv.eth.limo"
                    avatar:
                      type: "string"
                      format: "uri"
                      example: "https://atv.eth.limo/avatar.jpg"
                    twitter:
                      type: "string"
                      example: "ATV_eth"
                    github:
                      type: "string"
                      example: "ATV-eth"
      responses:
        "200":
          description: "Agent registered successfully"
          content:
            application/json:
              schema:
                allOf:
                  - type: "object"
                    properties:
                      success:
                        type: "boolean"
                        example: true
                      message:
                        type: "string"
                        example: "Agent identity myagent.aboutme.eth registered successfully"
                  - $ref: "#/components/schemas/AgentIdentity"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "402":
          description: "Payment Required - x402 micropayment needed"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate Limited - Too many requests"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
  /api/agent/verify/{address}:
    get:
      tags:
        - "Agent"
      summary: "Verify agent ownership"
      operationId: "verifyAgent"
      description: "Check if an Ethereum address owns any agent identities on aboutme.eth"
      parameters:
        - name: "address"
          in: "path"
          required: true
          schema:
            type: "string"
            pattern: "^0x[a-fA-F0-9]{40}$"
          description: "Ethereum address to verify"
          example: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
      responses:
        "200":
          description: "Verification result with list of owned identities"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AgentVerification"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate Limited - Too many requests"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
  /api/agent/{name}:
    get:
      tags:
        - "Agent"
      summary: "Get agent identity"
      operationId: "getAgent"
      description: "Retrieve full agent identity profile including capabilities, endpoints, and metadata"
      parameters:
        - name: "name"
          in: "path"
          required: true
          schema:
            type: "string"
            pattern: "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
          description: "Agent name without .aboutme.eth suffix (e.g., \"atv\" for atv.aboutme.eth)"
          example: "atv"
      responses:
        "200":
          description: "Full agent identity profile"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AgentIdentity"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "404":
          description: "Not found"
        "429":
          description: "Rate Limited - Too many requests"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
  /api/auth/2fa/settings:
    put:
      tags:
        - "TwoFactor"
      summary: "Settings"
      operationId: "put_api_2fa_settings"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Settings. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/2fa/totp/setup:
    post:
      tags:
        - "TwoFactor"
      summary: "Setup"
      operationId: "post_api_2fa_totp_setup"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Setup. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/2fa/totp/verify:
    post:
      tags:
        - "TwoFactor"
      summary: "Verify"
      operationId: "post_api_2fa_totp_verify"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                token: "EXAMPLE_SESSION_TOKEN_12345"
                expiresIn: 3600
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Verify. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/2fa/totp:
    delete:
      tags:
        - "TwoFactor"
      summary: "Totp"
      operationId: "delete_api_2fa_totp"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Totp. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/2fa/passkey/register/start:
    post:
      tags:
        - "TwoFactor"
      summary: "Start"
      operationId: "post_api_2fa_passkey_register_start"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Start. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/2fa/passkey/register/complete:
    post:
      tags:
        - "TwoFactor"
      summary: "Complete"
      operationId: "post_api_2fa_passkey_register_complete"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Complete. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/2fa/passkeys:
    get:
      tags:
        - "TwoFactor"
      summary: "Passkeys"
      operationId: "get_api_2fa_passkeys"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Passkeys. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/2fa/passkey/{id}:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    put:
      tags:
        - "TwoFactor"
      summary: "Passkey"
      operationId: "put_api_2fa_passkey_id_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Passkey. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/2fa/verify/passkey/start:
    post:
      tags:
        - "TwoFactor"
      summary: "Start"
      operationId: "post_api_2fa_verify_passkey_start"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Start. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/2fa/verify/passkey/complete:
    post:
      tags:
        - "TwoFactor"
      summary: "Complete"
      operationId: "post_api_2fa_verify_passkey_complete"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Complete. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/2fa/recovery/regenerate:
    post:
      tags:
        - "TwoFactor"
      summary: "Regenerate"
      operationId: "post_api_2fa_recovery_regenerate"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Regenerate. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/2fa/recovery/count:
    get:
      tags:
        - "TwoFactor"
      summary: "Count"
      operationId: "get_api_2fa_recovery_count"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Count. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/2fa/disable:
    post:
      tags:
        - "TwoFactor"
      summary: "Disable"
      operationId: "post_api_2fa_disable"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Disable. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /ccip:
    post:
      tags:
        - "Other"
      summary: "Other"
      operationId: "post_ccip_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Other.  Free tier: 100 calls/day."
  /api:
    post:
      tags:
        - "Other"
      summary: "Other"
      operationId: "post_api_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Other.  Free tier: 100 calls/day."
  /api/aave/markets:
    get:
      tags:
        - "Aave"
      summary: "Markets"
      operationId: "get_api_aave_markets"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Markets.  Free tier: 100 calls/day."
  /api/admin:
    get:
      tags:
        - "Admin"
      summary: "Admin"
      operationId: "get_api_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Endpoint not implemented"
          content:
            application/json:
              example:
                error: true
                code: "NOT_FOUND"
                message: "Endpoint GET /api/admin not found"
                timestamp: "2026-02-18T16:14:06.707Z"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Admin. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/version:
    get:
      tags:
        - "Admin"
      summary: "Version"
      operationId: "get_api_version"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                version: "2.9.0"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Version. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/agent-info:
    get:
      tags:
        - "Admin"
      summary: "Agent-info"
      operationId: "get_api_agent_info"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Web3 Identity API & x402 via ATV.eth"
                version: "2.9.0"
                description: "Premium Web3 Identity & DeFi Data API with x402 micropayments"
                operator: "Agent Trust Vector (ATV)"
                wallet: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                authentication:
                  methods:
                    - "anonymous"
                    - "siwe"
                    - "apikey"
                    - "x402"
                  anonymous:
                    rateLimit: "100 requests/day"
                    description: "No authentication required"
                  siwe:
                    rateLimit: "200 requests/day"
                    description: "Sign-In with Ethereum (ERC-4361)"
                    endpoint: "/api/auth/nonce"
                  apikey:
                    rateLimit: "250 requests/day"
                    description: "API key authentication"
                    endpoint: "/api/user/keys"
                  x402:
                    rateLimit: "Unlimited"
                    description: "Pay-per-call with x402 micropayments (USDC on Base)"
                    protocol: "https://github.com/coinbase/x402"
                    facilitator: "https://api.cdp.coinbase.com/platform/v2/x402"
                    network: "base"
                    paymentToken: "USDC"
                payment:
                  enabled: true
                  protocol: "x402 (EIP-712 micropayments)"
                  network: "Base (Chain ID 8453)"
                  token: "USDC"
                  facilitator: "Coinbase Developer Platform"
                  paidEndpoints: 19
                  pricing:
                    standard: "$0.001-0.08 per call"
                    freeTier: "100 calls/day"
                    tiers:
                      - "Anonymous (100/day)"
                      - "SIWE (200/day)"
                      - "API Key (250/day)"
                      - "x402 (Unlimited)"
                endpoints:
                  total: 1575
                  categories:
                    - "ENS"
                    - "DeFi"
                    - "NFT"
                    - "Social"
                    - "Blockchain"
                    - "Price"
                    - "Token"
                    - "Gas"
                    - "Bridge"
                    - "DEX"
                  documentation: "/docs"
                  openapi: "/openapi.json"
                support:
                  docs: "https://docs.web3identity.com"
                  status: "https://status.web3identity.com"
                  email: "atv@web3domains.com"
                  twitter: "@ATV_eth"
                standards:
                  erc4361: "Sign-In with Ethereum"
                  erc3668: "CCIP-Read offchain data gateway"
                  erc8004: "Agent identity registration (Base + Mainnet)"
                timestamp: "2026-02-18T16:14:06.749Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Agent-info. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/health:
    get:
      tags:
        - "Free"
        - "Admin"
      summary: "API health status"
      description: "Returns comprehensive API health status including uptime, memory usage, cache status, and endpoint verification.\n\n**Always Free** - No rate limit, no payment required.\n"
      operationId: "getApiHealth"
      responses:
        "200":
          description: "API health status"
          content:
            application/json:
              schema:
                type: "object"
                required:
                  - "status"
                  - "version"
                  - "endpoints"
                  - "timestamp"
                properties:
                  status:
                    type: "string"
                    enum:
                      - "healthy"
                      - "degraded"
                      - "unhealthy"
                    description: "Overall API health status"
                  version:
                    type: "string"
                    description: "API version"
                    example: "2.9.0"
                  endpoints:
                    type: "number"
                    description: "Number of documented endpoints"
                    example: 1597
                  verification:
                    type: "object"
                    description: "Endpoint verification results"
                    properties:
                      verified_at:
                        type: "string"
                        format: "date-time"
                      total_documented:
                        type: "integer"
                      total_working:
                        type: "integer"
                      success_rate:
                        type: "string"
                  payment:
                    type: "string"
                    enum:
                      - "enabled"
                      - "disabled"
                    description: "x402 payment status"
                  requestsToday:
                    type: "number"
                    description: "Total API requests today"
                  avgResponseTime:
                    type: "number"
                    description: "Average response time in ms"
                  successRate:
                    type: "number"
                    description: "Success rate percentage"
                  uniqueUsers:
                    type: "number"
                    description: "Unique users today"
                  cache:
                    type: "object"
                    description: "Redis cache status"
                    properties:
                      connected:
                        type: "boolean"
                      keys:
                        type: "integer"
                      memory:
                        type: "string"
                  uptime:
                    type: "number"
                    description: "Server uptime in seconds"
                  memory:
                    type: "string"
                    description: "Node.js memory usage"
                  timestamp:
                    type: "string"
                    format: "date-time"
                    description: "Response timestamp"
              example:
                status: "healthy"
                version: "2.9.0"
                endpoints: 1597
                verification:
                  verified_at: "2026-02-17T04:00:31.878Z"
                  total_documented: 1597
                  total_working: 1597
                  success_rate: "100%"
                payment: "enabled"
                requestsToday: 714
                avgResponseTime: 42
                successRate: 76.3
                uniqueUsers: 8
                cache:
                  connected: true
                  keys: 1
                  memory: "999.96K"
                uptime: 7929
                memory: "70MB"
                timestamp: "2026-02-17T23:53:54.711Z"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
  /api/health/sources:
    get:
      tags:
        - "Admin"
      summary: "Sources"
      operationId: "get_api_health_sources"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                message: "Health monitor not initialized"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Sources. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/health/check:
    get:
      tags:
        - "Admin"
      summary: "Check"
      operationId: "get_api_health_check"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                checked: "2026-02-18T16:28:32.225Z"
                results: {}
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Check. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/health/alerts:
    get:
      tags:
        - "Admin"
      summary: "Alerts"
      operationId: "get_api_health_alerts"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                alerts: []
                count: 0
                timestamp: "2026-02-18T16:28:32.187Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Alerts. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/bazaar/status:
    get:
      tags:
        - "Admin"
      summary: "Status"
      operationId: "get_api_bazaar_status"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "pending"
                ourEndpoints: 0
                totalBazaarResources: 12498
                schemasConfigured: 24
                endpointsSeeded: 16
                checkedAt: "2026-02-18T16:33:18.197Z"
                ourResources: []
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Status. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/health/metrics:
    get:
      tags:
        - "Admin"
      summary: "Metrics"
      operationId: "get_api_health_metrics"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                metrics:
                  totalRequests: 0
                  totalErrors: 0
                  avgLatencyMs: 0
                  requestsPerMinute: 0
                  errorsPerMinute: 0
                  errorRate: "0%"
                timestamp: "2026-02-18T16:28:32.267Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Metrics. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/cache/stats:
    get:
      tags:
        - "Admin"
      summary: "Stats"
      operationId: "get_api_cache_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                requestsToday: 15420
                uniqueUsers: 342
                avgResponseTime: 45
                errorRate: 0.02
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Stats. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/cache/clear:
    post:
      tags:
        - "Admin"
      summary: "Clear"
      operationId: "post_api_cache_clear"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request"
        "401":
          description: "Unauthorized - Authentication required"
          content:
            application/json:
              example:
                error: true
                code: "UNAUTHORIZED"
                message: "Authentication required. Please sign in with SIWE."
                timestamp: "2026-02-18T19:51:01.495Z"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Clear. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/cache/reset-stats:
    post:
      tags:
        - "Admin"
      summary: "Reset-stats"
      operationId: "post_api_cache_reset_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request"
        "401":
          description: "Unauthorized - Authentication required"
          content:
            application/json:
              example:
                error: true
                code: "UNAUTHORIZED"
                message: "Authentication required. Please sign in with SIWE."
                timestamp: "2026-02-18T19:51:01.533Z"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Reset-stats. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/sources/stats:
    get:
      tags:
        - "Admin"
      summary: "Stats"
      operationId: "get_api_sources_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                requestsToday: 15420
                uniqueUsers: 342
                avgResponseTime: 45
                errorRate: 0.02
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Stats. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/sources/health:
    get:
      tags:
        - "Admin"
      summary: "Health"
      operationId: "get_api_sources_health"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                healthy: 19
                total: 22
                percentage: "86.4%"
                sources:
                  defillama:
                    name: "DefiLlama"
                    healthy: true
                    demoted: false
                    requestCount: 3
                    errorCount: 2
                    avgLatencyMs: 325
                    rateLimitHits: 6
                    lastError: "HTTP 400"
                    cost: 0
                  defillama_coins:
                    name: "DefiLlama Coins"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 235
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                  defillama_yields:
                    name: "DefiLlama Yields"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 105
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                  defillama_stables:
                    name: "DefiLlama Stablecoins"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 65
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                  coingecko:
                    name: "CoinGecko"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 91
                    rateLimitHits: 334
                    lastError: "HTTP 404"
                    cost: 0
                  coinpaprika:
                    name: "CoinPaprika"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 135
                    rateLimitHits: 0
                    lastError: "HTTP 404"
                    cost: 0
                  coincap:
                    name: "CoinCap"
                    healthy: false
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 0
                    rateLimitHits: 0
                    lastError: "fetch failed"
                    cost: 0
                  messari:
                    name: "Messari"
                    healthy: false
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 0
                    rateLimitHits: 0
                    lastError: "Health check failed"
                    cost: 0
                  blockchain_info:
                    name: "Blockchain.info"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 307
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                  alternative_me:
                    name: "Alternative.me"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 94
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                  coinlore:
                    name: "CoinLore"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 0
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                  kraken:
                    name: "Kraken"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 0
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                  okx:
                    name: "OKX"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 0
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                  cryptocompare:
                    name: "CryptoCompare"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 0
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                  l2beat:
                    name: "L2Beat"
                    healthy: false
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 0
                    rateLimitHits: 0
                    lastError: "HTTP 404"
                    cost: 0
                  neynar:
                    name: "Neynar"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 0
                    rateLimitHits: 0
                    lastError: null
                    cost: 9
                  alchemy:
                    name: "Alchemy"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 0
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                  etherscan:
                    name: "Etherscan"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 0
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                  publicnode_eth:
                    name: "PublicNode ETH"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 0
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                  publicnode_base:
                    name: "PublicNode Base"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 0
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                  publicnode_arb:
                    name: "PublicNode Arbitrum"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 0
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                  publicnode_op:
                    name: "PublicNode Optimism"
                    healthy: true
                    demoted: false
                    requestCount: 0
                    errorCount: 0
                    avgLatencyMs: 0
                    rateLimitHits: 0
                    lastError: null
                    cost: 0
                timestamp: "2026-02-18T16:42:58.547Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Health. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/sources/fallbacks:
    get:
      tags:
        - "Admin"
      summary: "Fallbacks"
      operationId: "get_api_sources_fallbacks"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example: {}
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Fallbacks. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/sources/costs:
    get:
      tags:
        - "Admin"
      summary: "Costs"
      operationId: "get_api_sources_costs"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example: {}
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Costs. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/sources/ranked/{dataType}:
    parameters:
      - name: "dataType"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The dataType parameter"
    get:
      tags:
        - "Admin"
      summary: "Ranked"
      operationId: "getRankedSources"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                dataType: "price"
                sources:
                  - "coingecko"
                  - "coinpaprika"
                  - "defillama_coins"
                  - "coinlore"
                  - "kraken"
                  - "okx"
                  - "cryptocompare"
                timestamp: "2026-02-18T16:42:58.583Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Ranked. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/sources/demotions:
    get:
      tags:
        - "Admin"
      summary: "Demotions"
      operationId: "get_api_sources_demotions"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                demoted: []
                count: 0
                timestamp: "2026-02-18T16:42:58.472Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Demotions. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/sources/restore/{sourceKey}:
    parameters:
      - name: "sourceKey"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The sourceKey parameter"
    post:
      tags:
        - "Admin"
      summary: "Restore"
      operationId: "restoreSource"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request"
        "401":
          description: "Unauthorized - Authentication required"
          content:
            application/json:
              example:
                error: true
                code: "UNAUTHORIZED"
                message: "Authentication required. Please sign in with SIWE."
                timestamp: "2026-02-18T19:51:01.574Z"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Restore. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/dashboard/sources:
    get:
      tags:
        - "Admin"
      summary: "Sources"
      operationId: "get_api_dashboard_sources"
      responses:
        "200":
          description: "HTML dashboard page showing source health and cost breakdown"
          content:
            text/html:
              example: "<!DOCTYPE html>\n<html>\n<head>\n  <title>x402 Source Dashboard</title>\n  <meta http-equiv=\"refresh\" content=\"30\">\n  <style>\n    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; margin: 20px; background: #0d1117; color: #c9d1d9; }\n    h1 { color: #58a6ff; }\n    h2 { color: #8b949e; border-bottom: 1px solid #30363d; padding-bottom: 8px; }\n    .card { background: #161b22; border: 1px solid #30363d; border-radius: 6px; padding: 16px; margin: 10px 0; }\n    .healthy..."
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Sources. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/analytics/endpoints:
    get:
      tags:
        - "Admin"
      summary: "Endpoints"
      operationId: "get_api_analytics_endpoints"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                endpoints:
                  - path: "/stats/endpoints"
                    requests: 83
                    paid: 0
                    avgTime: 12
                    errorRate: 0
                  - path: "/ens/reverse/:address"
                    requests: 67
                    paid: 0
                    avgTime: 1
                    errorRate: 0
                  - path: "/log"
                    requests: 49
                    paid: 0
                    avgTime: 3
                    errorRate: 2
                  - path: "/gas/ethereum"
                    requests: 46
                    paid: 0
                    avgTime: 104
                    errorRate: 0
                  - path: "/api/nft/:address/1"
                    requests: 45
                    paid: 0
                    avgTime: 2
                    errorRate: 100
                  - path: "/balance/:address"
                    requests: 44
                    paid: 0
                    avgTime: 74
                    errorRate: 0
                  - path: "/farcaster/dwr"
                    requests: 43
                    paid: 0
                    avgTime: 60
                    errorRate: 0
                  - path: "/price/ethereum"
                    requests: 42
                    paid: 0
                    avgTime: 1
                    errorRate: 100
                  - path: "/defi/tvl/aave"
                    requests: 42
                    paid: 0
                    avgTime: 1
                    errorRate: 100
                  - path: "/ens/resolve/:name.eth"
                    requests: 36
                    paid: 0
                    avgTime: 1
                    errorRate: 0
                  - path: "/lens/profile/stani"
                    requests: 35
                    paid: 0
                    avgTime: 1
                    errorRate: 0
                  - path: "/dashboard-summary"
                    requests: 26
                    paid: 0
                    avgTime: 11
                    errorRate: 0
                  - path: "/bazaar/status"
                    requests: 25
                    paid: 0
                    avgTime: 235
                    errorRate: 4
                  - path: "/resolve/:name.eth"
                    requests: 22
                    paid: 0
                    avgTime: 149
                    errorRate: 0
                  - path: "/reverse/:address"
                    requests: 20
                    paid: 0
                    avgTime: 494
                    errorRate: 0
                  - path: "/sessions"
                    requests: 18
                    paid: 0
                    avgTime: 1
                    errorRate: 100
                  - path: "/batch-resolve"
                    requests: 15
                    paid: 0
                    avgTime: 62
                    errorRate: 80
                  - path: "/lending/iron-bank"
                    requests: 13
                    paid: 0
                    avgTime: 1
                    errorRate: 100
                  - path: "/:name.eth"
                    requests: 12
                    paid: 0
                    avgTime: 10
                    errorRate: 0
                  - path: "/movers/1h"
                    requests: 11
                    paid: 0
                    avgTime: 71
                    errorRate: 100
                period: "24h"
                timestamp: "2026-02-18T16:14:06.996Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Endpoints. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/analytics/slow:
    get:
      tags:
        - "Admin"
      summary: "Slow"
      operationId: "get_api_analytics_slow"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                threshold: 100
                endpoints:
                  - path: "/api/lookup/vitalik.eth"
                    avgLatency: 3374
                    requests: 1
                  - path: "/api/records/vitalik.eth"
                    avgLatency: 3095
                    requests: 1
                  - path: "/api/lookup/atv.eth"
                    avgLatency: 2719
                    requests: 1
                  - path: "/api/records/brandonhurt.eth"
                    avgLatency: 2573
                    requests: 1
                  - path: "/api/records/brandonh.eth"
                    avgLatency: 2524
                    requests: 1
                  - path: "/api/records/atv.eth"
                    avgLatency: 2483
                    requests: 1
                  - path: "/api/"
                    avgLatency: 2171
                    requests: 1
                  - path: "/api/revenue"
                    avgLatency: 2046
                    requests: 1
                  - path: "/api/compare/top"
                    avgLatency: 1288
                    requests: 1
                  - path: "/api/arbitrum"
                    avgLatency: 1149
                    requests: 1
                  - path: "/api/0x0000000000000000000000000000000000000000"
                    avgLatency: 1071
                    requests: 1
                  - path: "/api/stablecoins"
                    avgLatency: 775
                    requests: 1
                  - path: "/api/activity"
                    avgLatency: 579
                    requests: 1
                  - path: "/api/linea"
                    avgLatency: 515
                    requests: 1
                  - path: "/api/avgtxsize"
                    avgLatency: 453
                    requests: 1
                  - path: "/api/bazaar/status"
                    avgLatency: 414
                    requests: 1
                  - path: "/api/ethereum"
                    avgLatency: 408.75
                    requests: 4
                  - path: "/api/revenue/uniswap"
                    avgLatency: 399
                    requests: 1
                  - path: "/api/info/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
                    avgLatency: 389
                    requests: 1
                  - path: "/api/resolve/brandonh.eth"
                    avgLatency: 378
                    requests: 1
                  - path: "/api/premia"
                    avgLatency: 368
                    requests: 1
                  - path: "/api/nfts/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                    avgLatency: 361
                    requests: 1
                  - path: "/api/reverse/Unknown"
                    avgLatency: 357
                    requests: 1
                  - path: "/api/avgtxvalue"
                    avgLatency: 354
                    requests: 1
                  - path: "/api/address/0x082f9507D9114a539cC420EdF51DCD37d1FdEE30"
                    avgLatency: 352.5
                    requests: 2
                  - path: "/api/hegic"
                    avgLatency: 347
                    requests: 1
                  - path: "/api/profile/stani"
                    avgLatency: 344
                    requests: 1
                  - path: "/api/24hrtransactioncount"
                    avgLatency: 320
                    requests: 1
                  - path: "/api/gas/ethereum"
                    avgLatency: 309
                    requests: 2
                  - path: "/api/totalbc"
                    avgLatency: 308
                    requests: 1
                  - path: "/api/all"
                    avgLatency: 305
                    requests: 1
                  - path: "/api/profile/vitalik.lens"
                    avgLatency: 305
                    requests: 1
                  - path: "/api/eta"
                    avgLatency: 301
                    requests: 1
                  - path: "/api/top"
                    avgLatency: 295
                    requests: 3
                  - path: "/api/gas/polygon"
                    avgLatency: 292
                    requests: 1
                  - path: "/api/category/defi"
                    avgLatency: 269
                    requests: 1
                  - path: "/api/reverse/0x082f9507D9114a539cC420EdF51DCD37d1FdEE30"
                    avgLatency: 237
                    requests: 1
                  - path: "/api/deribit"
                    avgLatency: 236
                    requests: 1
                  - path: "/api/analytics/dashboard"
                    avgLatency: 230.85714285714286
                    requests: 7
                  - path: "/api/opyn"
                    avgLatency: 201
                    requests: 1
                  - path: "/api/lyra"
                    avgLatency: 199
                    requests: 1
                  - path: "/api/ribbon"
                    avgLatency: 199
                    requests: 1
                  - path: "/api/age/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                    avgLatency: 196
                    requests: 1
                  - path: "/api/contract/source/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                    avgLatency: 194
                    requests: 1
                  - path: "/api/status/all"
                    avgLatency: 193
                    requests: 1
                  - path: "/api/block/latest"
                    avgLatency: 188
                    requests: 1
                  - path: "/api/dopex"
                    avgLatency: 187
                    requests: 1
                  - path: "/api/resolve/atv.eth"
                    avgLatency: 181
                    requests: 1
                  - path: "/api/gas/arbitrum"
                    avgLatency: 180
                    requests: 1
                  - path: "/api/resolve/brandonhurt.eth"
                    avgLatency: 175
                    requests: 1
                  - path: "/api/gas/optimism"
                    avgLatency: 158
                    requests: 1
                  - path: "/api/resolve/vitalik.eth"
                    avgLatency: 157
                    requests: 2
                  - path: "/api/analytics/endpoints"
                    avgLatency: 157
                    requests: 1
                  - path: "/api/scroll"
                    avgLatency: 153
                    requests: 1
                  - path: "/api/blast"
                    avgLatency: 146
                    requests: 1
                  - path: "/api/block/937185"
                    avgLatency: 143
                    requests: 1
                  - path: "/api/starknet"
                    avgLatency: 143
                    requests: 1
                  - path: "/api/zksync"
                    avgLatency: 141
                    requests: 1
                  - path: "/api/gas/base"
                    avgLatency: 139
                    requests: 1
                  - path: "/api/code/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                    avgLatency: 134
                    requests: 1
                  - path: "/api/mode"
                    avgLatency: 131
                    requests: 1
                  - path: "/api/mantle"
                    avgLatency: 130
                    requests: 1
                  - path: "/api/metrics/ethereum"
                    avgLatency: 129
                    requests: 1
                  - path: "/api/events/upcoming"
                    avgLatency: 128
                    requests: 1
                  - path: "/api/farcaster/dwr"
                    avgLatency: 127
                    requests: 1
                  - path: "/api/gainers"
                    avgLatency: 125
                    requests: 1
                  - path: "/api/latesthash"
                    avgLatency: 120
                    requests: 1
                  - path: "/api/contract/code/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                    avgLatency: 119
                    requests: 1
                  - path: "/api/interval"
                    avgLatency: 117
                    requests: 1
                  - path: "/api/profile/handle"
                    avgLatency: 115
                    requests: 1
                  - path: "/api/bcperblock"
                    avgLatency: 113
                    requests: 1
                  - path: "/api/movers/7d"
                    avgLatency: 100.77777777777777
                    requests: 9
                timestamp: "2026-02-18T16:20:23.167Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Slow. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/analytics/referrers:
    get:
      tags:
        - "Admin"
      summary: "Referrers"
      operationId: "get_api_analytics_referrers"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                referrers:
                  - site: "web3identity.com"
                    requests: 800
                  - site: "aboutme.eth.limo"
                    requests: 7
                  - site: "idnyc.com"
                    requests: 5
                  - site: "freeendpoints.com"
                    requests: 4
                  - site: "theidentityapi.com"
                    requests: 3
                  - site: "nooauth.com"
                    requests: 3
                  - site: "addtoyouragent.com"
                    requests: 2
                  - site: "noapikeys.com"
                    requests: 2
                  - site: "api.web3identity.com"
                    requests: 2
                  - site: "adminkeys.com"
                    requests: 1
                  - site: "www.addtoyouragent.com"
                    requests: 1
                  - site: "proofofkey.com"
                    requests: 1
                  - site: "chainbacked.com"
                    requests: 1
                  - site: "ethbacked.com"
                    requests: 1
                  - site: "www.enssdk.com"
                    requests: 1
                  - site: "agenttrustvector.com"
                    requests: 1
                  - site: "enssdk.com"
                    requests: 1
                  - site: "blockchaindomain.com"
                    requests: 1
                  - site: "namewrapper.com"
                    requests: 1
                  - site: "www.crosschainidentity.com"
                    requests: 1
                total: 839
                uniqueSites: 20
                timeWindow: "24h"
                note: "Aggregated from request logs (persists across restarts)"
                timestamp: "2026-02-18T16:20:23.129Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Referrers. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/analytics/unused:
    get:
      tags:
        - "Admin"
      summary: "Unused"
      operationId: "get_api_analytics_unused"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                message: "Track all endpoints and compare with usage to find unused"
                trackedEndpoints: 268
                timestamp: "2026-02-18T16:40:07.696Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Unused. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/pricing/tiers:
    get:
      tags:
        - "Admin"
      summary: "Tiers"
      operationId: "get_api_pricing_tiers"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                tiers:
                  free:
                    name: "Free"
                    rateLimit: 100
                    price: 0
                    bulkLimit: 10
                  basic:
                    name: "Basic"
                    rateLimit: 1000
                    price: 9.99
                    bulkLimit: 50
                  pro:
                    name: "Pro"
                    rateLimit: 10000
                    price: 49.99
                    bulkLimit: 100
                    features:
                      - "reduced-cache"
                  premium:
                    name: "Premium"
                    rateLimit: 100000
                    price: 199.99
                    bulkLimit: 500
                    features:
                      - "bypass-cache"
                  enterprise:
                    name: "Enterprise"
                    rateLimit: null
                    price: "custom"
                    bulkLimit: 1000
                    features:
                      - "bypass-cache"
                      - "sla"
                description: "API access tiers with different rate limits and features"
                timestamp: "2026-02-18T16:40:07.776Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Tiers. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/pricing/bulk:
    get:
      tags:
        - "Admin"
      summary: "Bulk"
      operationId: "get_api_pricing_bulk"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                packages:
                  - name: "Starter"
                    requests: 10000
                    price: 9.99
                    perRequest: "$0.001"
                  - name: "Growth"
                    requests: 50000
                    price: 39.99
                    perRequest: "$0.0008"
                    savings: "20%"
                  - name: "Scale"
                    requests: 200000
                    price: 99.99
                    perRequest: "$0.0005"
                    savings: "50%"
                  - name: "Enterprise"
                    requests: 1000000
                    price: 299.99
                    perRequest: "$0.0003"
                    savings: "70%"
                description: "Volume-based pricing packages"
                note: "Contact for custom enterprise pricing"
                timestamp: "2026-02-18T16:33:18.484Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Bulk. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/analytics/x402-recommendations:
    get:
      tags:
        - "Admin"
      summary: "X402-recommendations"
      operationId: "get_api_analytics_x402_recommendations"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                recommendations:
                  - endpoint: "/api/analytics/hourly"
                    requests: 85
                    avgLatencyMs: 78
                    priority: "MEDIUM"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/sources/health"
                    requests: 27
                    avgLatencyMs: 2
                    priority: "MEDIUM"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/log"
                    requests: 25
                    avgLatencyMs: 3
                    priority: "MEDIUM"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/stats/endpoints"
                    requests: 16
                    avgLatencyMs: 9
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/lending/iron-bank"
                    requests: 12
                    avgLatencyMs: 2
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/movers/1h"
                    requests: 10
                    avgLatencyMs: 78
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/fear-greed/history"
                    requests: 9
                    avgLatencyMs: 97
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/movers/24h"
                    requests: 9
                    avgLatencyMs: 49
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/movers/7d"
                    requests: 9
                    avgLatencyMs: 101
                    priority: "LOW"
                    suggestedPrice: "$0.005"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/lending/protocol"
                    requests: 8
                    avgLatencyMs: 2
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/profile/handle/following"
                    requests: 8
                    avgLatencyMs: 2
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/sector/ethereum"
                    requests: 8
                    avgLatencyMs: 24
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/analytics/dashboard"
                    requests: 8
                    avgLatencyMs: 2193
                    priority: "LOW"
                    suggestedPrice: "$0.01"
                    reasoning: "High compute cost"
                  - endpoint: "/api/ens/reverse/0x082f9507D9114a539cC420EdF51DCD37d1FdEE30"
                    requests: 7
                    avgLatencyMs: 1
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/lens/profile/handle"
                    requests: 7
                    avgLatencyMs: 1
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/api/liquidations/protocol"
                    requests: 6
                    avgLatencyMs: 3
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/balance/0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    requests: 6
                    avgLatencyMs: 91
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/farcaster/address/0x082f9507D9114a539cC420EdF51DCD37d1FdEE30"
                    requests: 4
                    avgLatencyMs: 65
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/ethereum"
                    requests: 4
                    avgLatencyMs: 409
                    priority: "LOW"
                    suggestedPrice: "$0.005"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/lending/aave"
                    requests: 4
                    avgLatencyMs: 1
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/dashboard-summary"
                    requests: 3
                    avgLatencyMs: 76
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/top"
                    requests: 3
                    avgLatencyMs: 295
                    priority: "LOW"
                    suggestedPrice: "$0.005"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/lending/benqi"
                    requests: 3
                    avgLatencyMs: 1
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/lending/compound"
                    requests: 3
                    avgLatencyMs: 2
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/lending/cream"
                    requests: 3
                    avgLatencyMs: 2
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/lending/euler"
                    requests: 3
                    avgLatencyMs: 1
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/trending"
                    requests: 2
                    avgLatencyMs: 76
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/address/0x082f9507D9114a539cC420EdF51DCD37d1FdEE30"
                    requests: 2
                    avgLatencyMs: 353
                    priority: "LOW"
                    suggestedPrice: "$0.005"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/farcaster/brandonh"
                    requests: 2
                    avgLatencyMs: 75
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                  - endpoint: "/api/lens/address/0x082f9507D9114a539cC420EdF51DCD37d1FdEE30"
                    requests: 2
                    avgLatencyMs: 2
                    priority: "LOW"
                    suggestedPrice: "$0.001"
                    reasoning: "Standard pricing"
                summary:
                  highPriority: 0
                  mediumPriority: 3
                  lowPriority: 27
                timestamp: "2026-02-18T16:40:07.738Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "X402-recommendations. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/usage-data:
    get:
      tags:
        - "Admin"
      summary: "Usage-data"
      operationId: "get_api_usage_data"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                127.0.0.1:medium:2026-02-18: 304
                127.0.0.1:2026-02-18: 372
                18.117.47.153:medium:2026-02-18: 174
                18.117.47.153:2026-02-18: 189
                18.117.47.153:auth:2026-02-18: 1
                18.117.47.153:light:2026-02-18: 5
                149.154.161.248:medium:2026-02-18: 1
                149.154.161.248:2026-02-18: 1
                8.47.96.51:medium:2026-02-18: 11
                8.47.96.51:2026-02-18: 114
                94.102.49.128:medium:2026-02-18: 1
                94.102.49.128:2026-02-18: 1
                170.106.113.235:medium:2026-02-18: 1
                170.106.113.235:2026-02-18: 1
                66.249.79.5:medium:2026-02-18: 1
                66.249.79.5:2026-02-18: 1
                66.249.79.3:medium:2026-02-18: 1
                66.249.79.3:2026-02-18: 1
                43.159.152.184:medium:2026-02-18: 1
                43.159.152.184:2026-02-18: 1
                49.51.178.45:medium:2026-02-18: 1
                49.51.178.45:2026-02-18: 1
                66.249.79.4:medium:2026-02-18: 1
                66.249.79.4:2026-02-18: 1
                205.169.39.145:medium:2026-02-18: 1
                205.169.39.145:2026-02-18: 1
                205.169.39.175:medium:2026-02-18: 1
                205.169.39.175:2026-02-18: 1
                49.51.72.76:medium:2026-02-18: 1
                49.51.72.76:2026-02-18: 1
                205.169.39.93:medium:2026-02-18: 1
                205.169.39.93:2026-02-18: 1
                43.167.239.66:medium:2026-02-18: 1
                43.167.239.66:2026-02-18: 1
                43.130.60.195:medium:2026-02-18: 1
                43.130.60.195:2026-02-18: 1
                127.0.0.1:auth:2026-02-18: 3
                127.0.0.1:light:2026-02-18: 55
                127.0.0.1:heavy:2026-02-18: 10
                205.169.39.183:medium:2026-02-18: 1
                205.169.39.183:2026-02-18: 1
                205.169.39.179:medium:2026-02-18: 1
                205.169.39.179:2026-02-18: 1
                43.157.168.43:medium:2026-02-18: 1
                43.157.168.43:2026-02-18: 1
                205.169.39.202:medium:2026-02-18: 1
                205.169.39.202:2026-02-18: 1
                205.169.39.182:medium:2026-02-18: 1
                205.169.39.182:2026-02-18: 1
                172.56.163.208:medium:2026-02-18: 7
                172.56.163.208:2026-02-18: 7
                47.128.22.209:medium:2026-02-18: 1
                47.128.22.209:2026-02-18: 1
                188.34.179.202:medium:2026-02-18: 1
                188.34.179.202:2026-02-18: 1
                47.128.42.117:light:2026-02-18: 1
                47.128.42.117:2026-02-18: 1
                45.127.57.238:medium:2026-02-18: 1
                45.127.57.238:2026-02-18: 1
                104.197.58.162:medium:2026-02-18: 1
                104.197.58.162:2026-02-18: 1
                110.249.201.169:medium:2026-02-18: 1
                110.249.201.169:2026-02-18: 1
                17.22.237.120:medium:2026-02-18: 1
                17.22.237.120:2026-02-18: 1
                188.34.165.75:medium:2026-02-18: 1
                188.34.165.75:2026-02-18: 1
                174.229.66.71:medium:2026-02-18: 1
                174.229.66.71:2026-02-18: 1
                8.47.96.51:light:2026-02-18: 2
                8.47.96.51:heavy:2026-02-18: 101
                205.169.39.242:medium:2026-02-18: 1
                205.169.39.242:2026-02-18: 1
                185.220.101.142:medium:2026-02-18: 2
                185.220.101.142:2026-02-18: 2
                93.158.92.11:medium:2026-02-18: 1
                93.158.92.11:2026-02-18: 1
                18.117.47.153:heavy:2026-02-18: 9
                109.70.100.13:medium:2026-02-18: 1
                109.70.100.13:2026-02-18: 1
                45.84.107.172:heavy:2026-02-18: 1
                45.84.107.172:2026-02-18: 3
                45.84.107.172:medium:2026-02-18: 2
                203.55.81.1:heavy:2026-02-18: 3
                203.55.81.1:2026-02-18: 4
                203.55.81.1:medium:2026-02-18: 1
                204.101.161.15:medium:2026-02-18: 1
                204.101.161.15:2026-02-18: 1
                192.71.10.105:medium:2026-02-18: 1
                192.71.10.105:2026-02-18: 1
                96.56.47.170:medium:2026-02-18: 1
                96.56.47.170:2026-02-18: 1
                5.101.64.6:medium:2026-02-18: 1
                5.101.64.6:2026-02-18: 1
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Usage-data. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/analytics/payments:
    get:
      tags:
        - "Admin"
      summary: "Payments"
      operationId: "get_api_analytics_payments"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                events:
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/staking/eth"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T15:35:33.329Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/staking/eigenlayer"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T15:35:33.294Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/staking"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T15:35:33.220Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/social/vitalik.eth"
                    method: "GET"
                    price: "$0.02"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T15:35:33.182Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/staking/eth"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T15:35:17.072Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/staking/eigenlayer"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T15:35:17.039Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/staking"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T15:35:16.887Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/social/vitalik.eth"
                    method: "GET"
                    price: "$0.02"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T15:35:16.853Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/vertex"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T14:22:44.094Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/vertex"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T14:22:44.063Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/rage-trade"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T14:07:43.709Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/oi"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T14:07:43.679Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/mux"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T14:07:43.648Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/level"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T14:07:43.618Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/kwenta"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T14:07:43.583Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/hyperliquid"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T13:58:15.241Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/gmx"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T13:58:15.209Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/funding"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T13:58:15.181Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/dydx"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T13:58:15.151Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/drift"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T13:58:15.122Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/cap"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T13:50:46.395Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/bluefin"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T13:50:46.362Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/apex"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T13:50:46.329Z"
                  - event: "402_RETURNED"
                    clientId: "18.117.47.153"
                    endpoint: "/perps/aevo"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T13:50:46.295Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/market/fear-greed"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T12:03:21.848Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/aave"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T12:01:26.222Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/iron-bank"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T12:01:26.211Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/protocol"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:51:51.019Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/iron-bank"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:51:51.003Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/protocol"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:51:41.647Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/iron-bank"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:51:41.620Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/protocol"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:51:32.236Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/iron-bank"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:51:32.214Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/protocol"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:51:22.626Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/iron-bank"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:51:22.600Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/protocol"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:51:16.921Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/iron-bank"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:51:16.913Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/protocol"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:50:45.782Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/iron-bank"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:50:45.772Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/protocol"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:50:31.969Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/iron-bank"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:50:31.957Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/protocol"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:50:18.141Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/iron-bank"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:50:18.133Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/top"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:49:56.107Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/spark"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:49:56.097Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/silo"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:49:56.087Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/radiant"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:49:56.077Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/iron-bank"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:49:56.066Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/notional"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:49:42.405Z"
                  - event: "402_RETURNED"
                    clientId: "127.0.0.1"
                    endpoint: "/lending/morpho"
                    method: "GET"
                    price: "$0.01"
                    payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                    ts: "2026-02-18T11:49:42.398Z"
                summary:
                  total: 10903
                  settlements: 191
                  attempts: 291
                  requests402: 9848
                  rejected: 8
                timestamp: "2026-02-18T16:20:22.978Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Payments. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/analytics/dashboard:
    get:
      tags:
        - "Admin"
      summary: "Dashboard"
      operationId: "get_api_analytics_dashboard"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                version: "2.9.0"
                wallet: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                summary:
                  totalRequests: 492
                  paidRequests: 191
                  requests402: 9848
                  totalRevenue: 19.731000000000076
                  usdcBalance: 18.324379
                  ethBalance: 0.09479880538427858
                  avgResponseTime: 113
                  successRate: 51.4
                  uniqueUsers: 21
                recentSettlements:
                  - time: "2026-02-15T19:34:19.234Z"
                    amount: 0.97
                    endpoint: "/api/agent/register"
                    method: "POST"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: "0xe26479312cae5bf4bd97e91fd9d37911b0f728d7dd8ea2969748d7cccf6beff7"
                  - time: "2026-02-13T23:56:36.273Z"
                    amount: 0.01
                    endpoint: "/api/lending/aave"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:34.147Z"
                    amount: 0.01
                    endpoint: "/api/lending/rates"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:32.438Z"
                    amount: 0.01
                    endpoint: "/api/staking/rocketpool"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:31.152Z"
                    amount: 0.01
                    endpoint: "/api/staking/eigenlayer"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:29.987Z"
                    amount: 0.01
                    endpoint: "/api/staking/lido"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:28.533Z"
                    amount: 0.01
                    endpoint: "/api/staking/eth"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:27.141Z"
                    amount: 0.01
                    endpoint: "/api/staking"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:26.705Z"
                    amount: 0.01
                    endpoint: "/api/tokens/categories"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:26.283Z"
                    amount: 0.01
                    endpoint: "/api/tokens/gaming"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:25.851Z"
                    amount: 0.01
                    endpoint: "/api/tokens/ai"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:25.399Z"
                    amount: 0.01
                    endpoint: "/api/tokens/l2"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:24.153Z"
                    amount: 0.01
                    endpoint: "/api/tokens/defi"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:22.413Z"
                    amount: 0.01
                    endpoint: "/api/tokens/memecoins"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:21.956Z"
                    amount: 0.01
                    endpoint: "/api/tokens/stablecoins"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:21.519Z"
                    amount: 0.01
                    endpoint: "/api/l2/optimism"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:21.093Z"
                    amount: 0.01
                    endpoint: "/api/l2/arbitrum"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:20.685Z"
                    amount: 0.01
                    endpoint: "/api/l2/base"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:20.129Z"
                    amount: 0.01
                    endpoint: "/api/l2/tvl/arbitrum"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                  - time: "2026-02-13T23:56:19.574Z"
                    amount: 0.01
                    endpoint: "/api/l2/tps"
                    method: "GET"
                    payer: "0xFf1D6Dbb3C05AfAd271edEb92e47ea92fCE1De48"
                    network: "Base"
                    status: "confirmed"
                    tx: null
                recent402Activity:
                  - time: "2026-02-18T15:35:33.329Z"
                    price: "$0.01"
                    endpoint: "/api/staking/eth"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T15:35:33.294Z"
                    price: "$0.01"
                    endpoint: "/api/staking/eigenlayer"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T15:35:33.220Z"
                    price: "$0.01"
                    endpoint: "/api/staking"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T15:35:33.182Z"
                    price: "$0.02"
                    endpoint: "/api/social/vitalik.eth"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T15:35:17.072Z"
                    price: "$0.01"
                    endpoint: "/api/staking/eth"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T15:35:17.039Z"
                    price: "$0.01"
                    endpoint: "/api/staking/eigenlayer"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T15:35:16.887Z"
                    price: "$0.01"
                    endpoint: "/api/staking"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T15:35:16.853Z"
                    price: "$0.02"
                    endpoint: "/api/social/vitalik.eth"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T14:22:44.094Z"
                    price: "$0.01"
                    endpoint: "/api/perps/vertex"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T14:22:44.063Z"
                    price: "$0.01"
                    endpoint: "/api/perps/vertex"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T14:07:43.709Z"
                    price: "$0.01"
                    endpoint: "/api/perps/rage-trade"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T14:07:43.679Z"
                    price: "$0.01"
                    endpoint: "/api/perps/oi"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T14:07:43.648Z"
                    price: "$0.01"
                    endpoint: "/api/perps/mux"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T14:07:43.618Z"
                    price: "$0.01"
                    endpoint: "/api/perps/level"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T14:07:43.583Z"
                    price: "$0.01"
                    endpoint: "/api/perps/kwenta"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T13:58:15.241Z"
                    price: "$0.01"
                    endpoint: "/api/perps/hyperliquid"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T13:58:15.209Z"
                    price: "$0.01"
                    endpoint: "/api/perps/gmx"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T13:58:15.181Z"
                    price: "$0.01"
                    endpoint: "/api/perps/funding"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T13:58:15.151Z"
                    price: "$0.01"
                    endpoint: "/api/perps/dydx"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T13:58:15.122Z"
                    price: "$0.01"
                    endpoint: "/api/perps/drift"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T13:50:46.395Z"
                    price: "$0.01"
                    endpoint: "/api/perps/cap"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T13:50:46.362Z"
                    price: "$0.01"
                    endpoint: "/api/perps/bluefin"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T13:50:46.329Z"
                    price: "$0.01"
                    endpoint: "/api/perps/apex"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T13:50:46.295Z"
                    price: "$0.01"
                    endpoint: "/api/perps/aevo"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T12:03:21.848Z"
                    price: "$0.01"
                    endpoint: "/api/market/fear-greed"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T12:01:26.222Z"
                    price: "$0.01"
                    endpoint: "/api/lending/aave"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T12:01:26.211Z"
                    price: "$0.01"
                    endpoint: "/api/lending/iron-bank"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T11:51:51.019Z"
                    price: "$0.01"
                    endpoint: "/api/lending/protocol"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T11:51:51.003Z"
                    price: "$0.01"
                    endpoint: "/api/lending/iron-bank"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                  - time: "2026-02-18T11:51:41.647Z"
                    price: "$0.01"
                    endpoint: "/api/lending/protocol"
                    method: "GET"
                    event: "FREE_TIER_EXHAUSTED"
                topEndpoints:
                  - endpoint: "/api/analytics/hourly"
                    requests: 58
                    paid: 0
                    avgTime: 79
                  - endpoint: "/api/sources/health"
                    requests: 26
                    paid: 0
                    avgTime: 2
                  - endpoint: "/api/log"
                    requests: 24
                    paid: 0
                    avgTime: 3
                  - endpoint: "/api/stats/endpoints"
                    requests: 16
                    paid: 0
                    avgTime: 9
                  - endpoint: "/api/lending/iron-bank"
                    requests: 12
                    paid: 0
                    avgTime: 2
                  - endpoint: "/api/movers/1h"
                    requests: 10
                    paid: 0
                    avgTime: 78
                  - endpoint: "/api/fear-greed/history"
                    requests: 9
                    paid: 0
                    avgTime: 97
                  - endpoint: "/api/movers/24h"
                    requests: 9
                    paid: 0
                    avgTime: 49
                  - endpoint: "/api/movers/7d"
                    requests: 9
                    paid: 0
                    avgTime: 101
                  - endpoint: "/api/lending/protocol"
                    requests: 8
                    paid: 0
                    avgTime: 2
                uptime: 43394759
                timestamp: "2026-02-18T16:14:06.800Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Dashboard. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/analytics/hourly:
    get:
      tags:
        - "Admin"
      summary: "Hourly"
      operationId: "get_api_analytics_hourly"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                period: "24h"
                hourly:
                  - hour: "00:00"
                    count: 55
                  - hour: "01:00"
                    count: 50
                  - hour: "02:00"
                    count: 23
                  - hour: "03:00"
                    count: 12
                  - hour: "04:00"
                    count: 1668
                  - hour: "05:00"
                    count: 39
                  - hour: "06:00"
                    count: 5
                  - hour: "07:00"
                    count: 6
                  - hour: "08:00"
                    count: 4
                  - hour: "09:00"
                    count: 4
                  - hour: "10:00"
                    count: 8
                  - hour: "11:00"
                    count: 108
                  - hour: "12:00"
                    count: 65
                  - hour: "13:00"
                    count: 34
                  - hour: "14:00"
                    count: 21
                  - hour: "15:00"
                    count: 90
                  - hour: "16:00"
                    count: 31
                  - hour: "17:00"
                    count: 5
                  - hour: "18:00"
                    count: 21
                  - hour: "19:00"
                    count: 13
                  - hour: "20:00"
                    count: 16
                  - hour: "21:00"
                    count: 8
                  - hour: "22:00"
                    count: 614
                  - hour: "23:00"
                    count: 113
                total: 3013
                endpointUsageTotal: 499
                timestamp: "2026-02-18T16:19:33.629Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Hourly. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/analytics/event:
    post:
      tags:
        - "Admin"
      summary: "Event"
      operationId: "post_api_analytics_event"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad Request - Request body is required"
          content:
            application/json:
              example:
                error: "Request body is required"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Event. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/analytics/events:
    get:
      tags:
        - "Admin"
      summary: "Events"
      operationId: "get_api_analytics_events"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                events: []
                total: 0
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Events. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/rate-limits:
    get:
      tags:
        - "Admin"
      summary: "Rate-limits"
      operationId: "get_api_rate_limits"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                description: "Rate limits vary by endpoint type. Expensive operations have stricter limits."
                tiers:
                  - name: "light"
                    perMinute: 120
                    dailyMultiplier: 2
                    examplePatterns:
                      - "/^\\/api\\/ens\\/resolve\\//"
                      - "/^\\/api\\/ens\\/reverse\\//"
                      - "/^\\/api\\/price\\/[^/]+$/"
                    description: "Simple lookups (price, resolve, gas) - highest limits for fast, cached operations"
                  - name: "medium"
                    perMinute: 60
                    dailyMultiplier: 1
                    examplePatterns:
                      - "/^\\/api\\/ens\\//"
                      - "/^\\/api\\/nft\\//"
                      - "/^\\/api\\/token\\//"
                    description: "Standard operations (ENS, NFT, DeFi) - default limits for most endpoints"
                  - name: "heavy"
                    perMinute: 10
                    dailyMultiplier: 0.25
                    examplePatterns:
                      - "/^\\/api\\/batch\\//"
                      - "/^\\/api\\/analytics\\//"
                      - "/^\\/api\\/profile\\/full/"
                    description: "Expensive operations (batch, analytics, search) - strict limits for compute-intensive requests"
                  - name: "auth"
                    perMinute: 20
                    dailyMultiplier: 0.5
                    examplePatterns:
                      - "/^\\/api\\/auth\\/nonce/"
                      - "/^\\/api\\/auth\\/verify/"
                      - "/^\\/api\\/auth\\/refresh/"
                    description: "Authentication operations (nonce, verify) - moderate limits to prevent abuse"
                  - name: "write"
                    perMinute: 5
                    dailyMultiplier: 0.1
                    examplePatterns:
                      - "/^\\/api\\/subnames\\/[^/]+$/"
                      - "/^\\/api\\/ccip\\/register/"
                      - "/^\\/subnames\\/[^/]+$/"
                    description: "State-changing operations (register, update) - very strict limits"
                baseLimits:
                  anonymous:
                    daily: 100
                    description: "No authentication"
                  siwe:
                    daily: 200
                    description: "SIWE authenticated"
                  apiKey:
                    daily: 250
                    description: "API key authenticated"
                  x402:
                    daily: "unlimited"
                    description: "Pay-per-request"
                examples:
                  - endpoint: "/api/price/eth"
                    tier: "light"
                    perMinute: 120
                    dailyMultiplier: 2
                  - endpoint: "/api/ens/resolve/vitalik.eth"
                    tier: "light"
                    perMinute: 120
                    dailyMultiplier: 2
                  - endpoint: "/api/nft/{address}/{id}"
                    tier: "medium"
                    perMinute: 60
                    dailyMultiplier: 1
                  - endpoint: "/api/batch/resolve"
                    tier: "heavy"
                    perMinute: 10
                    dailyMultiplier: 0.25
                  - endpoint: "/api/auth/verify"
                    tier: "auth"
                    perMinute: 20
                    dailyMultiplier: 0.5
                headers:
                  X-RateLimit-Tier: "Current endpoint tier"
                  X-RateLimit-Tier-Limit: "Requests/minute for this tier"
                  X-RateLimit-Tier-Remaining: "Remaining requests this minute"
                  X-RateLimit-Limit: "Daily limit for this tier"
                  X-RateLimit-Remaining: "Remaining daily requests"
                  X-RateLimit-Global-Used: "Total daily requests across all tiers"
                  X-RateLimit-Global-Limit: "Maximum daily requests (3x base)"
                timestamp: "2026-02-18T16:40:07.815Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Rate-limits. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/rate-limits/check:
    get:
      tags:
        - "Admin"
      summary: "Check"
      operationId: "get_api_rate_limits_check"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad Request - Missing required query parameter \"path\""
          content:
            application/json:
              example:
                error: true
                code: "ERROR"
                message: "Query parameter \"path\" is required"
                timestamp: "2026-02-18T16:40:07.851Z"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Check. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/sessions:
    get:
      tags:
        - "Admin"
      summary: "List active SIWE sessions"
      description: "Returns all active Sign-In with Ethereum sessions.\n\n**Requires:** Admin authentication (SIWE with admin privileges)\n"
      operationId: "getApiSessions"
      parameters:
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
            default: 100
          description: "Maximum sessions to return"
        - name: "offset"
          in: "query"
          schema:
            type: "integer"
            default: 0
          description: "Pagination offset"
      responses:
        "200":
          description: "List of active sessions"
          content:
            application/json:
              schema:
                type: "object"
                required:
                  - "sessions"
                  - "total"
                  - "timestamp"
                properties:
                  sessions:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        address:
                          type: "string"
                          description: "Ethereum address"
                          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                        label:
                          type: "string"
                          nullable: true
                          description: "User-assigned label"
                        chain_id:
                          type: "integer"
                          description: "Chain ID used for sign-in"
                          example: 1
                        created_at:
                          type: "string"
                          format: "date-time"
                        expires_at:
                          type: "string"
                          format: "date-time"
                        updated_at:
                          type: "string"
                          format: "date-time"
                        requests:
                          type: "integer"
                          description: "Request count in this session"
                        remembered:
                          type: "boolean"
                          description: "Whether session uses remember-me"
                  total:
                    type: "number"
                    description: "Total session count"
                  limit:
                    type: "number"
                  offset:
                    type: "number"
                  timestamp:
                    type: "string"
                    format: "date-time"
              example:
                sessions:
                  - address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                    label: "Main Wallet"
                    chain_id: 1
                    created_at: "2026-02-17T10:00:00.000Z"
                    expires_at: "2026-02-18T10:00:00.000Z"
                    updated_at: "2026-02-17T23:30:00.000Z"
                    requests: 42
                    remembered: true
                total: 1
                limit: 100
                offset: 0
                timestamp: "2026-02-17T23:55:00.000Z"
        "401":
          description: "Unauthorized - Admin authentication required"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
              example:
                error: true
                code: "UNAUTHORIZED"
                message: "Authentication required. Please sign in with SIWE."
                timestamp: "2026-02-17T23:55:00.000Z"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
      security:
        - SiweAuth: []
  /api/sessions/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    delete:
      tags:
        - "Admin"
      summary: "Sessions"
      operationId: "delete_api_sessions_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request"
        "401":
          description: "Unauthorized - Authentication required"
          content:
            application/json:
              example:
                error: true
                code: "UNAUTHORIZED"
                message: "Authentication required. Please sign in with SIWE."
                timestamp: "2026-02-18T16:14:06.669Z"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Sessions. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/users:
    get:
      tags:
        - "Admin"
      summary: "Users"
      operationId: "get_api_users"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                total: 1250
                authenticated: 340
                active24h: 89
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Users. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/users/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Admin"
      summary: "Users"
      operationId: "get_api_users_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request"
        "401":
          description: "Unauthorized - Authentication required"
          content:
            application/json:
              example:
                error: true
                code: "UNAUTHORIZED"
                message: "Authentication required. Please sign in with SIWE."
                timestamp: "2026-02-18T18:31:48.130Z"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Users. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/users/{address}/tier:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    put:
      tags:
        - "Admin"
      summary: "Tier"
      operationId: "put_api_users_address_tier"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad Request - Invalid tier value (must be: anonymous, authenticated, api_key, premium, admin)"
          content:
            application/json:
              example:
                error: true
                code: "ERROR"
                message: "Tier must be one of: anonymous, authenticated, api_key, premium, admin"
                timestamp: "2026-02-18T20:11:38.680Z"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Tier. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/dashboard-summary:
    get:
      tags:
        - "Admin"
      summary: "Dashboard-summary"
      operationId: "get_api_dashboard_summary"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                overview:
                  totalUsers: 16
                  activeSessions: 1
                  totalSessions: 1
                  apiKeys: 0
                  devices: 1
                  twoFactorEnabled: 0
                activity:
                  loginsToday: 0
                  uniqueUsersToday: 0
                  revocationsThisWeek: 0
                tiers:
                  authenticated: 16
                revenue:
                  total: 19.73
                  paidRequests: 191
                wallet:
                  address: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
                  ethBalance: "0.0948"
                  usdcBalance: "18.32"
                system:
                  version: "2.9.0"
                  endpoints: 1575
                  uptime: 44546.891610791
                  memoryUsage: "84 MB"
                timestamp: "2026-02-18T16:33:18.341Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Dashboard-summary. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/login-history:
    get:
      tags:
        - "Admin"
      summary: "Login-history"
      operationId: "get_api_login_history"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
        "400":
          description: "Bad request"
        "401":
          description: "Unauthorized - Authentication required"
          content:
            application/json:
              example:
                error: true
                code: "UNAUTHORIZED"
                message: "Authentication required. Please sign in with SIWE."
                timestamp: "2026-02-18T16:33:18.446Z"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Login-history. Administrative endpoint for system management and monitoring. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/agent/{name}/capabilities:
    parameters:
      - name: "name"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The name parameter"
    get:
      tags:
        - "Agent"
      summary: "Capabilities"
      operationId: "get_api_agent_name_capabilities"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Capabilities.  Free tier: 100 calls/day."
  /api/aggregators/1inch:
    get:
      tags:
        - "Aggregators"
      summary: "1inch"
      operationId: "get_api_aggregators_1inch"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "1inch"
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                volume24h: 500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "1inch. DEX aggregator data and statistics. Free tier: 100 calls/day."
  /api/aggregators/paraswap:
    get:
      tags:
        - "Aggregators"
      summary: "Paraswap"
      operationId: "get_api_aggregators_paraswap"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "1inch"
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                volume24h: 500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Paraswap. DEX aggregator data and statistics. Free tier: 100 calls/day."
  /api/aggregators/cowswap:
    get:
      tags:
        - "Aggregators"
      summary: "Cowswap"
      operationId: "get_api_aggregators_cowswap"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "1inch"
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                volume24h: 500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Cowswap. DEX aggregator data and statistics. Free tier: 100 calls/day."
  /api/aggregators/matcha:
    get:
      tags:
        - "Aggregators"
      summary: "Matcha"
      operationId: "get_api_aggregators_matcha"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "1inch"
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                volume24h: 500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Matcha. DEX aggregator data and statistics. Free tier: 100 calls/day."
  /api/aggregators/kyberswap:
    get:
      tags:
        - "Aggregators"
      summary: "Kyberswap"
      operationId: "get_api_aggregators_kyberswap"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "1inch"
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                volume24h: 500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Kyberswap. DEX aggregator data and statistics. Free tier: 100 calls/day."
  /api/aggregators/odos:
    get:
      tags:
        - "Aggregators"
      summary: "Odos"
      operationId: "get_api_aggregators_odos"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "1inch"
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                volume24h: 500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Odos. DEX aggregator data and statistics. Free tier: 100 calls/day."
  /api/aggregators/openocean:
    get:
      tags:
        - "Aggregators"
      summary: "Openocean"
      operationId: "get_api_aggregators_openocean"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "1inch"
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                volume24h: 500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Openocean. DEX aggregator data and statistics. Free tier: 100 calls/day."
  /api/aggregators/socket:
    get:
      tags:
        - "Aggregators"
      summary: "Socket"
      operationId: "get_api_aggregators_socket"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "1inch"
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                volume24h: 500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Socket. DEX aggregator data and statistics. Free tier: 100 calls/day."
  /api/aggregators/bebop:
    get:
      tags:
        - "Aggregators"
      summary: "Bebop"
      operationId: "get_api_aggregators_bebop"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "1inch"
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                volume24h: 500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Bebop. DEX aggregator data and statistics. Free tier: 100 calls/day."
  /api/aggregators/jupiter:
    get:
      tags:
        - "Aggregators"
      summary: "Jupiter"
      operationId: "get_api_aggregators_jupiter"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "1inch"
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                volume24h: 500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Jupiter. DEX aggregator data and statistics. Free tier: 100 calls/day."
  /api/aggregators/chain/{chain}:
    parameters:
      - name: "chain"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The chain parameter"
    get:
      tags:
        - "Aggregators"
      summary: "Chain"
      operationId: "get_api_aggregators_chain_chain_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "1inch"
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                volume24h: 500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Chain. DEX aggregator data and statistics. Free tier: 100 calls/day."
  /api/allowances/{owner}/{spender}:
    parameters:
      - name: "owner"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The owner parameter"
      - name: "spender"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The spender parameter"
    get:
      tags:
        - "Allowances"
      summary: "Allowances"
      operationId: "get_api_allowances_owner_spender_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Allowances.  Free tier: 100 calls/day."
  /api/asset-transfers/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Asset-transfers"
      summary: "Asset-transfers"
      operationId: "get_api_asset_transfers_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Asset-transfers.  Free tier: 100 calls/day."
  /api/auth/health:
    get:
      tags:
        - "Auth"
      summary: "Health"
      operationId: "get_api_auth_health"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Health. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/chains:
    get:
      tags:
        - "Auth"
      summary: "Chains"
      operationId: "get_api_auth_chains"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Chains. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/stats:
    get:
      tags:
        - "Auth"
      summary: "Stats"
      operationId: "get_api_auth_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Stats. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/analytics:
    get:
      tags:
        - "Auth"
      summary: "Analytics"
      operationId: "get_api_auth_analytics"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Analytics. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/login-history:
    get:
      tags:
        - "Auth"
      summary: "Login-history"
      operationId: "get_api_auth_me_login_history"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Login-history. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/refresh:
    post:
      tags:
        - "Auth"
      summary: "Refresh"
      operationId: "post_api_auth_refresh"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                token: "EXAMPLE_SESSION_TOKEN_12345"
                expiresIn: 3600
                refreshToken: "ref_abc123def456"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Refresh. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/session/label:
    put:
      tags:
        - "Auth"
      summary: "Label"
      operationId: "put_api_auth_session_label"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Label. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/sessions:
    delete:
      tags:
        - "Auth"
      summary: "Sessions"
      operationId: "delete_api_auth_sessions"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Sessions. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/sessions/revocations:
    get:
      tags:
        - "Auth"
      summary: "Revocations"
      operationId: "get_api_auth_sessions_revocations"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Revocations. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/me:
    get:
      tags:
        - "Auth"
      summary: "Get current user info"
      description: "Returns the authenticated user's profile and session information"
      operationId: "getAuthMe"
      responses:
        "200":
          description: "Current user information"
          content:
            application/json:
              schema:
                type: "object"
                required:
                  - "address"
                  - "authenticated"
                  - "timestamp"
                properties:
                  address:
                    type: "string"
                    description: "Ethereum address of authenticated user"
                    example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                  authenticated:
                    type: "boolean"
                    description: "Whether user is currently authenticated"
                  chainId:
                    type: "number"
                    description: "Chain ID used for authentication"
                    example: 1
                  ensName:
                    type: "string"
                    nullable: true
                    description: "Primary ENS name if set"
                  avatar:
                    type: "string"
                    nullable: true
                    description: "Avatar URL from ENS or profile"
                  sessionExpires:
                    type: "string"
                    format: "date-time"
                    description: "Session expiration time"
                  requestsRemaining:
                    type: "number"
                    description: "API requests remaining in current period"
                  timestamp:
                    type: "string"
                    format: "date-time"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                authenticated: true
                chainId: 1
                ensName: "vitalik.eth"
                avatar: "https://metadata.ens.domains/mainnet/avatar/vitalik.eth"
                sessionExpires: "2026-02-19T00:35:41.000Z"
                requestsRemaining: 85
                timestamp: "2026-02-18T00:35:41.067Z"
        "401":
          description: "Not authenticated"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
              example:
                error: true
                code: "UNAUTHORIZED"
                message: "Authentication required"
                timestamp: "2026-02-18T00:35:41.067Z"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      security:
        - SiweAuth: []
  /api/auth/me/api-key:
    post:
      tags:
        - "Auth"
      summary: "Api-key"
      operationId: "post_api_auth_me_api_key"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Api-key. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/me/api-key/{key}:
    parameters:
      - name: "key"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The key parameter"
    delete:
      tags:
        - "Auth"
      summary: "Api-key"
      operationId: "delete_api_auth_me_api_key_key_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Api-key. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/me/payments:
    get:
      tags:
        - "Auth"
      summary: "Payments"
      operationId: "get_api_auth_me_payments"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Payments. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/activity:
    get:
      tags:
        - "Auth"
      summary: "Activity"
      operationId: "get_api_auth_me_activity"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Activity. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/notifications:
    get:
      tags:
        - "Auth"
      summary: "Notifications"
      operationId: "get_api_auth_me_notifications"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Notifications. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/notifications/email:
    post:
      tags:
        - "Auth"
      summary: "Email"
      operationId: "post_api_auth_me_notifications_email"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Email. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/notifications/email/verify:
    post:
      tags:
        - "Auth"
      summary: "Verify"
      operationId: "post_api_auth_me_notifications_email_verify"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                token: "EXAMPLE_SESSION_TOKEN_12345"
                expiresIn: 3600
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Verify. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/notifications/settings:
    put:
      tags:
        - "Auth"
      summary: "Settings"
      operationId: "put_api_auth_me_notifications_settings"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Settings. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/devices:
    get:
      tags:
        - "Auth"
      summary: "Devices"
      operationId: "get_api_auth_me_devices"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Devices. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/devices/{fingerprint}/trust:
    parameters:
      - name: "fingerprint"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The fingerprint parameter"
    post:
      tags:
        - "Auth"
      summary: "Trust"
      operationId: "post_api_auth_me_devices_fingerprint_trust"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Trust. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/devices/{fingerprint}/untrust:
    parameters:
      - name: "fingerprint"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The fingerprint parameter"
    post:
      tags:
        - "Auth"
      summary: "Untrust"
      operationId: "post_api_auth_me_devices_fingerprint_untrust"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Untrust. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/devices/{fingerprint}:
    parameters:
      - name: "fingerprint"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The fingerprint parameter"
    delete:
      tags:
        - "Auth"
      summary: "Devices"
      operationId: "delete_api_auth_me_devices_fingerprint_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Devices. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/webhooks/events:
    get:
      tags:
        - "Auth"
      summary: "Events"
      operationId: "get_api_auth_webhooks_events"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Events. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/webhooks/stats:
    get:
      tags:
        - "Auth"
      summary: "Stats"
      operationId: "get_api_auth_webhooks_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Stats. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/webhooks:
    get:
      tags:
        - "Auth"
      summary: "Webhooks"
      operationId: "get_api_auth_me_webhooks"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Webhooks. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/webhooks/{id}:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Auth"
      summary: "Webhooks"
      operationId: "get_api_auth_me_webhooks_id_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Webhooks. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/webhooks/{id}/deliveries:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Auth"
      summary: "Deliveries"
      operationId: "get_api_auth_me_webhooks_id_deliveries"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Deliveries. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/webhooks/{id}/test:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    post:
      tags:
        - "Auth"
      summary: "Test"
      operationId: "post_api_auth_me_webhooks_id_test"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Test. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/security:
    get:
      tags:
        - "Auth"
      summary: "Security"
      operationId: "get_api_auth_me_security"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Security. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/sessions:
    get:
      tags:
        - "Auth"
      summary: "Sessions"
      operationId: "get_api_auth_me_sessions"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Sessions. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/me/sessions/{familyId}:
    parameters:
      - name: "familyId"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The familyId parameter"
    delete:
      tags:
        - "Auth"
      summary: "Sessions"
      operationId: "deleteUserSession"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Sessions. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/auth/me/audit/logins:
    get:
      tags:
        - "Auth"
      summary: "Logins"
      operationId: "get_api_auth_me_audit_logins"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Logins. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/audit/revocations:
    get:
      tags:
        - "Auth"
      summary: "Revocations"
      operationId: "get_api_auth_me_audit_revocations"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Revocations. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/audit/devices:
    get:
      tags:
        - "Auth"
      summary: "Devices"
      operationId: "get_api_auth_me_audit_devices"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Devices. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/auth/me/audit/export:
    get:
      tags:
        - "Auth"
      summary: "Export"
      operationId: "get_api_auth_me_audit_export"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Export. Authentication endpoint for wallet-based access control. Free tier: 100 calls/day."
  /api/balances/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Balances"
      summary: "Balances"
      operationId: "get_api_balances_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Balances.  Free tier: 100 calls/day."
  /api/bitcoin/mempool:
    get:
      tags:
        - "Bitcoin"
      summary: "Mempool"
      operationId: "get_api_bitcoin_mempool"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Mempool. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/bitcoin/mempool/recent:
    get:
      tags:
        - "Bitcoin"
      summary: "Recent"
      operationId: "get_api_bitcoin_mempool_recent"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Recent. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/bitcoin/fees/recommended:
    get:
      tags:
        - "Bitcoin"
      summary: "Recommended"
      operationId: "get_api_bitcoin_fees_recommended"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Recommended. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/bitcoin/fees/mempool-blocks:
    get:
      tags:
        - "Bitcoin"
      summary: "Mempool-blocks"
      operationId: "get_api_bitcoin_fees_mempool_blocks"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Mempool-blocks. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/bitcoin/address/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Bitcoin"
      summary: "Address"
      operationId: "get_api_bitcoin_address_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Address. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/bitcoin/address/{address}/txs:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Bitcoin"
      summary: "Txs"
      operationId: "get_api_bitcoin_address_address_txs"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Txs. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/bitcoin/address/{address}/utxo:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Bitcoin"
      summary: "Utxo"
      operationId: "get_api_bitcoin_address_address_utxo"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Utxo. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/bitcoin/tx/{txid}:
    parameters:
      - name: "txid"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The txid parameter"
    get:
      tags:
        - "Bitcoin"
      summary: "Tx"
      operationId: "get_api_bitcoin_tx_txid_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Tx. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/bitcoin/tx/{txid}/status:
    parameters:
      - name: "txid"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The txid parameter"
    get:
      tags:
        - "Bitcoin"
      summary: "Status"
      operationId: "get_api_bitcoin_tx_txid_status"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Status. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/bitcoin/block/{hash}:
    parameters:
      - name: "hash"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The hash parameter"
    get:
      tags:
        - "Bitcoin"
      summary: "Block"
      operationId: "get_api_bitcoin_block_hash_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Block. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/bitcoin/block-height/{height}:
    parameters:
      - name: "height"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The height parameter"
    get:
      tags:
        - "Bitcoin"
      summary: "Block-height"
      operationId: "get_api_bitcoin_block_height_height_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Block-height. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/bitcoin/blocks:
    get:
      tags:
        - "Bitcoin"
      summary: "Blocks"
      operationId: "get_api_bitcoin_blocks"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Blocks. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/bitcoin/mining/pools:
    get:
      tags:
        - "Bitcoin"
      summary: "Pools"
      operationId: "get_api_bitcoin_mining_pools"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Pools. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/bitcoin/mining/hashrate:
    get:
      tags:
        - "Bitcoin"
      summary: "Hashrate"
      operationId: "get_api_bitcoin_mining_hashrate"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Hashrate. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/bitcoin/lightning/statistics:
    get:
      tags:
        - "Bitcoin"
      summary: "Statistics"
      operationId: "get_api_bitcoin_lightning_statistics"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "blockchain.info"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Statistics. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."
  /api/block/reward/{blockno}:
    parameters:
      - name: "blockno"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The blockno parameter"
    get:
      tags:
        - "Block"
      summary: "Reward"
      operationId: "get_api_block_reward_blockno_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nReward.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/block/countdown/{blockno}:
    parameters:
      - name: "blockno"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The blockno parameter"
    get:
      tags:
        - "Block"
      summary: "Countdown"
      operationId: "get_api_block_countdown_blockno_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCountdown.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/block/by-time/{timestamp}:
    parameters:
      - name: "timestamp"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The timestamp parameter"
    get:
      tags:
        - "Block"
      summary: "By-time"
      operationId: "get_api_block_by_time_timestamp_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBy-time.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/block:
    get:
      tags:
        - "Block"
      summary: "Block"
      operationId: "get_api_block"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Block.  Free tier: 100 calls/day."
  /api/block/multichain:
    get:
      tags:
        - "Block"
      summary: "Multichain"
      operationId: "get_api_block_multichain"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Multichain.  Free tier: 100 calls/day."
  /api/bridges/layerzero:
    get:
      tags:
        - "Bridges"
      summary: "Layerzero"
      operationId: "get_api_bridges_layerzero"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Layerzero.  Free tier: 100 calls/day."
  /api/bridges/cbridge:
    get:
      tags:
        - "Bridges"
      summary: "Cbridge"
      operationId: "get_api_bridges_cbridge"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Cbridge.  Free tier: 100 calls/day."
  /api/bridges/multichain:
    get:
      tags:
        - "Bridges"
      summary: "Multichain"
      operationId: "get_api_bridges_multichain"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Multichain.  Free tier: 100 calls/day."
  /api/bridges/arbitrum-base:
    get:
      tags:
        - "Bridges"
      summary: "Arbitrum-base"
      operationId: "get_api_bridges_arbitrum_base"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Arbitrum-base.  Free tier: 100 calls/day."
  /api/btc-dominance:
    get:
      tags:
        - "Btc-dominance"
      summary: "Btc-dominance"
      operationId: "get_api_btc_dominance"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Btc-dominance.  Free tier: 100 calls/day."
  /api/bundles/ethereum:
    get:
      tags:
        - "Bundles"
      summary: "Ethereum"
      operationId: "get_api_bundles_ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                sources:
                  - "coingecko"
                  - "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEthereum. Bundled data endpoints for efficient fetching. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/bundles/base:
    get:
      tags:
        - "Bundles"
      summary: "Base"
      operationId: "get_api_bundles_base"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                sources:
                  - "coingecko"
                  - "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBase. Bundled data endpoints for efficient fetching. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/bundles/arbitrum:
    get:
      tags:
        - "Bundles"
      summary: "Arbitrum"
      operationId: "get_api_bundles_arbitrum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                sources:
                  - "coingecko"
                  - "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nArbitrum. Bundled data endpoints for efficient fetching. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/bundles/optimism:
    get:
      tags:
        - "Bundles"
      summary: "Optimism"
      operationId: "get_api_bundles_optimism"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                sources:
                  - "coingecko"
                  - "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nOptimism. Bundled data endpoints for efficient fetching. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/bundles/polygon:
    get:
      tags:
        - "Bundles"
      summary: "Polygon"
      operationId: "get_api_bundles_polygon"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                sources:
                  - "coingecko"
                  - "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPolygon. Bundled data endpoints for efficient fetching. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/bundles/market:
    get:
      tags:
        - "Bundles"
      summary: "Market"
      operationId: "get_api_bundles_market"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                sources:
                  - "coingecko"
                  - "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMarket. Bundled data endpoints for efficient fetching. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/bundles/defi:
    get:
      tags:
        - "Bundles"
      summary: "Defi"
      operationId: "get_api_bundles_defi"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                sources:
                  - "coingecko"
                  - "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nDefi. Bundled data endpoints for efficient fetching. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/bundles/ens:
    post:
      tags:
        - "Bundles"
      summary: "Ens"
      operationId: "post_api_bundles_ens"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                sources:
                  - "coingecko"
                  - "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEns. Bundled data endpoints for efficient fetching. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/chains/harmony/stats:
    get:
      tags:
        - "Chains"
      summary: "Stats"
      operationId: "get_api_chains_harmony_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Stats.  Free tier: 100 calls/day."
  /api/chains/klaytn/stats:
    get:
      tags:
        - "Chains"
      summary: "Stats"
      operationId: "get_api_chains_klaytn_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Stats.  Free tier: 100 calls/day."
  /api/chains/kava/stats:
    get:
      tags:
        - "Chains"
      summary: "Stats"
      operationId: "get_api_chains_kava_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Stats.  Free tier: 100 calls/day."
  /api/chains/boba/stats:
    get:
      tags:
        - "Chains"
      summary: "Stats"
      operationId: "get_api_chains_boba_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Stats.  Free tier: 100 calls/day."
  /api/chains/algorand/stats:
    get:
      tags:
        - "Chains"
      summary: "Stats"
      operationId: "get_api_chains_algorand_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Stats.  Free tier: 100 calls/day."
  /api/coin/{id}:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coin"
      summary: "Coin"
      operationId: "get_api_coin_id_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Coin.  Free tier: 100 calls/day."
  /api/coincap/assets:
    get:
      tags:
        - "Coincap"
      summary: "Assets"
      operationId: "get_api_coincap_assets"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAssets. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coincap/asset/{id}:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coincap"
      summary: "Asset"
      operationId: "get_api_coincap_asset_id_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAsset. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coincap/asset/{id}/history:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coincap"
      summary: "History"
      operationId: "get_api_coincap_asset_id_history"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nHistory. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coincap/asset/{id}/markets:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coincap"
      summary: "Markets"
      operationId: "get_api_coincap_asset_id_markets"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMarkets. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coincap/rates:
    get:
      tags:
        - "Coincap"
      summary: "Rates"
      operationId: "get_api_coincap_rates"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nRates. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coincap/rate/{id}:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coincap"
      summary: "Rate"
      operationId: "get_api_coincap_rate_id_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nRate. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coincap/exchanges:
    get:
      tags:
        - "Coincap"
      summary: "Exchanges"
      operationId: "get_api_coincap_exchanges"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nExchanges. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coincap/exchange/{id}:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coincap"
      summary: "Exchange"
      operationId: "get_api_coincap_exchange_id_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nExchange. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coincap/markets:
    get:
      tags:
        - "Coincap"
      summary: "Markets"
      operationId: "get_api_coincap_markets"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMarkets. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coincap/candles:
    get:
      tags:
        - "Coincap"
      summary: "Candles"
      operationId: "get_api_coincap_candles"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCandles. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coincap/btc:
    get:
      tags:
        - "Coincap"
      summary: "Btc"
      operationId: "get_api_coincap_btc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBtc. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coincap/eth:
    get:
      tags:
        - "Coincap"
      summary: "Eth"
      operationId: "get_api_coincap_eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEth. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coincap/sol:
    get:
      tags:
        - "Coincap"
      summary: "Sol"
      operationId: "get_api_coincap_sol"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSol. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coincap/top10:
    get:
      tags:
        - "Coincap"
      summary: "Top10"
      operationId: "get_api_coincap_top10"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTop10. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coincap/top100:
    get:
      tags:
        - "Coincap"
      summary: "Top100"
      operationId: "get_api_coincap_top100"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "bitcoin"
                rank: 1
                symbol: "BTC"
                name: "Bitcoin"
                priceUsd: "45000.00"
                marketCapUsd: "850000000000"
                volumeUsd24Hr: "28000000000"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTop100. Real-time cryptocurrency data from CoinCap. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/global:
    get:
      tags:
        - "Coinpaprika"
      summary: "Global"
      operationId: "get_api_coinpaprika_global"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGlobal. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/coins:
    get:
      tags:
        - "Coinpaprika"
      summary: "Coins"
      operationId: "get_api_coinpaprika_coins"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCoins. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/coin/{id}:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "Coin"
      operationId: "get_api_coinpaprika_coin_id_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCoin. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/coin/{id}/ohlcv/today:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "Today"
      operationId: "get_api_coinpaprika_coin_id_ohlcv_today"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nToday. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/coin/{id}/ohlcv/historical:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "Historical"
      operationId: "get_api_coinpaprika_coin_id_ohlcv_historical"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nHistorical. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/coin/{id}/markets:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "Markets"
      operationId: "get_api_coinpaprika_coin_id_markets"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMarkets. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/coin/{id}/exchanges:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "Exchanges"
      operationId: "get_api_coinpaprika_coin_id_exchanges"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nExchanges. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/coin/{id}/twitter:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "Twitter"
      operationId: "get_api_coinpaprika_coin_id_twitter"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTwitter. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/coin/{id}/events:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "Events"
      operationId: "get_api_coinpaprika_coin_id_events"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEvents. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/tickers:
    get:
      tags:
        - "Coinpaprika"
      summary: "Tickers"
      operationId: "get_api_coinpaprika_tickers"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTickers. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/ticker/{id}:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "Ticker"
      operationId: "get_api_coinpaprika_ticker_id_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTicker. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/ticker/{id}/historical:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "Historical"
      operationId: "get_api_coinpaprika_ticker_id_historical"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nHistorical. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/exchanges:
    get:
      tags:
        - "Coinpaprika"
      summary: "Exchanges"
      operationId: "get_api_coinpaprika_exchanges"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nExchanges. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/exchange/{id}:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "Exchange"
      operationId: "get_api_coinpaprika_exchange_id_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nExchange. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/exchange/{id}/markets:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "Markets"
      operationId: "get_api_coinpaprika_exchange_id_markets"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMarkets. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/people/{id}:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "People"
      operationId: "get_api_coinpaprika_people_id_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPeople. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/tags:
    get:
      tags:
        - "Coinpaprika"
      summary: "Tags"
      operationId: "get_api_coinpaprika_tags"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTags. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/tag/{id}:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "Tag"
      operationId: "get_api_coinpaprika_tag_id_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTag. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/search:
    get:
      tags:
        - "Coinpaprika"
      summary: "Search"
      operationId: "get_api_coinpaprika_search"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSearch. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/price-converter:
    get:
      tags:
        - "Coinpaprika"
      summary: "Price-converter"
      operationId: "get_api_coinpaprika_price_converter"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPrice-converter. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/contracts/{platform}:
    parameters:
      - name: "platform"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The platform parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "Contracts"
      operationId: "get_api_coinpaprika_contracts_platform_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nContracts. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/contracts/{platform}/{address}:
    parameters:
      - name: "platform"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The platform parameter"
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Coinpaprika"
      summary: "Contracts"
      operationId: "get_api_coinpaprika_contracts_platform_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nContracts. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/btc:
    get:
      tags:
        - "Coinpaprika"
      summary: "Btc"
      operationId: "get_api_coinpaprika_btc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBtc. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/eth:
    get:
      tags:
        - "Coinpaprika"
      summary: "Eth"
      operationId: "get_api_coinpaprika_eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEth. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/ada:
    get:
      tags:
        - "Coinpaprika"
      summary: "Ada"
      operationId: "get_api_coinpaprika_ada"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAda. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/bnb:
    get:
      tags:
        - "Coinpaprika"
      summary: "Bnb"
      operationId: "get_api_coinpaprika_bnb"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBnb. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/avax:
    get:
      tags:
        - "Coinpaprika"
      summary: "Avax"
      operationId: "get_api_coinpaprika_avax"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAvax. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/sol:
    get:
      tags:
        - "Coinpaprika"
      summary: "Sol"
      operationId: "get_api_coinpaprika_sol"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSol. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coinpaprika/xrp:
    get:
      tags:
        - "Coinpaprika"
      summary: "Xrp"
      operationId: "get_api_coinpaprika_xrp"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                id: "btc-bitcoin"
                name: "Bitcoin"
                symbol: "BTC"
                price: 45000
                volume24h: 28000000000
                marketCap: 850000000000
                source: "coinpaprika"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nXrp. Cryptocurrency market data from CoinPaprika. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/collection/{contract}:
    parameters:
      - name: "contract"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The contract parameter"
    get:
      tags:
        - "Collection"
      summary: "Collection"
      operationId: "get_api_collection_contract_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Collection.  Free tier: 100 calls/day."
  /api/collection/{contract}/attributes:
    parameters:
      - name: "contract"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The contract parameter"
    get:
      tags:
        - "Collection"
      summary: "Attributes"
      operationId: "get_api_collection_contract_attributes"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Attributes.  Free tier: 100 calls/day."
  /api/collection/{contract}/sales:
    parameters:
      - name: "contract"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The contract parameter"
    get:
      tags:
        - "Collection"
      summary: "Sales"
      operationId: "get_api_collection_contract_sales"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Sales.  Free tier: 100 calls/day."
  /api/collections/search:
    get:
      tags:
        - "Collections"
      summary: "Search"
      operationId: "get_api_collections_search"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Search.  Free tier: 100 calls/day."
  /api/contract/abi/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Contract"
      summary: "Abi"
      operationId: "get_api_contract_abi_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAbi.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/contract/creation/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Contract"
      summary: "Creation"
      operationId: "get_api_contract_creation_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCreation.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/contracts/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Contracts"
      summary: "Contracts"
      operationId: "get_api_contracts_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Contracts.  Free tier: 100 calls/day."
  /api/convert/wei-to-eth/{wei}:
    parameters:
      - name: "wei"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The wei parameter"
    get:
      tags:
        - "Convert"
      summary: "Wei-to-eth"
      operationId: "get_api_convert_wei_to_eth_wei_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nWei-to-eth.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/convert/eth-to-wei/{eth}:
    parameters:
      - name: "eth"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The eth parameter"
    get:
      tags:
        - "Convert"
      summary: "Eth-to-wei"
      operationId: "get_api_convert_eth_to_wei_eth_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEth-to-wei.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/convert/gwei-to-wei/{gwei}:
    parameters:
      - name: "gwei"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The gwei parameter"
    get:
      tags:
        - "Convert"
      summary: "Gwei-to-wei"
      operationId: "get_api_convert_gwei_to_wei_gwei_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGwei-to-wei.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/convert/wei-to-gwei/{wei}:
    parameters:
      - name: "wei"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The wei parameter"
    get:
      tags:
        - "Convert"
      summary: "Wei-to-gwei"
      operationId: "get_api_convert_wei_to_gwei_wei_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nWei-to-gwei.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/convert/hex-to-dec/{hex}:
    parameters:
      - name: "hex"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The hex parameter"
    get:
      tags:
        - "Convert"
      summary: "Hex-to-dec"
      operationId: "get_api_convert_hex_to_dec_hex_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nHex-to-dec.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/convert/dec-to-hex/{dec}:
    parameters:
      - name: "dec"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The dec parameter"
    get:
      tags:
        - "Convert"
      summary: "Dec-to-hex"
      operationId: "get_api_convert_dec_to_hex_dec_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nDec-to-hex.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/count:
    get:
      tags:
        - "Count"
      summary: "Count"
      operationId: "get_api_count"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Count.  Free tier: 100 calls/day."
  /api/crypto-providers/stats:
    get:
      tags:
        - "Crypto-providers"
      summary: "Stats"
      operationId: "get_api_crypto_providers_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Stats.  Free tier: 100 calls/day."
  /api/dex/apeswap:
    get:
      tags:
        - "Dex"
      summary: "Apeswap"
      operationId: "get_api_dex_apeswap"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Apeswap.  Free tier: 100 calls/day."
  /api/dex/fraxswap:
    get:
      tags:
        - "Dex"
      summary: "Fraxswap"
      operationId: "get_api_dex_fraxswap"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Fraxswap.  Free tier: 100 calls/day."
  /api/dex/biswap:
    get:
      tags:
        - "Dex"
      summary: "Biswap"
      operationId: "get_api_dex_biswap"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Biswap.  Free tier: 100 calls/day."
  /api/dex/ramses:
    get:
      tags:
        - "Dex"
      summary: "Ramses"
      operationId: "get_api_dex_ramses"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Ramses.  Free tier: 100 calls/day."
  /api/dex/chronos:
    get:
      tags:
        - "Dex"
      summary: "Chronos"
      operationId: "get_api_dex_chronos"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Chronos.  Free tier: 100 calls/day."
  /api/dex/solidly:
    get:
      tags:
        - "Dex"
      summary: "Solidly"
      operationId: "get_api_dex_solidly"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Solidly.  Free tier: 100 calls/day."
  /api/ens/domain/{name}:
    parameters:
      - name: "name"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The name parameter"
    get:
      tags:
        - "Ens"
      summary: "Domain"
      operationId: "get_api_ens_domain_name_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "vitalik.eth"
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                avatar: "https://metadata.ens.domains/mainnet/avatar/example.eth"
                records: {}
                source: "ens"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Domain. Ethereum Name Service resolution and profiles. Free tier: 100 calls/day."
  /api/erc1155/transfers/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Erc1155"
      summary: "Transfers"
      operationId: "get_api_erc1155_transfers_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Transfers.  Free tier: 100 calls/day."
  /api/explorer/block/{block}:
    parameters:
      - name: "block"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The block parameter"
    get:
      tags:
        - "Explorer"
      summary: "Block"
      operationId: "get_api_explorer_block_block_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Block.  Free tier: 100 calls/day."
  /api/farcaster/{identifier}/casts:
    parameters:
      - name: "identifier"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The identifier parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Casts"
      operationId: "get_api_farcaster_identifier_casts"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Casts. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/{identifier}/followers:
    parameters:
      - name: "identifier"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The identifier parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Followers"
      operationId: "get_api_farcaster_identifier_followers"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Followers. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/{identifier}/following:
    parameters:
      - name: "identifier"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The identifier parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Following"
      operationId: "get_api_farcaster_identifier_following"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Following. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/search/users:
    get:
      tags:
        - "Farcaster"
      summary: "Search Farcaster users"
      description: "Search for Farcaster users by username or display name"
      operationId: "searchFarcasterUsers"
      parameters:
        - name: "q"
          in: "query"
          required: true
          schema:
            type: "string"
          description: "Search query"
          example: "vitalik"
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
            default: 10
          description: "Maximum results"
      responses:
        "200":
          description: "Search results"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/FarcasterSearchResult"
              example:
                query: "vitalik"
                users:
                  - fid: 5650
                    username: "vitalik.eth"
                    displayName: "Vitalik Buterin"
                    avatar: "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/471b3f42-fb38-44ef-0511-bcb7f7596e00/original"
                    followers: 534575
                  - fid: 1126133
                    username: "vitalikbui"
                    displayName: "Jaelani Indah"
                    avatar: "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/36cb6519-ba7e-4de3-1393-8ae4acc90a00/rectcrop3"
                    followers: 3195
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
  /api/farcaster/neynar/{identifier}:
    parameters:
      - name: "identifier"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The identifier parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Neynar"
      operationId: "get_api_farcaster_neynar_identifier_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Neynar. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/channel/{id}:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Channel"
      operationId: "get_api_farcaster_neynar_channel_id_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Channel. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/channels/bulk:
    get:
      tags:
        - "Farcaster"
      summary: "Bulk"
      operationId: "get_api_farcaster_neynar_channels_bulk"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Bulk. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/channels/search:
    get:
      tags:
        - "Farcaster"
      summary: "Search"
      operationId: "get_api_farcaster_neynar_channels_search"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Search. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/channels/trending:
    get:
      tags:
        - "Farcaster"
      summary: "Trending Farcaster channels (Neynar)"
      description: "Get trending Farcaster channels via Neynar API"
      operationId: "getNeynarTrendingChannels"
      parameters:
        - name: "limit"
          in: "query"
          schema:
            type: "integer"
            default: 10
          description: "Maximum channels to return"
      responses:
        "200":
          description: "Trending channels"
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  timeWindow:
                    type: "string"
                    description: "Time window for trending calculation"
                    example: "7d"
                  channels:
                    type: "array"
                    items:
                      type: "object"
                      properties:
                        object:
                          type: "string"
                        cast_count_1d:
                          type: "string"
                        cast_count_7d:
                          type: "string"
                        cast_count_30d:
                          type: "string"
                        channel:
                          $ref: "#/components/schemas/FarcasterChannel"
              example:
                timeWindow: "7d"
                channels:
                  - object: "channel_activity"
                    cast_count_1d: "0"
                    cast_count_7d: "32"
                    cast_count_30d: "32"
                    channel:
                      id: "fruitling-valley"
                      name: "fruitling-valley"
                      description: "Fully onchain farming game. Live on Base."
                      imageUrl: "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/a7dbb6f9-c977-4862-38fd-5461fb38cf00/original"
                      followerCount: 185
                      memberCount: 2
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
  /api/farcaster/neynar/channel/{id}/followers:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Followers"
      operationId: "get_api_farcaster_neynar_channel_id_followers"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Followers. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/cast/{hash}:
    parameters:
      - name: "hash"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The hash parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Cast"
      operationId: "get_api_farcaster_neynar_cast_hash_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Cast. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/cast/{hash}/conversation:
    parameters:
      - name: "hash"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The hash parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Conversation"
      operationId: "get_api_farcaster_neynar_cast_hash_conversation"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Conversation. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/feed/for-you/{fid}:
    parameters:
      - name: "fid"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The fid parameter"
    get:
      tags:
        - "Farcaster"
      summary: "For-you"
      operationId: "get_api_farcaster_neynar_feed_for_you_fid_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "For-you. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/feed/following/{fid}:
    parameters:
      - name: "fid"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The fid parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Following"
      operationId: "get_api_farcaster_neynar_feed_following_fid_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Following. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/users/power:
    get:
      tags:
        - "Farcaster"
      summary: "Power"
      operationId: "get_api_farcaster_neynar_users_power"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Power. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/search/casts:
    get:
      tags:
        - "Farcaster"
      summary: "Casts"
      operationId: "get_api_farcaster_neynar_search_casts"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Casts. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/search/users:
    get:
      tags:
        - "Farcaster"
      summary: "Users"
      operationId: "get_api_farcaster_neynar_search_users"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Users. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/cast/{hash}/quotes:
    parameters:
      - name: "hash"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The hash parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Quotes"
      operationId: "get_api_farcaster_neynar_cast_hash_quotes"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Quotes. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/cast/{hash}/reactions:
    parameters:
      - name: "hash"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The hash parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Reactions"
      operationId: "get_api_farcaster_neynar_cast_hash_reactions"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Reactions. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/channel/{id}/members:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Members"
      operationId: "get_api_farcaster_neynar_channel_id_members"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Members. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/user/{fid}/popular:
    parameters:
      - name: "fid"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The fid parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Popular"
      operationId: "get_api_farcaster_neynar_user_fid_popular"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Popular. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/user/{fid}/activity:
    parameters:
      - name: "fid"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The fid parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Activity"
      operationId: "get_api_farcaster_neynar_user_fid_activity"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Activity. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/users/trending:
    get:
      tags:
        - "Farcaster"
      summary: "Trending"
      operationId: "get_api_farcaster_neynar_users_trending"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Trending. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/user/{fid}/channels:
    parameters:
      - name: "fid"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The fid parameter"
    get:
      tags:
        - "Farcaster"
      summary: "Channels"
      operationId: "get_api_farcaster_neynar_user_fid_channels"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Channels. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/farcaster/neynar/frame/validate:
    post:
      tags:
        - "Farcaster"
      summary: "Validate"
      operationId: "post_api_farcaster_neynar_frame_validate"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Validate. Farcaster social network data via Neynar API. Free tier: 100 calls/day."
  /api/fees/optimism:
    get:
      tags:
        - "Fees"
      summary: "Optimism"
      operationId: "get_api_fees_optimism"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Optimism.  Free tier: 100 calls/day."
  /api/fees/polygon:
    get:
      tags:
        - "Fees"
      summary: "Polygon"
      operationId: "get_api_fees_polygon"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Polygon.  Free tier: 100 calls/day."
  /api/fees/solana:
    get:
      tags:
        - "Fees"
      summary: "Solana"
      operationId: "get_api_fees_solana"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Solana.  Free tier: 100 calls/day."
  /api/fees/bsc:
    get:
      tags:
        - "Fees"
      summary: "Bsc"
      operationId: "get_api_fees_bsc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Bsc.  Free tier: 100 calls/day."
  /api/fees/avalanche:
    get:
      tags:
        - "Fees"
      summary: "Avalanche"
      operationId: "get_api_fees_avalanche"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Avalanche.  Free tier: 100 calls/day."
  /api/fees/fantom:
    get:
      tags:
        - "Fees"
      summary: "Fantom"
      operationId: "get_api_fees_fantom"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Fantom.  Free tier: 100 calls/day."
  /api/fees/gnosis:
    get:
      tags:
        - "Fees"
      summary: "Gnosis"
      operationId: "get_api_fees_gnosis"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Gnosis.  Free tier: 100 calls/day."
  /api/floor/{contract}:
    parameters:
      - name: "contract"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The contract parameter"
    get:
      tags:
        - "Floor"
      summary: "Floor"
      operationId: "get_api_floor_contract_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Floor.  Free tier: 100 calls/day."
  /api/gas/avalanche:
    get:
      tags:
        - "Gas"
      summary: "Avalanche"
      operationId: "get_api_gas_avalanche"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "ethereum"
                slow: 15
                standard: 20
                fast: 25
                unit: "gwei"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Avalanche. Blockchain gas price tracking. Free tier: 100 calls/day."
  /api/gas/multichain:
    get:
      tags:
        - "Gas"
      summary: "Multichain"
      operationId: "get_api_gas_multichain"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "ethereum"
                slow: 15
                standard: 20
                fast: 25
                unit: "gwei"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Multichain. Blockchain gas price tracking. Free tier: 100 calls/day."
  /api/gas/{chain}:
    parameters:
      - name: "chain"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The chain parameter"
    get:
      tags:
        - "Gas"
      summary: "Gas"
      operationId: "get_api_gas_chain_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "ethereum"
                slow: 15
                standard: 20
                fast: 25
                unit: "gwei"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Gas. Blockchain gas price tracking. Free tier: 100 calls/day."
  /ccip/health:
    get:
      tags:
        - "Health"
      summary: "Health"
      operationId: "get_ccip_health"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Health.  Free tier: 100 calls/day."
  /api/historical/btc/{days}:
    parameters:
      - name: "days"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The days parameter"
    get:
      tags:
        - "Historical"
      summary: "Btc"
      operationId: "get_api_historical_btc_days_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Btc.  Free tier: 100 calls/day."
  /api/historical/eth/{days}:
    parameters:
      - name: "days"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The days parameter"
    get:
      tags:
        - "Historical"
      summary: "Eth"
      operationId: "get_api_historical_eth_days_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Eth.  Free tier: 100 calls/day."
  /api/historical/marketcap/{token}/{days}:
    parameters:
      - name: "token"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The token parameter"
      - name: "days"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The days parameter"
    get:
      tags:
        - "Historical"
      summary: "Marketcap"
      operationId: "get_api_historical_marketcap_token_days_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Marketcap.  Free tier: 100 calls/day."
  /api/holders/{contract}:
    parameters:
      - name: "contract"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The contract parameter"
    get:
      tags:
        - "Holders"
      summary: "Holders"
      operationId: "get_api_holders_contract_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Holders.  Free tier: 100 calls/day."
  /api/image-proxy:
    get:
      tags:
        - "Image-proxy"
      summary: "Image-proxy"
      operationId: "get_api_image_proxy"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Image-proxy.  Free tier: 100 calls/day."
  /api/keys/keys:
    get:
      tags:
        - "Keys"
      summary: "Keys"
      operationId: "get_api_keys_keys"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nKeys.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/keys/keys/{keyId}:
    parameters:
      - name: "keyId"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The keyId parameter"
    delete:
      tags:
        - "Keys"
      summary: "Keys"
      operationId: "deleteKeyById"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nKeys.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/keys/credits/pricing:
    get:
      tags:
        - "Keys"
      summary: "Pricing"
      operationId: "get_api_keys_credits_pricing"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPricing.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/keys/credits/{keyId}:
    parameters:
      - name: "keyId"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The keyId parameter"
    get:
      tags:
        - "Keys"
      summary: "Credits"
      operationId: "getKeyCredits"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCredits.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/keys/credits/{keyId}/purchase:
    parameters:
      - name: "keyId"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The keyId parameter"
    post:
      tags:
        - "Keys"
      summary: "Purchase"
      operationId: "purchaseKeyCredits"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPurchase.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/l2/polygon-zkevm:
    get:
      tags:
        - "L2"
      summary: "Polygon-zkevm"
      operationId: "get_api_l2_polygon_zkevm"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                chain: "arbitrum"
                tvl: 5000000000
                gasPrice: "0.1 gwei"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Polygon-zkevm.  Free tier: 100 calls/day."
  /api/lending/centrifuge:
    get:
      tags:
        - "Lending"
      summary: "Centrifuge"
      operationId: "get_api_lending_centrifuge"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Centrifuge.  Free tier: 100 calls/day."
  /api/lending/clearpool:
    get:
      tags:
        - "Lending"
      summary: "Clearpool"
      operationId: "get_api_lending_clearpool"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Clearpool.  Free tier: 100 calls/day."
  /api/lending/geist:
    get:
      tags:
        - "Lending"
      summary: "Geist"
      operationId: "get_api_lending_geist"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Geist.  Free tier: 100 calls/day."
  /api/lending/exactly:
    get:
      tags:
        - "Lending"
      summary: "Exactly"
      operationId: "get_api_lending_exactly"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Exactly.  Free tier: 100 calls/day."
  /api/lending/sturdy:
    get:
      tags:
        - "Lending"
      summary: "Sturdy"
      operationId: "get_api_lending_sturdy"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Sturdy.  Free tier: 100 calls/day."
  /api/lens/accounts:
    get:
      tags:
        - "Lens"
      summary: "Accounts"
      operationId: "get_api_lens_accounts"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                handle: "stani.lens"
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                followers: 50000
                following: 500
                source: "lens"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Accounts. Lens Protocol social graph data. Free tier: 100 calls/day."
  /api/lens/health:
    get:
      tags:
        - "Lens"
      summary: "Health"
      operationId: "get_api_lens_health"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                handle: "stani.lens"
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                followers: 50000
                following: 500
                source: "lens"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Health. Lens Protocol social graph data. Free tier: 100 calls/day."
  /api/lido/stats:
    get:
      tags:
        - "Lido"
      summary: "Stats"
      operationId: "get_api_lido_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Stats.  Free tier: 100 calls/day."
  /api/logs/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Logs"
      summary: "Logs"
      operationId: "get_api_logs_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Logs.  Free tier: 100 calls/day."
  /og/lookup/{nameOrAddress}:
    parameters:
      - name: "nameOrAddress"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The nameOrAddress parameter"
    get:
      tags:
        - "Lookup"
      summary: "Lookup"
      operationId: "getOgLookup"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Lookup.  Free tier: 100 calls/day."
  /api/market/coin/{id}/tickers:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
    get:
      tags:
        - "Market"
      summary: "Tickers"
      operationId: "get_api_market_coin_id_tickers"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                totalMarketCap: 2000000000000
                totalVolume24h: 100000000000
                btcDominance: 45.5
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Tickers. Cryptocurrency market overview and statistics. Free tier: 100 calls/day."
  /api/market/coin/{id}/history/{date}:
    parameters:
      - name: "id"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The id parameter"
      - name: "date"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The date parameter"
    get:
      tags:
        - "Market"
      summary: "History"
      operationId: "get_api_market_coin_id_history_date_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                totalMarketCap: 2000000000000
                totalVolume24h: 100000000000
                btcDominance: 45.5
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "History. Cryptocurrency market overview and statistics. Free tier: 100 calls/day."
  /api/market/contract/{platform}/{address}:
    parameters:
      - name: "platform"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The platform parameter"
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Market"
      summary: "Contract"
      operationId: "get_api_market_contract_platform_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                totalMarketCap: 2000000000000
                totalVolume24h: 100000000000
                btcDominance: 45.5
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Contract. Cryptocurrency market overview and statistics. Free tier: 100 calls/day."
  /api/market/contract/{platform}/{address}/chart:
    parameters:
      - name: "platform"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The platform parameter"
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Market"
      summary: "Chart"
      operationId: "get_api_market_contract_platform_address_chart"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                totalMarketCap: 2000000000000
                totalVolume24h: 100000000000
                btcDominance: 45.5
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Chart. Cryptocurrency market overview and statistics. Free tier: 100 calls/day."
  /api/market/platforms:
    get:
      tags:
        - "Market"
      summary: "Platforms"
      operationId: "get_api_market_platforms"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                totalMarketCap: 2000000000000
                totalVolume24h: 100000000000
                btcDominance: 45.5
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Platforms. Cryptocurrency market overview and statistics. Free tier: 100 calls/day."
  /api/market/currencies:
    get:
      tags:
        - "Market"
      summary: "Currencies"
      operationId: "get_api_market_currencies"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                totalMarketCap: 2000000000000
                totalVolume24h: 100000000000
                btcDominance: 45.5
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Currencies. Cryptocurrency market overview and statistics. Free tier: 100 calls/day."
  /api/market/treasuries/{coin}:
    parameters:
      - name: "coin"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The coin parameter"
    get:
      tags:
        - "Market"
      summary: "Treasuries"
      operationId: "get_api_market_treasuries_coin_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                totalMarketCap: 2000000000000
                totalVolume24h: 100000000000
                btcDominance: 45.5
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Treasuries. Cryptocurrency market overview and statistics. Free tier: 100 calls/day."
  /api/market/exchange-rates:
    get:
      tags:
        - "Market"
      summary: "Exchange-rates"
      operationId: "get_api_market_exchange_rates"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                totalMarketCap: 2000000000000
                totalVolume24h: 100000000000
                btcDominance: 45.5
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Exchange-rates. Cryptocurrency market overview and statistics. Free tier: 100 calls/day."
  /api/messari/assets:
    get:
      tags:
        - "Messari"
      summary: "Assets"
      operationId: "get_api_messari_assets"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAssets.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/messari/asset/{asset}:
    parameters:
      - name: "asset"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The asset parameter"
    get:
      tags:
        - "Messari"
      summary: "Asset"
      operationId: "get_api_messari_asset_asset_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAsset.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/messari/asset/{asset}/metrics:
    parameters:
      - name: "asset"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The asset parameter"
    get:
      tags:
        - "Messari"
      summary: "Metrics"
      operationId: "get_api_messari_asset_asset_metrics"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMetrics.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/messari/asset/{asset}/profile:
    parameters:
      - name: "asset"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The asset parameter"
    get:
      tags:
        - "Messari"
      summary: "Profile"
      operationId: "get_api_messari_asset_asset_profile"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nProfile.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/messari/asset/{asset}/market-data:
    parameters:
      - name: "asset"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The asset parameter"
    get:
      tags:
        - "Messari"
      summary: "Market-data"
      operationId: "get_api_messari_asset_asset_market_data"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMarket-data.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/messari/news:
    get:
      tags:
        - "Messari"
      summary: "News"
      operationId: "get_api_messari_news"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nNews.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/messari/news/{asset}:
    parameters:
      - name: "asset"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The asset parameter"
    get:
      tags:
        - "Messari"
      summary: "News"
      operationId: "get_api_messari_news_asset_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nNews.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/messari/markets:
    get:
      tags:
        - "Messari"
      summary: "Markets"
      operationId: "get_api_messari_markets"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMarkets.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/network/bsc/status:
    get:
      tags:
        - "Network"
      summary: "Status"
      operationId: "get_api_network_bsc_status"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Status.  Free tier: 100 calls/day."
  /api/network/avalanche/status:
    get:
      tags:
        - "Network"
      summary: "Status"
      operationId: "get_api_network_avalanche_status"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Status.  Free tier: 100 calls/day."
  /api/network/fantom/status:
    get:
      tags:
        - "Network"
      summary: "Status"
      operationId: "get_api_network_fantom_status"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Status.  Free tier: 100 calls/day."
  /api/network/gnosis/status:
    get:
      tags:
        - "Network"
      summary: "Status"
      operationId: "get_api_network_gnosis_status"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Status.  Free tier: 100 calls/day."
  /api/nft/{contract}/{tokenId}:
    parameters:
      - name: "contract"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The contract parameter"
      - name: "tokenId"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The tokenId parameter"
    get:
      tags:
        - "Nft"
      summary: "Nft"
      operationId: "getNftToken"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                collection: "CryptoPunks"
                floorPrice: 50
                volume24h: 1000
                items: 10000
                owners: 3500
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nNft. NFT metadata and collection data. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/{contract}/{tokenId}/rarity:
    parameters:
      - name: "contract"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The contract parameter"
      - name: "tokenId"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The tokenId parameter"
    get:
      tags:
        - "Nft"
      summary: "Rarity"
      operationId: "getNftTokenRarity"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                collection: "CryptoPunks"
                floorPrice: 50
                volume24h: 1000
                items: 10000
                owners: 3500
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nRarity. NFT metadata and collection data. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/transfers/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Nft"
      summary: "Transfers"
      operationId: "get_api_nft_transfers_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                collection: "CryptoPunks"
                floorPrice: 50
                volume24h: 1000
                items: 10000
                owners: 3500
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTransfers. NFT metadata and collection data. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /oauth/.well-known/openid-configuration:
    get:
      tags:
        - "OAuth"
      summary: "Openid-configuration"
      operationId: "get_api_oauth_.well_known_openid_configuration"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x...)"
          schema:
            type: "string"
            example: 1.2380129724542482e+48
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Openid-configuration.  Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /oauth/.well-known/jwks.json:
    get:
      tags:
        - "OAuth"
      summary: "Jwks.json"
      operationId: "get_api_oauth_.well_known_jwks.json"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x...)"
          schema:
            type: "string"
            example: 1.2380129724542482e+48
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Jwks.json.  Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /oauth/authorize:
    get:
      tags:
        - "OAuth"
      summary: "Authorize"
      operationId: "get_api_oauth_authorize"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x...)"
          schema:
            type: "string"
            example: 1.2380129724542482e+48
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Authorize.  Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /oauth/login:
    get:
      tags:
        - "OAuth"
      summary: "Login"
      operationId: "get_api_oauth_login"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x...)"
          schema:
            type: "string"
            example: 1.2380129724542482e+48
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Login.  Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /oauth/complete:
    post:
      tags:
        - "OAuth"
      summary: "Complete"
      operationId: "post_api_oauth_complete"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x...)"
          schema:
            type: "string"
            example: 1.2380129724542482e+48
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Complete.  Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /oauth/token:
    post:
      tags:
        - "OAuth"
      summary: "Token"
      operationId: "post_api_oauth_token"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x...)"
          schema:
            type: "string"
            example: 1.2380129724542482e+48
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Token.  Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /oauth/introspect:
    post:
      tags:
        - "OAuth"
      summary: "Introspect"
      operationId: "post_api_oauth_introspect"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x...)"
          schema:
            type: "string"
            example: 1.2380129724542482e+48
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Introspect.  Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /oauth/revoke:
    post:
      tags:
        - "OAuth"
      summary: "Revoke"
      operationId: "post_api_oauth_revoke"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x...)"
          schema:
            type: "string"
            example: 1.2380129724542482e+48
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Revoke.  Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /oauth/register:
    post:
      tags:
        - "OAuth"
      summary: "Register"
      operationId: "post_api_oauth_register"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address (0x...)"
          schema:
            type: "string"
            example: 1.2380129724542482e+48
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Register.  Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /oauth/health:
    get:
      tags:
        - "OAuth"
      summary: "Health"
      operationId: "get_api_oauth_health"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Health.  Free tier: 100 calls/day."
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
  /api/owners/{contract}:
    parameters:
      - name: "contract"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The contract parameter"
    get:
      tags:
        - "Owners"
      summary: "Owners"
      operationId: "get_api_owners_contract_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Owners.  Free tier: 100 calls/day."
  /api/pending-txs:
    get:
      tags:
        - "Pending-txs"
      summary: "Pending-txs"
      operationId: "get_api_pending_txs"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Pending-txs.  Free tier: 100 calls/day."
  /api/price/batch:
    get:
      tags:
        - "Price"
      summary: "Batch price lookup"
      description: "Get prices for multiple tokens in a single request"
      operationId: "getPriceBatch"
      parameters:
        - name: "symbols"
          in: "query"
          schema:
            type: "string"
          description: "Comma-separated token symbols"
          example: "ETH,BTC,USDC"
        - name: "tokens"
          in: "query"
          schema:
            type: "string"
          description: "Comma-separated token IDs (alternative to symbols)"
          example: "ethereum,bitcoin"
      responses:
        "200":
          description: "Batch price results"
          content:
            application/json:
              schema:
                type: "object"
                required:
                  - "count"
                  - "prices"
                  - "timestamp"
                properties:
                  count:
                    type: "number"
                    description: "Number of prices returned"
                  prices:
                    type: "object"
                    additionalProperties:
                      type: "object"
                      properties:
                        price:
                          type: "number"
                        change24h:
                          type: "number"
                        marketCap:
                          type: "number"
                        volume24h:
                          type: "number"
                    description: "Map of symbol to price data"
                  cached:
                    type: "boolean"
                  cachedAt:
                    type: "string"
                    format: "date-time"
                    nullable: true
                  timestamp:
                    type: "string"
                    format: "date-time"
              example:
                count: 3
                prices:
                  ETH:
                    price: 1990.91
                    change24h: 2.47
                    marketCap: 239400000000
                    volume24h: 12500000000
                  BTC:
                    price: 67406.77
                    change24h: -0.82
                    marketCap: 1324000000000
                    volume24h: 28700000000
                  USDC:
                    price: 1.0001
                    change24h: 0.01
                cached: false
                cachedAt: null
                timestamp: "2026-02-18T00:35:41.573Z"
        "402":
          description: "Payment Required"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
  /api/price/batch/metrics:
    get:
      tags:
        - "Price"
      summary: "Batch price request metrics"
      description: "Get metrics about batch price API usage and performance"
      operationId: "getPriceBatchMetrics"
      responses:
        "200":
          description: "Batch metrics"
          content:
            application/json:
              schema:
                type: "array"
                items:
                  type: "object"
                  properties:
                    token:
                      type: "string"
                      description: "Token symbol"
                    requests:
                      type: "integer"
                      description: "Number of requests"
                    avgResponseTime:
                      type: "number"
                      description: "Average response time in ms"
              example: []
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
  /api/protocol/{slug}:
    parameters:
      - name: "slug"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The slug parameter"
    get:
      tags:
        - "Protocol"
      summary: "Protocol"
      operationId: "get_api_protocol_slug_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nProtocol. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/{slug}/tvl:
    parameters:
      - name: "slug"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The slug parameter"
    get:
      tags:
        - "Protocol"
      summary: "Tvl"
      operationId: "get_api_protocol_slug_tvl"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTvl. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/{slug}/chains:
    parameters:
      - name: "slug"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The slug parameter"
    get:
      tags:
        - "Protocol"
      summary: "Chains"
      operationId: "get_api_protocol_slug_chains"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nChains. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/{slug}/fees:
    parameters:
      - name: "slug"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The slug parameter"
    get:
      tags:
        - "Protocol"
      summary: "Fees"
      operationId: "get_api_protocol_slug_fees"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFees. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/{slug}/revenue:
    parameters:
      - name: "slug"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The slug parameter"
    get:
      tags:
        - "Protocol"
      summary: "Revenue"
      operationId: "get_api_protocol_slug_revenue"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nRevenue. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/category/staking:
    get:
      tags:
        - "Protocol"
      summary: "Staking"
      operationId: "get_api_protocol_category_staking"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStaking. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/category/lending:
    get:
      tags:
        - "Protocol"
      summary: "Lending"
      operationId: "get_api_protocol_category_lending"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nLending. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/category/dex:
    get:
      tags:
        - "Protocol"
      summary: "Dex"
      operationId: "get_api_protocol_category_dex"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nDex. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/category/bridges:
    get:
      tags:
        - "Protocol"
      summary: "Bridges"
      operationId: "get_api_protocol_category_bridges"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBridges. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/category/derivatives:
    get:
      tags:
        - "Protocol"
      summary: "Derivatives"
      operationId: "get_api_protocol_category_derivatives"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nDerivatives. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/search:
    get:
      tags:
        - "Protocol"
      summary: "Search"
      operationId: "get_api_protocol_search"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSearch. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/categories:
    get:
      tags:
        - "Protocol"
      summary: "Categories"
      operationId: "get_api_protocol_categories"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCategories. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/rank/{rank}:
    parameters:
      - name: "rank"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The rank parameter"
    get:
      tags:
        - "Protocol"
      summary: "Rank"
      operationId: "get_api_protocol_rank_rank_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nRank. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/chain/ethereum:
    get:
      tags:
        - "Protocol"
      summary: "Ethereum"
      operationId: "get_api_protocol_chain_ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEthereum. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/chain/base:
    get:
      tags:
        - "Protocol"
      summary: "Base"
      operationId: "get_api_protocol_chain_base"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBase. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/chain/arbitrum:
    get:
      tags:
        - "Protocol"
      summary: "Arbitrum"
      operationId: "get_api_protocol_chain_arbitrum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nArbitrum. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/chain/optimism:
    get:
      tags:
        - "Protocol"
      summary: "Optimism"
      operationId: "get_api_protocol_chain_optimism"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nOptimism. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/chain/polygon:
    get:
      tags:
        - "Protocol"
      summary: "Polygon"
      operationId: "get_api_protocol_chain_polygon"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPolygon. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/chain/solana:
    get:
      tags:
        - "Protocol"
      summary: "Solana"
      operationId: "get_api_protocol_chain_solana"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSolana. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/chain/bsc:
    get:
      tags:
        - "Protocol"
      summary: "Bsc"
      operationId: "get_api_protocol_chain_bsc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBsc. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/chain/avalanche:
    get:
      tags:
        - "Protocol"
      summary: "Avalanche"
      operationId: "get_api_protocol_chain_avalanche"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAvalanche. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/etherfi:
    get:
      tags:
        - "Protocol"
      summary: "Etherfi"
      operationId: "get_api_protocol_etherfi"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEtherfi. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/renzo:
    get:
      tags:
        - "Protocol"
      summary: "Renzo"
      operationId: "get_api_protocol_renzo"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nRenzo. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/kelp:
    get:
      tags:
        - "Protocol"
      summary: "Kelp"
      operationId: "get_api_protocol_kelp"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nKelp. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/swell:
    get:
      tags:
        - "Protocol"
      summary: "Swell"
      operationId: "get_api_protocol_swell"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSwell. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/liquity:
    get:
      tags:
        - "Protocol"
      summary: "Liquity"
      operationId: "get_api_protocol_liquity"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nLiquity. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/euler:
    get:
      tags:
        - "Protocol"
      summary: "Euler"
      operationId: "get_api_protocol_euler"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEuler. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/stargate:
    get:
      tags:
        - "Protocol"
      summary: "Stargate"
      operationId: "get_api_protocol_stargate"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStargate. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/layerzero:
    get:
      tags:
        - "Protocol"
      summary: "Layerzero"
      operationId: "get_api_protocol_layerzero"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nLayerzero. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/wormhole:
    get:
      tags:
        - "Protocol"
      summary: "Wormhole"
      operationId: "get_api_protocol_wormhole"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nWormhole. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/puffer:
    get:
      tags:
        - "Protocol"
      summary: "Puffer"
      operationId: "get_api_protocol_puffer"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPuffer. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/mantle-lsp:
    get:
      tags:
        - "Protocol"
      summary: "Mantle-lsp"
      operationId: "get_api_protocol_mantle_lsp"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMantle-lsp. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/dydx:
    get:
      tags:
        - "Protocol"
      summary: "Dydx"
      operationId: "get_api_protocol_dydx"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nDydx. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/blur:
    get:
      tags:
        - "Protocol"
      summary: "Blur"
      operationId: "get_api_protocol_blur"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBlur. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/opensea:
    get:
      tags:
        - "Protocol"
      summary: "Opensea"
      operationId: "get_api_protocol_opensea"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nOpensea. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/polymarket:
    get:
      tags:
        - "Protocol"
      summary: "Polymarket"
      operationId: "get_api_protocol_polymarket"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPolymarket. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/ethena:
    get:
      tags:
        - "Protocol"
      summary: "Ethena"
      operationId: "get_api_protocol_ethena"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEthena. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/lido/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_lido_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/pendle/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_pendle_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/convex/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_convex_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/yearn/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_yearn_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/instadapp/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_instadapp_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/stargate/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_stargate_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/layerzero/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_layerzero_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/wormhole/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_wormhole_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/frax/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_frax_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/liquity/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_liquity_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/rocketpool/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_rocketpool_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/euler/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_euler_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/swell/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_swell_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/renzo/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_renzo_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/etherfi/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_etherfi_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/kelp/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_kelp_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/puffer/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_puffer_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/gmx/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_gmx_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/dydx/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_dydx_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/blur/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_blur_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/opensea/stats:
    get:
      tags:
        - "Protocol"
      summary: "Stats"
      operationId: "get_api_protocol_opensea_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStats. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/maker:
    get:
      tags:
        - "Protocol"
      summary: "Maker"
      operationId: "get_api_protocol_maker"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMaker. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/uniswap:
    get:
      tags:
        - "Protocol"
      summary: "Uniswap"
      operationId: "get_api_protocol_uniswap"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nUniswap. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/aave:
    get:
      tags:
        - "Protocol"
      summary: "Aave"
      operationId: "get_api_protocol_aave"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAave. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/compound:
    get:
      tags:
        - "Protocol"
      summary: "Compound"
      operationId: "get_api_protocol_compound"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCompound. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/curve:
    get:
      tags:
        - "Protocol"
      summary: "Curve"
      operationId: "get_api_protocol_curve"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCurve. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/pancakeswap:
    get:
      tags:
        - "Protocol"
      summary: "Pancakeswap"
      operationId: "get_api_protocol_pancakeswap"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPancakeswap. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/sushiswap:
    get:
      tags:
        - "Protocol"
      summary: "Sushiswap"
      operationId: "get_api_protocol_sushiswap"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSushiswap. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/1inch:
    get:
      tags:
        - "Protocol"
      summary: "1inch"
      operationId: "get_api_protocol_1inch"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\n1inch. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/protocol/paraswap:
    get:
      tags:
        - "Protocol"
      summary: "Paraswap"
      operationId: "get_api_protocol_paraswap"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "Aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                category: "Lending"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nParaswap. DeFi protocol data from DeFiLlama. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/qrcode:
    get:
      tags:
        - "Qrcode"
      summary: "Qrcode"
      operationId: "get_api_qrcode_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Qrcode.  Free tier: 100 calls/day."
  /api/qrcode/url:
    get:
      tags:
        - "Qrcode"
      summary: "Url"
      operationId: "get_api_qrcode_url"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nUrl.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/qrcode/address/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Qrcode"
      summary: "Address"
      operationId: "get_api_qrcode_address_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAddress.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/qrcode/ens/{name}:
    parameters:
      - name: "name"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The name parameter"
    get:
      tags:
        - "Qrcode"
      summary: "Ens"
      operationId: "get_api_qrcode_ens_name_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEns.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/qrcode/payment:
    get:
      tags:
        - "Qrcode"
      summary: "Payment"
      operationId: "get_api_qrcode_payment"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPayment.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/qrcode/profile/{name}:
    parameters:
      - name: "name"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The name parameter"
    get:
      tags:
        - "Qrcode"
      summary: "Profile"
      operationId: "get_api_qrcode_profile_name_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nProfile.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/query/{subgraph}:
    parameters:
      - name: "subgraph"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The subgraph parameter"
    post:
      tags:
        - "Query"
      summary: "Query"
      operationId: "post_api_query_subgraph_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Query.  Free tier: 100 calls/day."
  /api/revenue/base:
    get:
      tags:
        - "Revenue"
      summary: "Base"
      operationId: "get_api_revenue_base"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Base.  Free tier: 100 calls/day."
  /api/revenue/arbitrum:
    get:
      tags:
        - "Revenue"
      summary: "Arbitrum"
      operationId: "get_api_revenue_arbitrum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Arbitrum.  Free tier: 100 calls/day."
  /api/revenue/optimism:
    get:
      tags:
        - "Revenue"
      summary: "Optimism"
      operationId: "get_api_revenue_optimism"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Optimism.  Free tier: 100 calls/day."
  /api/revenue/solana:
    get:
      tags:
        - "Revenue"
      summary: "Solana"
      operationId: "get_api_revenue_solana"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Solana.  Free tier: 100 calls/day."
  /api/safe/{address}/balances:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Safe"
      summary: "Balances"
      operationId: "get_api_safe_address_balances"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Balances.  Free tier: 100 calls/day."
  /api/safe/{address}/transactions:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Safe"
      summary: "Transactions"
      operationId: "get_api_safe_address_transactions"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Transactions.  Free tier: 100 calls/day."
  /api/safe/{address}/pending:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Safe"
      summary: "Pending"
      operationId: "get_api_safe_address_pending"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Pending.  Free tier: 100 calls/day."
  /api/safe/{address}/owners:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Safe"
      summary: "Owners"
      operationId: "get_api_safe_address_owners"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Owners.  Free tier: 100 calls/day."
  /api/safe/check/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Safe"
      summary: "Check"
      operationId: "get_api_safe_check_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Check.  Free tier: 100 calls/day."
  /api/sales/{contract}:
    parameters:
      - name: "contract"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The contract parameter"
    get:
      tags:
        - "Sales"
      summary: "Sales"
      operationId: "get_api_sales_contract_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Sales.  Free tier: 100 calls/day."
  /api/security/honeypot/{chain}/{address}:
    parameters:
      - name: "chain"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The chain parameter"
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Security"
      summary: "Honeypot"
      operationId: "get_api_security_honeypot_chain_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                score: 85
                risks: []
                verified: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Honeypot.  Free tier: 100 calls/day."
  /api/security/approval/{chain}/{address}:
    parameters:
      - name: "chain"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The chain parameter"
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Security"
      summary: "Approval"
      operationId: "get_api_security_approval_chain_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                score: 85
                risks: []
                verified: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Approval.  Free tier: 100 calls/day."
  /api/security/nft/{chain}/{address}:
    parameters:
      - name: "chain"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The chain parameter"
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Security"
      summary: "Nft"
      operationId: "get_api_security_nft_chain_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                score: 85
                risks: []
                verified: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Nft.  Free tier: 100 calls/day."
  /api/smart/price/{token}:
    parameters:
      - name: "token"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The token parameter"
    get:
      tags:
        - "Smart"
      summary: "Price"
      operationId: "get_api_smart_price_token_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                verified: true
                name: "Token"
                compiler: "0.8.19"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Price. Smart contract analysis and verification. Free tier: 100 calls/day."
  /api/smart/prices:
    get:
      tags:
        - "Smart"
      summary: "Prices"
      operationId: "get_api_smart_prices"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                verified: true
                name: "Token"
                compiler: "0.8.19"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Prices. Smart contract analysis and verification. Free tier: 100 calls/day."
  /api/smart/price/contract/{chain}/{address}:
    parameters:
      - name: "chain"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The chain parameter"
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Smart"
      summary: "Contract"
      operationId: "get_api_smart_price_contract_chain_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                verified: true
                name: "Token"
                compiler: "0.8.19"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Contract. Smart contract analysis and verification. Free tier: 100 calls/day."
  /api/smart/market:
    get:
      tags:
        - "Smart"
      summary: "Market"
      operationId: "get_api_smart_market"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                verified: true
                name: "Token"
                compiler: "0.8.19"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Market. Smart contract analysis and verification. Free tier: 100 calls/day."
  /api/smart/tvl/{protocol}:
    parameters:
      - name: "protocol"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The protocol parameter"
    get:
      tags:
        - "Smart"
      summary: "Tvl"
      operationId: "get_api_smart_tvl_protocol_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                verified: true
                name: "Token"
                compiler: "0.8.19"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Tvl. Smart contract analysis and verification. Free tier: 100 calls/day."
  /api/smart/protocols:
    get:
      tags:
        - "Smart"
      summary: "Protocols"
      operationId: "get_api_smart_protocols"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                verified: true
                name: "Token"
                compiler: "0.8.19"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Protocols. Smart contract analysis and verification. Free tier: 100 calls/day."
  /api/smart/tvl/chain/{chain}:
    parameters:
      - name: "chain"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The chain parameter"
    get:
      tags:
        - "Smart"
      summary: "Chain"
      operationId: "get_api_smart_tvl_chain_chain_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                verified: true
                name: "Token"
                compiler: "0.8.19"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Chain. Smart contract analysis and verification. Free tier: 100 calls/day."
  /api/smart/yields:
    get:
      tags:
        - "Smart"
      summary: "Yields"
      operationId: "get_api_smart_yields"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                verified: true
                name: "Token"
                compiler: "0.8.19"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Yields. Smart contract analysis and verification. Free tier: 100 calls/day."
  /api/smart/stablecoins:
    get:
      tags:
        - "Smart"
      summary: "Stablecoins"
      operationId: "get_api_smart_stablecoins"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                verified: true
                name: "Token"
                compiler: "0.8.19"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Stablecoins. Smart contract analysis and verification. Free tier: 100 calls/day."
  /api/smart/fear-greed:
    get:
      tags:
        - "Smart"
      summary: "Fear-greed"
      operationId: "get_api_smart_fear_greed"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                verified: true
                name: "Token"
                compiler: "0.8.19"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Fear-greed. Smart contract analysis and verification. Free tier: 100 calls/day."
  /api/smart/bitcoin:
    get:
      tags:
        - "Smart"
      summary: "Bitcoin"
      operationId: "get_api_smart_bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                verified: true
                name: "Token"
                compiler: "0.8.19"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Bitcoin. Smart contract analysis and verification. Free tier: 100 calls/day."
  /api/spam/{contract}:
    parameters:
      - name: "contract"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The contract parameter"
    get:
      tags:
        - "Spam"
      summary: "Spam"
      operationId: "get_api_spam_contract_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Spam.  Free tier: 100 calls/day."
  /api/stablecoins/stablecoins/marketcap:
    get:
      tags:
        - "Stablecoins"
      summary: "Marketcap"
      operationId: "get_api_stablecoins_stablecoins_marketcap"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMarketcap. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoins/prices:
    get:
      tags:
        - "Stablecoins"
      summary: "Prices"
      operationId: "get_api_stablecoins_stablecoins_prices"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPrices. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoins/flows:
    get:
      tags:
        - "Stablecoins"
      summary: "Flows"
      operationId: "get_api_stablecoins_stablecoins_flows"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFlows. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoin/lusd:
    get:
      tags:
        - "Stablecoins"
      summary: "Lusd"
      operationId: "get_api_stablecoins_stablecoin_lusd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nLusd. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoins/chain/{chain}:
    parameters:
      - name: "chain"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The chain parameter"
    get:
      tags:
        - "Stablecoins"
      summary: "Chain"
      operationId: "get_api_stablecoins_stablecoins_chain_chain_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nChain. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoins/chain/ethereum:
    get:
      tags:
        - "Stablecoins"
      summary: "Ethereum"
      operationId: "get_api_stablecoins_stablecoins_chain_ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEthereum. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoins/chain/tron:
    get:
      tags:
        - "Stablecoins"
      summary: "Tron"
      operationId: "get_api_stablecoins_stablecoins_chain_tron"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTron. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoins/chain/bsc:
    get:
      tags:
        - "Stablecoins"
      summary: "Bsc"
      operationId: "get_api_stablecoins_stablecoins_chain_bsc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBsc. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoins/chain/arbitrum:
    get:
      tags:
        - "Stablecoins"
      summary: "Arbitrum"
      operationId: "get_api_stablecoins_stablecoins_chain_arbitrum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nArbitrum. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoins/chain/polygon:
    get:
      tags:
        - "Stablecoins"
      summary: "Polygon"
      operationId: "get_api_stablecoins_stablecoins_chain_polygon"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPolygon. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoins/chain/solana:
    get:
      tags:
        - "Stablecoins"
      summary: "Solana"
      operationId: "get_api_stablecoins_stablecoins_chain_solana"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSolana. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoins/chain/avalanche:
    get:
      tags:
        - "Stablecoins"
      summary: "Avalanche"
      operationId: "get_api_stablecoins_stablecoins_chain_avalanche"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAvalanche. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoins/chain/optimism:
    get:
      tags:
        - "Stablecoins"
      summary: "Optimism"
      operationId: "get_api_stablecoins_stablecoins_chain_optimism"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nOptimism. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoins/chain/base:
    get:
      tags:
        - "Stablecoins"
      summary: "Base"
      operationId: "get_api_stablecoins_stablecoins_chain_base"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBase. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/stablecoins/chain/fantom:
    get:
      tags:
        - "Stablecoins"
      summary: "Fantom"
      operationId: "get_api_stablecoins_stablecoins_chain_fantom"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFantom. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/frax:
    get:
      tags:
        - "Stablecoins"
      summary: "Frax"
      operationId: "get_api_stablecoins_frax"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFrax. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/tusd:
    get:
      tags:
        - "Stablecoins"
      summary: "Tusd"
      operationId: "get_api_stablecoins_tusd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTusd. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/busd:
    get:
      tags:
        - "Stablecoins"
      summary: "Busd"
      operationId: "get_api_stablecoins_busd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBusd. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/gusd:
    get:
      tags:
        - "Stablecoins"
      summary: "Gusd"
      operationId: "get_api_stablecoins_gusd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGusd. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stablecoins/susd:
    get:
      tags:
        - "Stablecoins"
      summary: "Susd"
      operationId: "get_api_stablecoins_susd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "USDC"
                symbol: "USDC"
                price: 1
                marketCap: 45000000000
                volume24h: 5000000000
                chains:
                  - "ethereum"
                  - "base"
                  - "arbitrum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSusd. Stablecoin market data and analytics. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stats/ethsupply:
    get:
      tags:
        - "Stats"
      summary: "Ethsupply"
      operationId: "get_api_stats_ethsupply"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEthsupply.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stats/eth2supply:
    get:
      tags:
        - "Stats"
      summary: "Eth2supply"
      operationId: "get_api_stats_eth2supply"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEth2supply.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stats/ethprice:
    get:
      tags:
        - "Stats"
      summary: "Ethprice"
      operationId: "get_api_stats_ethprice"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEthprice.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/stats/nodecount:
    get:
      tags:
        - "Stats"
      summary: "Nodecount"
      operationId: "get_api_stats_nodecount"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nNodecount.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/status/history:
    get:
      tags:
        - "Status"
      summary: "History"
      operationId: "get_api_status_history"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "History.  Free tier: 100 calls/day."
  /api/status/log:
    post:
      tags:
        - "Status"
      summary: "Log"
      operationId: "post_api_status_log"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Log.  Free tier: 100 calls/day."
  /api/status/summary:
    get:
      tags:
        - "Status"
      summary: "Summary"
      operationId: "get_api_status_summary"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Summary.  Free tier: 100 calls/day."
  /api/subscribe:
    post:
      tags:
        - "Subscribe"
      summary: "Subscribe to status updates"
      description: "Subscribe an email address to receive status update notifications"
      operationId: "subscribeEmail"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: "object"
              required:
                - "email"
              properties:
                email:
                  type: "string"
                  format: "email"
                  description: "Email address to subscribe"
                  example: "user@example.com"
      responses:
        "200":
          description: "Successfully subscribed"
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  success:
                    type: "boolean"
                    example: true
                  message:
                    type: "string"
                    example: "Successfully subscribed to status updates"
                  alreadySubscribed:
                    type: "boolean"
                    description: "True if email was already subscribed"
                  timestamp:
                    type: "string"
                    format: "date-time"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Invalid email format"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
    delete:
      tags:
        - "Subscribe"
      summary: "Unsubscribe from status updates"
      description: "Remove an email address from status update notifications"
      operationId: "unsubscribeEmail"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: "object"
              required:
                - "email"
              properties:
                email:
                  type: "string"
                  format: "email"
                  description: "Email address to unsubscribe"
                  example: "user@example.com"
      responses:
        "200":
          description: "Successfully unsubscribed"
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  success:
                    type: "boolean"
                    example: true
                  message:
                    type: "string"
                    example: "Successfully unsubscribed from status updates"
                  timestamp:
                    type: "string"
                    format: "date-time"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Invalid email format"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
  /api/subscribe/count:
    get:
      tags:
        - "Subscribe"
      summary: "Get subscriber count"
      description: "Returns the total number of status update subscribers (no personal data exposed)"
      operationId: "getSubscriberCount"
      responses:
        "200":
          description: "Subscriber count"
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  count:
                    type: "number"
                    description: "Total number of subscribers"
                    example: 142
                  timestamp:
                    type: "string"
                    format: "date-time"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request - Invalid parameters"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
  /api/subgraphs:
    get:
      tags:
        - "Subgraphs"
      summary: "Subgraphs"
      operationId: "get_api_subgraphs"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Subgraphs.  Free tier: 100 calls/day."
  /api/subnames/{parent}:
    parameters:
      - name: "parent"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The parent parameter"
    get:
      tags:
        - "Subnames"
      summary: "Subnames"
      operationId: "get_api_subnames_parent_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                parent: "aboutme.eth"
                name: "test"
                available: true
                price: "$0.97/year"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Subnames. ENS subname registration and management. Free tier: 100 calls/day."
  /api/subnames/{parent}/by-owner/{address}:
    parameters:
      - name: "parent"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The parent parameter"
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Subnames"
      summary: "By-owner"
      operationId: "get_api_subnames_parent_by_owner_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                parent: "aboutme.eth"
                name: "test"
                available: true
                price: "$0.97/year"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "By-owner. ENS subname registration and management. Free tier: 100 calls/day."
  /api/subnames/{parent}/all:
    parameters:
      - name: "parent"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The parent parameter"
    get:
      tags:
        - "Subnames"
      summary: "All"
      operationId: "get_api_subnames_parent_all"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                parent: "aboutme.eth"
                name: "test"
                available: true
                price: "$0.97/year"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "All. ENS subname registration and management. Free tier: 100 calls/day."
  /api/subnames/{parent}/stats:
    parameters:
      - name: "parent"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The parent parameter"
    get:
      tags:
        - "Subnames"
      summary: "Stats"
      operationId: "get_api_subnames_parent_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                parent: "aboutme.eth"
                name: "test"
                available: true
                price: "$0.97/year"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Stats. ENS subname registration and management. Free tier: 100 calls/day."
  /api/subnames/{parent}/search:
    parameters:
      - name: "parent"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The parent parameter"
    get:
      tags:
        - "Subnames"
      summary: "Search"
      operationId: "get_api_subnames_parent_search"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                parent: "aboutme.eth"
                name: "test"
                available: true
                price: "$0.97/year"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Search. ENS subname registration and management. Free tier: 100 calls/day."
  /api/subnames/{parent}/{name}/available:
    parameters:
      - name: "parent"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The parent parameter"
      - name: "name"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The name parameter"
    get:
      tags:
        - "Subnames"
      summary: "Available"
      operationId: "get_api_subnames_parent_name_available"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
                example:
                  available: true
                  name: "alice.aboutme.eth"
                  parent: "aboutme.eth"
              examples:
                available:
                  summary: "Subname available for registration"
                  value:
                    parent: "aboutme.eth"
                    label: "john"
                    fullName: "john.aboutme.eth"
                    available: true
                    price:
                      amount: "0.97"
                      currency: "USDC"
                      network: "Base"
                taken:
                  summary: "Subname already registered"
                  value:
                    parent: "aboutme.eth"
                    label: "palmer"
                    fullName: "palmer.aboutme.eth"
                    available: false
                    owner: "0x983110309620D911731Ac0932219af06091b6744"
                    registeredAt: "2026-02-11T15:30:00Z"
                    expires: "2028-02-11T15:30:00Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Available. ENS subname registration and management. Free tier: 100 calls/day."
  /api/subnames/{parent}/{name}/profile:
    parameters:
      - name: "parent"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The parent parameter"
      - name: "name"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The name parameter"
    get:
      tags:
        - "Subnames"
      summary: "Profile"
      operationId: "get_api_subnames_parent_name_profile"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
                example:
                  name: "test.aboutme.eth"
                  owner: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                  resolver: "0x231b0Ee14048e9dCcD1d247744d114a4EB5E8E63"
                  records:
                    eth.address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                    avatar: "https://metadata.ens.domains/mainnet/avatar/example.eth"
                  expiresAt: "2028-02-12T00:00:00Z"
              example:
                parent: "aboutme.eth"
                name: "test"
                available: true
                price: "$0.97/year"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Profile. ENS subname registration and management. Free tier: 100 calls/day."
  /api/subnames/{parent}/{name}:
    parameters:
      - name: "parent"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The parent parameter"
      - name: "name"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The name parameter"
    get:
      tags:
        - "Subnames"
      summary: "Subnames"
      operationId: "get_api_subnames_parent_name_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                parent: "aboutme.eth"
                name: "test"
                available: true
                price: "$0.97/year"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Subnames. ENS subname registration and management. Free tier: 100 calls/day."
  /api/subnames/{parent}/{name}/transfer:
    parameters:
      - name: "parent"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The parent parameter"
      - name: "name"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The name parameter"
    post:
      tags:
        - "Subnames"
      summary: "Transfer"
      operationId: "post_api_subnames_parent_name_transfer"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                parent: "aboutme.eth"
                name: "test"
                available: true
                price: "$0.97/year"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Transfer. ENS subname registration and management. Free tier: 100 calls/day."
  /api/subnames/{parent}/{name}/renew:
    parameters:
      - name: "parent"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The parent parameter"
      - name: "name"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The name parameter"
    post:
      tags:
        - "Subnames"
      summary: "Renew"
      operationId: "post_api_subnames_parent_name_renew"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                parent: "aboutme.eth"
                name: "test"
                available: true
                price: "$0.97/year"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "402":
          description: "Payment Required - x402 micropayment needed for this endpoint"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Renew. ENS subname registration and management. Free tier: 100 calls/day."
  /api/subnames/{parent}/{name}/renewal-price:
    parameters:
      - name: "parent"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The parent parameter"
      - name: "name"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The name parameter"
    get:
      tags:
        - "Subnames"
      summary: "Renewal-price"
      operationId: "get_api_subnames_parent_name_renewal_price"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                parent: "aboutme.eth"
                name: "test"
                available: true
                price: "$0.97/year"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Renewal-price. ENS subname registration and management. Free tier: 100 calls/day."
  /api/subnames/{parent}/{name}/price:
    parameters:
      - name: "parent"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The parent parameter"
      - name: "name"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The name parameter"
    get:
      tags:
        - "Subnames"
      summary: "Price"
      operationId: "get_api_subnames_parent_name_price"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                parent: "aboutme.eth"
                name: "test"
                available: true
                price: "$0.97/year"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Price. ENS subname registration and management. Free tier: 100 calls/day."
  /api/subnames/{parent}/purchase:
    parameters:
      - name: "parent"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The parent parameter"
    post:
      tags:
        - "Subnames"
      summary: "Purchase"
      operationId: "post_api_subnames_parent_purchase"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                parent: "aboutme.eth"
                name: "test"
                available: true
                price: "$0.97/year"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "402":
          description: "Payment Required - x402 micropayment needed for this endpoint"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Purchase. ENS subname registration and management. Free tier: 100 calls/day."
  /api/swap/quote:
    get:
      tags:
        - "Swap"
      summary: "Quote"
      operationId: "get_api_swap_quote"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "402":
          description: "Payment Required - x402 micropayment needed for this endpoint"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Quote.  Free tier: 100 calls/day."
  /api/swap/routes:
    get:
      tags:
        - "Swap"
      summary: "Routes"
      operationId: "get_api_swap_routes"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "402":
          description: "Payment Required - x402 micropayment needed for this endpoint"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaymentRequiredError"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Routes.  Free tier: 100 calls/day."
  /api/swap/tokens:
    get:
      tags:
        - "Swap"
      summary: "Tokens"
      operationId: "get_api_swap_tokens"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Tokens.  Free tier: 100 calls/day."
  /api/swap/pairs:
    get:
      tags:
        - "Swap"
      summary: "Pairs"
      operationId: "get_api_swap_pairs"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Pairs.  Free tier: 100 calls/day."
  /api/time/unix-to-iso/{timestamp}:
    parameters:
      - name: "timestamp"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The timestamp parameter"
    get:
      tags:
        - "Time"
      summary: "Unix-to-iso"
      operationId: "get_api_time_unix_to_iso_timestamp_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nUnix-to-iso.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/time/iso-to-unix/{iso}:
    parameters:
      - name: "iso"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The iso parameter"
    get:
      tags:
        - "Time"
      summary: "Iso-to-unix"
      operationId: "get_api_time_iso_to_unix_iso_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nIso-to-unix.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/time/now:
    get:
      tags:
        - "Time"
      summary: "Now"
      operationId: "get_api_time_now"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nNow.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/time/block-estimate/{blocks}:
    parameters:
      - name: "blocks"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The blocks parameter"
    get:
      tags:
        - "Time"
      summary: "Block-estimate"
      operationId: "get_api_time_block_estimate_blocks_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBlock-estimate.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/timestamp:
    get:
      tags:
        - "Timestamp"
      summary: "Timestamp"
      operationId: "get_api_timestamp"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Timestamp.  Free tier: 100 calls/day."
  /api/token/{contract}:
    parameters:
      - name: "contract"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The contract parameter"
    get:
      tags:
        - "Token"
      summary: "Token"
      operationId: "get_api_token_contract_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nToken.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/token/transfers/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Token"
      summary: "Transfers"
      operationId: "get_api_token_transfers_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTransfers.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/token/balance/{address}/{contractaddress}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
      - name: "contractaddress"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The contractaddress parameter"
    get:
      tags:
        - "Token"
      summary: "Balance"
      operationId: "get_api_token_balance_address_contractaddress_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBalance.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/price/usdc-eth:
    get:
      tags:
        - "Tokens"
      summary: "Usdc-eth"
      operationId: "get_api_tokens_price_usdc_eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nUsdc-eth.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/price/usdc-arb:
    get:
      tags:
        - "Tokens"
      summary: "Usdc-arb"
      operationId: "get_api_tokens_price_usdc_arb"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nUsdc-arb.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/price/usdc-base:
    get:
      tags:
        - "Tokens"
      summary: "Usdc-base"
      operationId: "get_api_tokens_price_usdc_base"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nUsdc-base.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tokens/price/usdc-op:
    get:
      tags:
        - "Tokens"
      summary: "Usdc-op"
      operationId: "get_api_tokens_price_usdc_op"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nUsdc-op.  Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/tvl/chain/{name}:
    parameters:
      - name: "name"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The name parameter"
    get:
      tags:
        - "Tvl"
      summary: "Chain"
      operationId: "get_api_tvl_tvl_chain_name_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  ethereum: 8000000000
                  polygon: 2500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nChain. Total Value Locked (TVL) data for DeFi protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/tvl/top:
    get:
      tags:
        - "Tvl"
      summary: "Top"
      operationId: "get_api_tvl_tvl_top"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  ethereum: 8000000000
                  polygon: 2500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTop. Total Value Locked (TVL) data for DeFi protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/tvl/all-chains:
    get:
      tags:
        - "Tvl"
      summary: "All-chains"
      operationId: "get_api_tvl_tvl_all_chains"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  ethereum: 8000000000
                  polygon: 2500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAll-chains. Total Value Locked (TVL) data for DeFi protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/tvl/global:
    get:
      tags:
        - "Tvl"
      summary: "Global"
      operationId: "get_api_tvl_tvl_global"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  ethereum: 8000000000
                  polygon: 2500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGlobal. Total Value Locked (TVL) data for DeFi protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/tvl/global/history:
    get:
      tags:
        - "Tvl"
      summary: "History"
      operationId: "get_api_tvl_tvl_global_history"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  ethereum: 8000000000
                  polygon: 2500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nHistory. Total Value Locked (TVL) data for DeFi protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/tvl/history/{protocol}:
    parameters:
      - name: "protocol"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The protocol parameter"
    get:
      tags:
        - "Tvl"
      summary: "History"
      operationId: "get_api_tvl_tvl_history_protocol_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  ethereum: 8000000000
                  polygon: 2500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nHistory. Total Value Locked (TVL) data for DeFi protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/tvl/snapshot/{chain}:
    parameters:
      - name: "chain"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The chain parameter"
    get:
      tags:
        - "Tvl"
      summary: "Snapshot"
      operationId: "get_api_tvl_tvl_snapshot_chain_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  ethereum: 8000000000
                  polygon: 2500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSnapshot. Total Value Locked (TVL) data for DeFi protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/tvl/category/lending:
    get:
      tags:
        - "Tvl"
      summary: "Lending"
      operationId: "get_api_tvl_tvl_category_lending"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  ethereum: 8000000000
                  polygon: 2500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nLending. Total Value Locked (TVL) data for DeFi protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/tvl/category/dex:
    get:
      tags:
        - "Tvl"
      summary: "Dex"
      operationId: "get_api_tvl_tvl_category_dex"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  ethereum: 8000000000
                  polygon: 2500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nDex. Total Value Locked (TVL) data for DeFi protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/tvl/category/liquid-staking:
    get:
      tags:
        - "Tvl"
      summary: "Liquid-staking"
      operationId: "get_api_tvl_tvl_category_liquid_staking"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  ethereum: 8000000000
                  polygon: 2500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nLiquid-staking. Total Value Locked (TVL) data for DeFi protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/tvl/category/bridge:
    get:
      tags:
        - "Tvl"
      summary: "Bridge"
      operationId: "get_api_tvl_tvl_category_bridge"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  ethereum: 8000000000
                  polygon: 2500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBridge. Total Value Locked (TVL) data for DeFi protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/tvl/category/cdp:
    get:
      tags:
        - "Tvl"
      summary: "Cdp"
      operationId: "get_api_tvl_tvl_category_cdp"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  ethereum: 8000000000
                  polygon: 2500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCdp. Total Value Locked (TVL) data for DeFi protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/tvl/category/yield:
    get:
      tags:
        - "Tvl"
      summary: "Yield"
      operationId: "get_api_tvl_tvl_category_yield"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  ethereum: 8000000000
                  polygon: 2500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nYield. Total Value Locked (TVL) data for DeFi protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tvl/tvl/category/derivatives:
    get:
      tags:
        - "Tvl"
      summary: "Derivatives"
      operationId: "get_api_tvl_tvl_category_derivatives"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "aave"
                tvl: 12500000000
                change24h: 2.5
                chains:
                  ethereum: 8000000000
                  polygon: 2500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nDerivatives. Total Value Locked (TVL) data for DeFi protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/tx/status/{txhash}:
    parameters:
      - name: "txhash"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The txhash parameter"
    get:
      tags:
        - "Tx"
      summary: "Status"
      operationId: "get_api_tx_status_txhash_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Status.  Free tier: 100 calls/day."
  /api/tx/receipt/{txhash}:
    parameters:
      - name: "txhash"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The txhash parameter"
    get:
      tags:
        - "Tx"
      summary: "Receipt"
      operationId: "get_api_tx_receipt_txhash_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Receipt.  Free tier: 100 calls/day."
  /api/tx-receipt/{hash}:
    parameters:
      - name: "hash"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The hash parameter"
    get:
      tags:
        - "Tx-receipt"
      summary: "Tx-receipt"
      operationId: "get_api_tx_receipt_hash_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Tx-receipt.  Free tier: 100 calls/day."
  /api/uniswap/pools:
    get:
      tags:
        - "Uniswap"
      summary: "Pools"
      operationId: "get_api_uniswap_pools"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Pools.  Free tier: 100 calls/day."
  /api/uniswap/pool/{address}:
    parameters:
      - name: "address"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The address parameter"
    get:
      tags:
        - "Uniswap"
      summary: "Pool"
      operationId: "get_api_uniswap_pool_address_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Pool.  Free tier: 100 calls/day."
  /api/uniswap/swaps:
    get:
      tags:
        - "Uniswap"
      summary: "Swaps"
      operationId: "get_api_uniswap_swaps"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Swaps.  Free tier: 100 calls/day."
  /api/uniswap/stats:
    get:
      tags:
        - "Uniswap"
      summary: "Stats"
      operationId: "get_api_uniswap_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Stats.  Free tier: 100 calls/day."
  /api/volume/volume/ethereum:
    get:
      tags:
        - "Volume"
      summary: "Ethereum"
      operationId: "get_api_volume_volume_ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEthereum. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/base:
    get:
      tags:
        - "Volume"
      summary: "Base"
      operationId: "get_api_volume_volume_base"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBase. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/arbitrum:
    get:
      tags:
        - "Volume"
      summary: "Arbitrum"
      operationId: "get_api_volume_volume_arbitrum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nArbitrum. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/optimism:
    get:
      tags:
        - "Volume"
      summary: "Optimism"
      operationId: "get_api_volume_volume_optimism"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nOptimism. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/polygon:
    get:
      tags:
        - "Volume"
      summary: "Polygon"
      operationId: "get_api_volume_volume_polygon"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPolygon. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/solana:
    get:
      tags:
        - "Volume"
      summary: "Solana"
      operationId: "get_api_volume_volume_solana"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSolana. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/bsc:
    get:
      tags:
        - "Volume"
      summary: "Bsc"
      operationId: "get_api_volume_volume_bsc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBsc. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/avalanche:
    get:
      tags:
        - "Volume"
      summary: "Avalanche"
      operationId: "get_api_volume_volume_avalanche"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAvalanche. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/fantom:
    get:
      tags:
        - "Volume"
      summary: "Fantom"
      operationId: "get_api_volume_volume_fantom"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFantom. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/gnosis:
    get:
      tags:
        - "Volume"
      summary: "Gnosis"
      operationId: "get_api_volume_volume_gnosis"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGnosis. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/celo:
    get:
      tags:
        - "Volume"
      summary: "Celo"
      operationId: "get_api_volume_volume_celo"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCelo. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/moonbeam:
    get:
      tags:
        - "Volume"
      summary: "Moonbeam"
      operationId: "get_api_volume_volume_moonbeam"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMoonbeam. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/linea:
    get:
      tags:
        - "Volume"
      summary: "Linea"
      operationId: "get_api_volume_volume_linea"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nLinea. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/scroll:
    get:
      tags:
        - "Volume"
      summary: "Scroll"
      operationId: "get_api_volume_volume_scroll"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nScroll. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/blast:
    get:
      tags:
        - "Volume"
      summary: "Blast"
      operationId: "get_api_volume_volume_blast"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBlast. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/zksync:
    get:
      tags:
        - "Volume"
      summary: "Zksync"
      operationId: "get_api_volume_volume_zksync"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nZksync. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/mode:
    get:
      tags:
        - "Volume"
      summary: "Mode"
      operationId: "get_api_volume_volume_mode"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMode. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/mantle:
    get:
      tags:
        - "Volume"
      summary: "Mantle"
      operationId: "get_api_volume_volume_mantle"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMantle. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/cex-vs-dex:
    get:
      tags:
        - "Volume"
      summary: "Cex-vs-dex"
      operationId: "get_api_volume_volume_cex_vs_dex"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCex-vs-dex. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/global:
    get:
      tags:
        - "Volume"
      summary: "Global"
      operationId: "get_api_volume_volume_global"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGlobal. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/volume/volume/top-dexes:
    get:
      tags:
        - "Volume"
      summary: "Top-dexes"
      operationId: "get_api_volume_volume_top_dexes"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                protocol: "uniswap"
                volume24h: 1500000000
                volume7d: 8500000000
                change24h: 5.2
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTop-dexes. Trading volume statistics across protocols. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/top:
    get:
      tags:
        - "Yields"
      summary: "Top"
      operationId: "get_api_yields_yields_top"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTop. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/high-apy:
    get:
      tags:
        - "Yields"
      summary: "High-apy"
      operationId: "get_api_yields_yields_high_apy"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nHigh-apy. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/median/{chain}:
    parameters:
      - name: "chain"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The chain parameter"
    get:
      tags:
        - "Yields"
      summary: "Median"
      operationId: "get_api_yields_yields_median_chain_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMedian. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/stables:
    get:
      tags:
        - "Yields"
      summary: "Stables"
      operationId: "get_api_yields_yields_stables"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStables. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/eth:
    get:
      tags:
        - "Yields"
      summary: "Eth"
      operationId: "get_api_yields_yields_eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEth. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/btc:
    get:
      tags:
        - "Yields"
      summary: "Btc"
      operationId: "get_api_yields_yields_btc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBtc. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/chain/ethereum:
    get:
      tags:
        - "Yields"
      summary: "Ethereum"
      operationId: "get_api_yields_yields_chain_ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEthereum. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/chain/base:
    get:
      tags:
        - "Yields"
      summary: "Base"
      operationId: "get_api_yields_yields_chain_base"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBase. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/chain/arbitrum:
    get:
      tags:
        - "Yields"
      summary: "Arbitrum"
      operationId: "get_api_yields_yields_chain_arbitrum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nArbitrum. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/chain/optimism:
    get:
      tags:
        - "Yields"
      summary: "Optimism"
      operationId: "get_api_yields_yields_chain_optimism"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nOptimism. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/chain/polygon:
    get:
      tags:
        - "Yields"
      summary: "Polygon"
      operationId: "get_api_yields_yields_chain_polygon"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPolygon. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/chain/bsc:
    get:
      tags:
        - "Yields"
      summary: "Bsc"
      operationId: "get_api_yields_yields_chain_bsc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBsc. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/chain/avalanche:
    get:
      tags:
        - "Yields"
      summary: "Avalanche"
      operationId: "get_api_yields_yields_chain_avalanche"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAvalanche. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/chain/fantom:
    get:
      tags:
        - "Yields"
      summary: "Fantom"
      operationId: "get_api_yields_yields_chain_fantom"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFantom. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/chain/solana:
    get:
      tags:
        - "Yields"
      summary: "Solana"
      operationId: "get_api_yields_yields_chain_solana"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSolana. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/project/{name}:
    parameters:
      - name: "name"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The name parameter"
    get:
      tags:
        - "Yields"
      summary: "Project"
      operationId: "get_api_yields_yields_project_name_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nProject. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/yields/search:
    get:
      tags:
        - "Yields"
      summary: "Search"
      operationId: "get_api_yields_yields_search"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSearch. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/yields/chain/fantom:
    get:
      tags:
        - "Yields"
      summary: "Fantom"
      operationId: "get_api_yields_chain_fantom"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                pool: "ETH-USDC"
                protocol: "Aave"
                apy: 4.5
                tvl: 500000000
                chain: "ethereum"
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "429":
          description: "Rate limited"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Fantom. DeFi yield farming and staking opportunities. Free tier: 100 calls/day."
  /ccip/{sender}/{data.json}:
    parameters:
      - name: "sender"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The sender parameter"
      - name: "data.json"
        in: "path"
        required: true
        schema:
          type: "string"
        description: "The data.json parameter"
    get:
      tags:
        - "CCIP"
      summary: "Ccip"
      operationId: "get_ccip_sender_data.json_"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad request"
        "404":
          description: "Not Found - Resource does not exist"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "500":
          description: "Internal Server Error"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
      description: "Ccip.  Free tier: 100 calls/day."
  /api/misc/abi/{address}:
    get:
      summary: "Get contract ABI"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFetch verified contract ABI"
      tags:
        - "Utilities"
      operationId: "get_api_misc_abi_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Contract address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/balance/{address}:
    get:
      summary: "Get ETH balance"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nETH balance for address"
      tags:
        - "Wallet"
      operationId: "get_api_misc_balance_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/age/{address}:
    get:
      summary: "Get address age"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAge of address"
      tags:
        - "Wallet"
      operationId: "get_api_misc_age_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/airdrops:
    get:
      summary: "Airdrop tracker"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nActive and upcoming airdrops"
      tags:
        - "DeFi"
      operationId: "get_api_misc_airdrops"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/btc-dominance:
    get:
      summary: "BTC dominance"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBitcoin market dominance"
      tags:
        - "Prices"
      operationId: "get_api_misc_btc_dominance"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/active-users:
    get:
      summary: "Active users"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nDaily active addresses"
      tags:
        - "Chain"
      operationId: "get_api_misc_active_users"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/block:
    get:
      summary: "Current block"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCurrent block number"
      tags:
        - "Chain"
      operationId: "get_api_misc_block"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/block/latest:
    get:
      summary: "Latest block"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nLatest block details"
      tags:
        - "Chain"
      operationId: "get_api_misc_block_latest"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/block/{number}:
    get:
      summary: "Get block"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet block by number"
      tags:
        - "Chain"
      operationId: "get_api_misc_block_number"
      parameters:
        - name: "number"
          in: "path"
          required: true
          description: "Block number"
          schema:
            type: "string"
          example: 19200000
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/cex/volumes:
    get:
      summary: "CEX volumes"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCentralized exchange volumes"
      tags:
        - "DeFi"
      operationId: "get_api_misc_cex_volumes"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/defi/users:
    get:
      summary: "DeFi users"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nActive DeFi users"
      tags:
        - "DeFi"
      operationId: "get_api_misc_defi_users"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/etf/flows:
    get:
      summary: "ETF flows"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBTC/ETH ETF flows"
      tags:
        - "Prices"
      operationId: "get_api_misc_etf_flows"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/fear-greed:
    get:
      summary: "Fear and Greed"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCrypto Fear and Greed Index"
      tags:
        - "Prices"
      operationId: "get_api_misc_fear_greed"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/funding-rates:
    get:
      summary: "Funding rates"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPerpetual funding rates"
      tags:
        - "DeFi"
      operationId: "get_api_misc_funding_rates"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/liquidations:
    get:
      summary: "Liquidations"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nRecent DeFi liquidations"
      tags:
        - "DeFi"
      operationId: "get_api_misc_liquidations"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/mcap/total:
    get:
      summary: "Total market cap"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTotal crypto market cap"
      tags:
        - "Prices"
      operationId: "get_api_misc_mcap_total"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/mcap/defi:
    get:
      summary: "DeFi market cap"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTotal DeFi market cap"
      tags:
        - "DeFi"
      operationId: "get_api_misc_mcap_defi"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/oi:
    get:
      summary: "Open interest"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTotal open interest"
      tags:
        - "DeFi"
      operationId: "get_api_misc_oi"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/season:
    get:
      summary: "Alt season"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAltcoin season indicator"
      tags:
        - "Prices"
      operationId: "get_api_misc_season"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/stablecoin/mcap:
    get:
      summary: "Stablecoin mcap"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTotal stablecoin market cap"
      tags:
        - "DeFi"
      operationId: "get_api_misc_stablecoin_mcap"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/volume/dex:
    get:
      summary: "DEX volume"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTotal DEX trading volume"
      tags:
        - "DeFi"
      operationId: "get_api_misc_volume_dex"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/volume/24h:
    get:
      summary: "24h volume"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTotal 24h trading volume"
      tags:
        - "Prices"
      operationId: "get_api_misc_volume_24h"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/whale-alerts:
    get:
      summary: "Whale alerts"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nRecent large transactions"
      tags:
        - "Wallet"
      operationId: "get_api_misc_whale_alerts"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/tx/{hash}:
    get:
      summary: "Get transaction"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTransaction details"
      tags:
        - "Chain"
      operationId: "get_api_misc_tx_hash"
      parameters:
        - name: "hash"
          in: "path"
          required: true
          description: "Transaction hash"
          schema:
            type: "string"
          example: "0xabc123def456789012345678901234567890abcd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/receipt/{hash}:
    get:
      summary: "Get receipt"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTransaction receipt"
      tags:
        - "Chain"
      operationId: "get_api_misc_receipt_hash"
      parameters:
        - name: "hash"
          in: "path"
          required: true
          description: "Transaction hash"
          schema:
            type: "string"
          example: "0xabc123def456789012345678901234567890abcd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/events/{address}:
    get:
      summary: "Contract events"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nContract events"
      tags:
        - "Chain"
      operationId: "get_api_misc_events_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Contract address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/logs/{address}:
    get:
      summary: "Contract logs"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nContract logs"
      tags:
        - "Chain"
      operationId: "get_api_misc_logs_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Contract address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/utils/convert/wei-to-eth/{wei}:
    get:
      summary: "Wei to ETH"
      description: "Convert wei to ether"
      tags:
        - "Utilities"
      operationId: "get_api_utils_convert_wei_to_eth_wei"
      parameters:
        - name: "wei"
          in: "path"
          required: true
          description: "Wei amount"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/convert/eth-to-wei/{eth}:
    get:
      summary: "ETH to wei"
      description: "Convert ether to wei"
      tags:
        - "Utilities"
      operationId: "get_api_utils_convert_eth_to_wei_eth"
      parameters:
        - name: "eth"
          in: "path"
          required: true
          description: "ETH amount"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/convert/gwei-to-wei/{gwei}:
    get:
      summary: "Gwei to wei"
      description: "Convert gwei to wei"
      tags:
        - "Utilities"
      operationId: "get_api_utils_convert_gwei_to_wei_gwei"
      parameters:
        - name: "gwei"
          in: "path"
          required: true
          description: "Gwei amount"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/convert/wei-to-gwei/{wei}:
    get:
      summary: "Wei to gwei"
      description: "Convert wei to gwei"
      tags:
        - "Utilities"
      operationId: "get_api_utils_convert_wei_to_gwei_wei"
      parameters:
        - name: "wei"
          in: "path"
          required: true
          description: "Wei amount"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/convert/hex-to-dec/{hex}:
    get:
      summary: "Hex to decimal"
      description: "Convert hex to decimal"
      tags:
        - "Utilities"
      operationId: "get_api_utils_convert_hex_to_dec_hex"
      parameters:
        - name: "hex"
          in: "path"
          required: true
          description: "Hex value"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/convert/dec-to-hex/{dec}:
    get:
      summary: "Decimal to hex"
      description: "Convert decimal to hex"
      tags:
        - "Utilities"
      operationId: "get_api_utils_convert_dec_to_hex_dec"
      parameters:
        - name: "dec"
          in: "path"
          required: true
          description: "Decimal value"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/time/unix-to-iso/{timestamp}:
    get:
      summary: "Unix to ISO"
      description: "Convert unix to ISO"
      tags:
        - "Utilities"
      operationId: "get_api_utils_time_unix_to_iso_timestamp"
      parameters:
        - name: "timestamp"
          in: "path"
          required: true
          description: "Unix timestamp"
          schema:
            type: "string"
          example: "24h"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/time/iso-to-unix/{iso}:
    get:
      summary: "ISO to Unix"
      description: "Convert ISO to unix"
      tags:
        - "Utilities"
      operationId: "get_api_utils_time_iso_to_unix_iso"
      parameters:
        - name: "iso"
          in: "path"
          required: true
          description: "ISO timestamp"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/time/now:
    get:
      summary: "Current time"
      description: "Current time in multiple formats"
      tags:
        - "Utilities"
      operationId: "get_api_utils_time_now"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/time/block-estimate/{blocks}:
    get:
      summary: "Block time estimate"
      description: "Estimate time for N blocks"
      tags:
        - "Utilities"
      operationId: "get_api_utils_time_block_estimate_blocks"
      parameters:
        - name: "blocks"
          in: "path"
          required: true
          description: "Block count"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/hash/keccak256/{input}:
    get:
      summary: "Keccak256 hash"
      description: "Compute keccak256 hash"
      tags:
        - "Utilities"
      operationId: "get_api_utils_hash_keccak256_input"
      parameters:
        - name: "input"
          in: "path"
          required: true
          description: "Input string"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/abi/encode:
    get:
      summary: "ABI encode"
      description: "ABI encode parameters"
      tags:
        - "Utilities"
      operationId: "get_api_utils_abi_encode"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/abi/decode:
    get:
      summary: "ABI decode"
      description: "ABI decode data"
      tags:
        - "Utilities"
      operationId: "get_api_utils_abi_decode"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/selector/{signature}:
    get:
      summary: "Function selector"
      description: "Compute function selector"
      tags:
        - "Utilities"
      operationId: "get_api_utils_selector_signature"
      parameters:
        - name: "signature"
          in: "path"
          required: true
          description: "Function signature"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/checksum/{address}:
    get:
      summary: "Checksum address"
      description: "Get checksummed address"
      tags:
        - "Utilities"
      operationId: "get_api_utils_checksum_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/alchemy/asset-transfers/{address}:
    get:
      summary: "Asset transfer history"
      description: "Get ERC20, ERC721, and ERC1155 transfers for an address"
      tags:
        - "Alchemy"
      operationId: "get_api_alchemy_asset_transfers_address"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Ethereum address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Transfer history"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyAssetTransfersResponse"
              example:
                address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                chain: "ethereum"
                direction: "both"
                transfers:
                  - from: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
                    to: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
                    value: 50000000000
                    asset: "ETH 2.0"
                    category: "erc20"
                    hash: "0x7ca2f754a33f324a90dfdc929aa961b0efade67c67313ed4b6f9ebf1d910c23f"
                    blockNum: "0xed0a97"
                  - from: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
                    to: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
                    value: null
                    asset: null
                    category: "erc721"
                    hash: "0xf8e1ab6c96cc14cd72226c3a618ebc8d7aa483b0ffa637803579e2a2c59b56f5"
                    blockNum: "0xe1d5ac"
                source: "alchemy"
                timestamp: "2026-02-18T01:38:00.503Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/alchemy/tx-receipt/{hash}:
    get:
      summary: "Transaction receipt"
      description: "Get transaction receipt by hash"
      tags:
        - "Alchemy"
      operationId: "get_api_alchemy_tx_receipt_hash"
      x-price: "$0.01"
      parameters:
        - name: "hash"
          in: "path"
          required: true
          description: "Transaction hash"
          schema:
            type: "string"
          example: "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060"
      responses:
        "200":
          description: "Transaction receipt"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyTxReceiptResponse"
              example:
                hash: "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060"
                chain: "ethereum"
                status: "success"
                blockNumber: 46147
                from: "0xa1e4380a3b1f749673e270229993ee55f35663b4"
                to: "0x5df9b87991262f6ba471f09758cde1c0fc1de734"
                contractAddress: null
                gasUsed: 21000
                effectiveGasPrice: 50000000000000
                logsCount: 0
                source: "alchemy"
                timestamp: "2026-02-18T01:38:15.306Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/alchemy/block/{blockNumber}:
    get:
      summary: "Get block by number"
      description: "Get block data including transactions count"
      tags:
        - "Alchemy"
      operationId: "getAlchemyBlock"
      x-price: "$0.01"
      parameters:
        - name: "blockNumber"
          in: "path"
          required: true
          description: "Block number"
          schema:
            type: "integer"
          example: 12345678
      responses:
        "200":
          description: "Block data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyBlockResponse"
              example:
                chain: "ethereum"
                number: 12345678
                hash: "0xb2a8b39935a5eb4b7c9b0117bca06c8d2c0629e0937d20e62c44aace6f05bda3"
                timestamp: 1619837177
                miner: "0x5a0b54d5dc17e0aadc383d2db43b0a0d3e029c4c"
                gasUsed: 14948480
                gasLimit: 14968232
                baseFeePerGas: null
                txCount: 174
                source: "alchemy"
                fetchedAt: "2026-02-18T01:38:21.128Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/alchemy/logs/{address}:
    get:
      summary: "Contract event logs"
      description: "Get event logs for a contract address"
      tags:
        - "Alchemy"
      operationId: "get_api_alchemy_logs_address"
      x-price: "$0.02"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Contract address"
          schema:
            type: "string"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
      responses:
        "200":
          description: "Contract event logs"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyLogsResponse"
              example:
                address: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                chain: "ethereum"
                logs: []
                count: 0
                source: "alchemy"
                timestamp: "2026-02-18T02:09:08.379Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/alchemy/pending-txs:
    get:
      summary: "Pending transactions"
      description: "Get pending transactions in the mempool"
      tags:
        - "Alchemy"
      operationId: "get_api_alchemy_pending_txs"
      x-price: "$0.01"
      responses:
        "200":
          description: "Pending transactions"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyPendingTxsResponse"
              example:
                chain: "ethereum"
                transactions: []
                count: 0
                source: "alchemy"
                timestamp: "2026-02-18T02:09:16.478Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/alchemy/allowances/{owner}/{spender}:
    get:
      summary: "Token allowances"
      description: "Get ERC20 token allowances for owner/spender pair"
      tags:
        - "Alchemy"
      operationId: "get_api_alchemy_allowances_owner_spender"
      x-price: "$0.01"
      parameters:
        - name: "owner"
          in: "path"
          required: true
          description: "Token owner address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "spender"
          in: "path"
          required: true
          description: "Approved spender address"
          schema:
            type: "string"
          example: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
      responses:
        "200":
          description: "Token allowances"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyAllowancesResponse"
              example:
                owner: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
                spender: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                chain: "ethereum"
                source: "alchemy"
                timestamp: "2026-02-18T02:08:54.416Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/alchemy/collection/{contract}/attributes:
    get:
      summary: "Collection trait attributes"
      description: "Get NFT collection trait distribution (trait types and value counts)"
      tags:
        - "Alchemy"
      operationId: "get_api_alchemy_collection_contract_attributes"
      x-price: "$0.02"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          description: "NFT collection contract address"
          schema:
            type: "string"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
      responses:
        "200":
          description: "Collection trait distribution"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyCollectionAttributesResponse"
              example:
                contract: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                chain: "ethereum"
                summary:
                  Fur:
                    Golden Brown: 778
                    Zombie: 302
                    Black: 1230
                  Eyes:
                    Heart: 394
                    Blue Beams: 49
                    Laser Eyes: 69
                  Background:
                    Gray: 1172
                    Purple: 1292
                totalSupply: "10008"
                source: "alchemy"
                timestamp: "2026-02-18T02:08:54.524Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/alchemy/nft/{contract}/{tokenId}/rarity:
    get:
      summary: "NFT rarity score"
      description: "Get rarity data for a specific NFT based on trait prevalence"
      tags:
        - "Alchemy"
      operationId: "getAlchemyNftRarity"
      x-price: "$0.01"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          description: "NFT collection contract address"
          schema:
            type: "string"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
        - name: "tokenId"
          in: "path"
          required: true
          description: "Token ID within the collection"
          schema:
            type: "string"
          example: "1"
      responses:
        "200":
          description: "NFT rarity data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyNFTRarityResponse"
              example:
                contract: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                tokenId: "1"
                chain: "ethereum"
                rarities:
                  - traitType: "Mouth"
                    value: "Grin"
                    prevalence: 0.0714
                  - traitType: "Eyes"
                    value: "Blue Beams"
                    prevalence: 0.0049
                  - traitType: "Fur"
                    value: "Robot"
                    prevalence: 0.0266
                source: "alchemy"
                timestamp: "2026-02-18T02:09:08.452Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/alchemy/collections/search:
    get:
      summary: "Search NFT collections"
      description: "Search for NFT collections by name or keyword"
      tags:
        - "Alchemy"
      operationId: "get_api_alchemy_collections_search"
      x-price: "$0.02"
      parameters:
        - name: "q"
          in: "query"
          required: true
          description: "Search query"
          schema:
            type: "string"
          example: "bored"
      responses:
        "200":
          description: "Collection search results"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyCollectionsSearchResponse"
              example:
                query: "bored"
                chain: "ethereum"
                contracts:
                  - address: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                    name: "BoredApeYachtClub"
                    symbol: "BAYC"
                    totalSupply: "10000"
                    tokenType: "ERC721"
                    contractDeployer: "0xaBA7161A7fb69c88e16ED9f455CE62B791EE4D03"
                    deployedBlockNumber: 12287507
                    openSeaMetadata:
                      floorPrice: 5.999
                      collectionName: "Bored Ape Yacht Club"
                      collectionSlug: "boredapeyachtclub"
                source: "alchemy"
                timestamp: "2026-02-18T02:09:00.892Z"
        "400":
          description: "Bad Request - Missing q parameter"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
              example:
                error: true
                code: "MISSING_QUERY"
                message: "Query parameter q is required"
                timestamp: "2026-02-18T02:09:00.892Z"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/alchemy/collection/{contract}/sales:
    get:
      summary: "Collection sales history"
      description: "Get recent NFT sales for a collection"
      tags:
        - "Alchemy"
      operationId: "get_api_alchemy_collection_contract_sales"
      x-price: "$0.02"
      parameters:
        - name: "contract"
          in: "path"
          required: true
          description: "NFT collection contract address"
          schema:
            type: "string"
          example: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
      responses:
        "200":
          description: "Collection sales data"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AlchemyCollectionSalesResponse"
              example:
                contract: "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
                chain: "ethereum"
                sales:
                  - tokenId: "6218"
                    sellerAddress: "0xCc1Cb0FA339EB32E436dCe1Ba752bdA72fC6eDfe"
                    buyerAddress: "0xf15C93562bc3944a68e938ef75D2A3360D98ca57"
                    marketplace: "x2y2"
                    price: "14690000000000000000"
                    blockNumber: 19757649
                  - tokenId: "1730"
                    sellerAddress: "0xf15C93562bc3944a68e938ef75D2A3360D98ca57"
                    buyerAddress: "0x9d604A517750EeCEA2ee5c883d491449808A3498"
                    marketplace: "x2y2"
                    price: "12800000000000000000"
                    blockNumber: 19721684
                count: 25
                source: "alchemy"
                timestamp: "2026-02-18T02:08:54.679Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/oauth/.well-known/openid-configuration:
    get:
      summary: "OIDC discovery"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nOpenID Connect discovery"
      tags:
        - "OAuth"
      operationId: "get_api_oauth_well_known_openid_configuration"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/oauth/.well-known/jwks.json:
    get:
      summary: "JWKS"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nJSON Web Key Set"
      tags:
        - "OAuth"
      operationId: "get_api_oauth_well_known_jwks_json"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/oauth/authorize:
    get:
      summary: "OAuth authorize"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nOAuth2 authorization"
      tags:
        - "OAuth"
      operationId: "get_api_oauth_authorize_oidc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/oauth/login:
    get:
      summary: "OAuth login"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nOAuth2 login page"
      tags:
        - "OAuth"
      operationId: "get_api_oauth_login_oidc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/oauth/complete:
    post:
      summary: "Complete OAuth"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nComplete OAuth2 flow"
      tags:
        - "OAuth"
      operationId: "post_api_oauth_complete_oidc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/oauth/token:
    post:
      summary: "OAuth token"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nOAuth2 token endpoint"
      tags:
        - "OAuth"
      operationId: "post_api_oauth_token_oidc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/oauth/introspect:
    post:
      summary: "Token introspect"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nToken introspection"
      tags:
        - "OAuth"
      operationId: "post_api_oauth_introspect_oidc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/oauth/revoke:
    post:
      summary: "Revoke token"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nRevoke OAuth2 token"
      tags:
        - "OAuth"
      operationId: "post_api_oauth_revoke_oidc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/oauth/register:
    post:
      summary: "Register client"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nDynamic client registration"
      tags:
        - "OAuth"
      operationId: "post_api_oauth_register_oidc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/oauth/health:
    get:
      summary: "OAuth health"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nOAuth service health"
      tags:
        - "OAuth"
      operationId: "get_api_oauth_health_oidc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      security:
        - SiweAuth: []
        - ApiKeyAuth: []
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/graph/ens/registrations:
    get:
      summary: "ENS registrations"
      description: "Recent ENS registrations"
      tags:
        - "ENS"
      operationId: "get_api_graph_ens_registrations"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/graph/ens/domain/{name}:
    get:
      summary: "ENS domain"
      description: "ENS domain from subgraph"
      tags:
        - "ENS"
      operationId: "get_api_graph_ens_domain_name"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "ENS name"
          schema:
            type: "string"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/graph/ens/transfers:
    get:
      summary: "ENS transfers"
      description: "Recent ENS transfers"
      tags:
        - "ENS"
      operationId: "get_api_graph_ens_transfers"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/graph/ens/owner/{address}:
    get:
      summary: "ENS by owner"
      description: "ENS names by owner"
      tags:
        - "ENS"
      operationId: "get_api_graph_ens_owner_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Owner address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/graph/uniswap/pools:
    get:
      summary: "Uniswap pools"
      description: "Uniswap V3 pools"
      tags:
        - "DeFi"
      operationId: "get_api_graph_uniswap_pools"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/graph/uniswap/pool/{address}:
    get:
      summary: "Uniswap pool"
      description: "Single Uniswap pool"
      tags:
        - "DeFi"
      operationId: "get_api_graph_uniswap_pool_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Pool address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/graph/uniswap/swaps:
    get:
      summary: "Uniswap swaps"
      description: "Recent swaps"
      tags:
        - "DeFi"
      operationId: "get_api_graph_uniswap_swaps"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/graph/uniswap/stats:
    get:
      summary: "Uniswap stats"
      description: "Protocol statistics"
      tags:
        - "DeFi"
      operationId: "get_api_graph_uniswap_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/graph/aave/markets:
    get:
      summary: "Aave markets"
      description: "Lending markets"
      tags:
        - "DeFi"
      operationId: "get_api_graph_aave_markets"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/graph/lido/stats:
    get:
      summary: "Lido stats"
      description: "Staking statistics"
      tags:
        - "DeFi"
      operationId: "get_api_graph_lido_stats"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/graph/compound/markets:
    get:
      summary: "Compound markets"
      description: "Lending markets"
      tags:
        - "DeFi"
      operationId: "get_api_graph_compound_markets"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/graph/balancer/pools:
    get:
      summary: "Balancer pools"
      description: "Liquidity pools"
      tags:
        - "DeFi"
      operationId: "get_api_graph_balancer_pools"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/contract/abi/{address}:
    get:
      summary: "Contract ABI"
      description: "Verified contract ABI"
      tags:
        - "Security"
      operationId: "get_api_etherscan_contract_abi_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Contract address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/contract/source/{address}:
    get:
      summary: "Contract source"
      description: "Verified source code"
      tags:
        - "Security"
      operationId: "get_api_etherscan_contract_source_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Contract address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/contract/creation/{address}:
    get:
      summary: "Contract creation"
      description: "Creation transaction"
      tags:
        - "Security"
      operationId: "get_api_etherscan_contract_creation_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Contract address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/tx/status/{txhash}:
    get:
      summary: "Transaction status"
      description: "Transaction status"
      tags:
        - "Chain"
      operationId: "get_api_etherscan_tx_status_txhash"
      parameters:
        - name: "txhash"
          in: "path"
          required: true
          description: "Transaction hash"
          schema:
            type: "string"
          example: "0xabc123def456789012345678901234567890abcd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/tx/receipt/{txhash}:
    get:
      summary: "Transaction receipt"
      description: "Transaction receipt"
      tags:
        - "Chain"
      operationId: "get_api_etherscan_tx_receipt_txhash"
      parameters:
        - name: "txhash"
          in: "path"
          required: true
          description: "Transaction hash"
          schema:
            type: "string"
          example: "0xabc123def456789012345678901234567890abcd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/block/reward/{blockno}:
    get:
      summary: "Block reward"
      description: "Block reward"
      tags:
        - "Chain"
      operationId: "get_api_etherscan_block_reward_blockno"
      parameters:
        - name: "blockno"
          in: "path"
          required: true
          description: "Block number"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/block/countdown/{blockno}:
    get:
      summary: "Block countdown"
      description: "ETA to block"
      tags:
        - "Chain"
      operationId: "get_api_etherscan_block_countdown_blockno"
      parameters:
        - name: "blockno"
          in: "path"
          required: true
          description: "Block number"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/block/by-time/{timestamp}:
    get:
      summary: "Block by time"
      description: "Block by timestamp"
      tags:
        - "Chain"
      operationId: "get_api_etherscan_block_by_time_timestamp"
      parameters:
        - name: "timestamp"
          in: "path"
          required: true
          description: "Unix timestamp"
          schema:
            type: "string"
          example: "24h"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/stats/ethsupply:
    get:
      summary: "ETH supply"
      description: "Total ETH supply"
      tags:
        - "Chain"
      operationId: "get_api_etherscan_stats_ethsupply"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/stats/eth2supply:
    get:
      summary: "ETH2 supply"
      description: "ETH2 staking supply"
      tags:
        - "Chain"
      operationId: "get_api_etherscan_stats_eth2supply"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/stats/ethprice:
    get:
      summary: "ETH price"
      description: "ETH price"
      tags:
        - "Prices"
      operationId: "get_api_etherscan_stats_ethprice"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/stats/nodelist:
    get:
      summary: "Node list"
      description: "Ethereum nodes"
      tags:
        - "Chain"
      operationId: "get_api_etherscan_stats_nodelist"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/gas/oracle:
    get:
      summary: "Gas oracle"
      description: "Etherscan gas oracle"
      tags:
        - "Chain"
      operationId: "get_api_etherscan_gas_oracle"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/gas/estimate:
    get:
      summary: "Gas estimate"
      description: "Confirmation time estimate"
      tags:
        - "Chain"
      operationId: "get_api_etherscan_gas_estimate"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/logs/{address}:
    get:
      summary: "Event logs"
      description: "Event logs for address"
      tags:
        - "Chain"
      operationId: "get_api_etherscan_logs_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Contract address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/tokens/{address}:
    get:
      summary: "Token holdings"
      description: "ERC20 token holdings"
      tags:
        - "Wallet"
      operationId: "get_api_etherscan_tokens_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Wallet address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utility/gas:
    get:
      summary: "Gas prices"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCurrent gas prices"
      tags:
        - "Utilities"
      operationId: "get_api_utility_gas"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/utility/gas/multichain:
    get:
      summary: "Multi-chain gas"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGas prices across chains"
      tags:
        - "Utilities"
      operationId: "get_api_utility_gas_multichain"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/utility/gas/{chain}:
    get:
      summary: "Chain gas"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGas prices for chain"
      tags:
        - "Utilities"
      operationId: "get_api_utility_gas_chain"
      parameters:
        - name: "chain"
          in: "path"
          required: true
          description: "Chain name"
          schema:
            type: "string"
          example: "ethereum"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/utility/compare/gas:
    get:
      summary: "Compare gas"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCompare gas across chains"
      tags:
        - "Utilities"
      operationId: "get_api_utility_compare_gas"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/utility/block/latest:
    get:
      summary: "Latest block"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet latest block"
      tags:
        - "Utilities"
      operationId: "get_api_utility_block_latest"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/utility/block/{number}:
    get:
      summary: "Get block"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet block by number"
      tags:
        - "Utilities"
      operationId: "get_api_utility_block_number"
      parameters:
        - name: "number"
          in: "path"
          required: true
          description: "Block number"
          schema:
            type: "string"
          example: 19200000
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/utility/block/multichain:
    get:
      summary: "Multi-chain blocks"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBlocks across chains"
      tags:
        - "Utilities"
      operationId: "get_api_utility_block_multichain"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/utility/timestamp:
    get:
      summary: "Current timestamp"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCurrent block timestamp"
      tags:
        - "Utilities"
      operationId: "get_api_utility_timestamp"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/utility/time/block/{number}:
    get:
      summary: "Block time"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTimestamp for block"
      tags:
        - "Utilities"
      operationId: "get_api_utility_time_block_number"
      parameters:
        - name: "number"
          in: "path"
          required: true
          description: "Block number"
          schema:
            type: "string"
          example: 19200000
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/utility/time/unix/{timestamp}:
    get:
      summary: "Unix to block"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBlock for timestamp"
      tags:
        - "Utilities"
      operationId: "get_api_utility_time_unix_timestamp"
      parameters:
        - name: "timestamp"
          in: "path"
          required: true
          description: "Unix timestamp"
          schema:
            type: "string"
          example: "24h"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/utility/chainid:
    get:
      summary: "Chain IDs"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nChain ID reference"
      tags:
        - "Utilities"
      operationId: "get_api_utility_chainid"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/utility/chainid/{id}:
    get:
      summary: "Chain info"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nChain info by ID"
      tags:
        - "Utilities"
      operationId: "get_api_utility_chainid_id"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Chain ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/exchange/{id}:
    get:
      summary: "Exchange info"
      description: "Exchange details"
      tags:
        - "DeFi"
      operationId: "get_api_exchange_id"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Exchange ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/exchange/{id}/volume:
    get:
      summary: "Exchange volume"
      description: "Exchange 24h volume"
      tags:
        - "DeFi"
      operationId: "get_api_exchange_id_volume"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Exchange ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/exchange/{id}/tickers:
    get:
      summary: "Exchange tickers"
      description: "Trading pairs"
      tags:
        - "DeFi"
      operationId: "get_api_exchange_id_tickers"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Exchange ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/exchanges:
    get:
      summary: "List exchanges"
      description: "List all exchanges"
      tags:
        - "DeFi"
      operationId: "get_api_exchanges"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/treasury/top-holders:
    get:
      summary: "Top treasury holders"
      description: "Companies with largest holdings"
      tags:
        - "DeFi"
      operationId: "get_api_treasury_top_holders"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/treasury/btc:
    get:
      summary: "BTC treasuries"
      description: "Corporate BTC holdings"
      tags:
        - "DeFi"
      operationId: "get_api_treasury_btc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/treasury/eth:
    get:
      summary: "ETH treasuries"
      description: "Corporate ETH holdings"
      tags:
        - "DeFi"
      operationId: "get_api_treasury_eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/treasury/company/{name}:
    get:
      summary: "Company treasury"
      description: "Treasury for company"
      tags:
        - "DeFi"
      operationId: "get_api_treasury_company_name"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "Company name"
          schema:
            type: "string"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/nft/collection/{id}/floor:
    get:
      summary: "Collection floor"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGet floor price"
      tags:
        - "NFT"
      operationId: "get_api_nft_collection_id_floor"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Collection ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NFTFloorPriceResponse"
              example:
                collection: "CryptoPunks"
                floorPrice: 50
                volume24h: 1000
                items: 10000
                owners: 3500
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/collection/{id}/chart:
    get:
      summary: "Collection chart"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPrice history"
      tags:
        - "NFT"
      operationId: "get_api_nft_collection_id_chart"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Collection ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                collection: "CryptoPunks"
                floorPrice: 50
                volume24h: 1000
                items: 10000
                owners: 3500
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/contract/{platform}/{address}:
    get:
      summary: "NFT by contract"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nNFT by contract"
      tags:
        - "NFT"
      operationId: "get_api_nft_contract_platform_address"
      parameters:
        - name: "platform"
          in: "path"
          required: true
          description: "Platform"
          schema:
            type: "string"
          example: "example"
        - name: "address"
          in: "path"
          required: true
          description: "Contract"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                collection: "CryptoPunks"
                floorPrice: 50
                volume24h: 1000
                items: 10000
                owners: 3500
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/auth/keys:
    get:
      summary: "List API keys"
      description: "List user API keys"
      tags:
        - "Auth"
      operationId: "get_api_auth_keys"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/auth/keys/{keyId}:
    delete:
      summary: "Delete API key"
      description: "Revoke an API key"
      tags:
        - "Auth"
      operationId: "deleteAuthKey"
      parameters:
        - name: "keyId"
          in: "path"
          required: true
          description: "API key ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
    patch:
      summary: "Update API key"
      description: "Update API key"
      tags:
        - "Auth"
      operationId: "updateAuthKey"
      parameters:
        - name: "keyId"
          in: "path"
          required: true
          description: "API key ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/auth/credits/pricing:
    get:
      summary: "Credit pricing"
      description: "API credit pricing"
      tags:
        - "Auth"
      operationId: "get_api_auth_credits_pricing"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/auth/credits/{keyId}:
    get:
      summary: "Key credits"
      description: "Credits for key"
      tags:
        - "Auth"
      operationId: "getAuthKeyCredits"
      parameters:
        - name: "keyId"
          in: "path"
          required: true
          description: "API key ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/auth/credits/{keyId}/purchase:
    post:
      summary: "Purchase credits"
      description: "Purchase API credits"
      tags:
        - "Auth"
      operationId: "purchaseAuthKeyCredits"
      parameters:
        - name: "keyId"
          in: "path"
          required: true
          description: "API key ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                success: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/ccip/{sender}/{data}.json:
    get:
      summary: "CCIP gateway"
      description: "ERC-3668 CCIP-Read"
      tags:
        - "CCIP"
      operationId: "get_api_ccip_sender_data_json"
      parameters:
        - name: "sender"
          in: "path"
          required: true
          description: "Sender"
          schema:
            type: "string"
          example: "2024-12-31"
        - name: "data"
          in: "path"
          required: true
          description: "Calldata"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/ccip/health:
    get:
      summary: "CCIP health"
      description: "CCIP gateway health"
      tags:
        - "CCIP"
      operationId: "get_api_ccip_health"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/coins/categories:
    get:
      summary: "List categories"
      description: "List all 747 categories"
      tags:
        - "Prices"
      operationId: "get_api_coins_categories"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/farcaster/channel/{id}:
    get:
      summary: "Get channel"
      description: "Get Farcaster channel"
      tags:
        - "Farcaster"
      operationId: "get_api_farcaster_channel_id"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Channel ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: []
                source: "neynar"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coinpaprika/global:
    get:
      summary: "CoinPaprika global"
      description: "Global market data"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_global"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coinpaprika/coins:
    get:
      summary: "CoinPaprika coins list"
      description: "List all coins"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_coins"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coinpaprika/coin/{id}:
    get:
      summary: "CoinPaprika coin"
      description: "Coin details"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_coin_id"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Coin ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coinpaprika/coin/{id}/ohlcv/today:
    get:
      summary: "CoinPaprika OHLCV"
      description: "Today OHLCV data"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_coin_id_ohlcv_today"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Coin ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coinpaprika/coin/{id}/ohlcv/historical:
    get:
      summary: "CoinPaprika historical OHLCV"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nHistorical OHLCV"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_coin_id_ohlcv_historical"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Coin ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/coin/{id}/markets:
    get:
      summary: "CoinPaprika markets"
      description: "Coin markets"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_coin_id_markets"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Coin ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coinpaprika/coin/{id}/exchanges:
    get:
      summary: "CoinPaprika coin exchanges"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nExchanges trading coin"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_coin_id_exchanges"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Coin ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/coin/{id}/twitter:
    get:
      summary: "CoinPaprika Twitter"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCoin Twitter feed"
      tags:
        - "Social"
      operationId: "get_api_external_coinpaprika_coin_id_twitter"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Coin ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/coin/{id}/events:
    get:
      summary: "CoinPaprika events"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCoin events"
      tags:
        - "Social"
      operationId: "get_api_external_coinpaprika_coin_id_events"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Coin ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/tickers:
    get:
      summary: "CoinPaprika tickers"
      description: "All tickers"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_tickers"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coinpaprika/ticker/{id}:
    get:
      summary: "CoinPaprika ticker"
      description: "Single ticker"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_ticker_id"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Coin ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coinpaprika/ticker/{id}/historical:
    get:
      summary: "CoinPaprika ticker history"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nHistorical ticker"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_ticker_id_historical"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Coin ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/exchanges:
    get:
      summary: "CoinPaprika exchanges"
      description: "All exchanges"
      tags:
        - "DeFi"
      operationId: "get_api_external_coinpaprika_exchanges"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coinpaprika/exchange/{id}:
    get:
      summary: "CoinPaprika exchange"
      description: "Exchange details"
      tags:
        - "DeFi"
      operationId: "get_api_external_coinpaprika_exchange_id"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Exchange ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coinpaprika/exchange/{id}/markets:
    get:
      summary: "CoinPaprika exchange markets"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nExchange markets"
      tags:
        - "DeFi"
      operationId: "get_api_external_coinpaprika_exchange_id_markets"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Exchange ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/people/{id}:
    get:
      summary: "CoinPaprika people"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPerson profile"
      tags:
        - "Social"
      operationId: "get_api_external_coinpaprika_people_id"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Person ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/tags:
    get:
      summary: "CoinPaprika tags"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAll tags"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_tags"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/tag/{id}:
    get:
      summary: "CoinPaprika tag"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTag details"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_tag_id"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Tag ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/search:
    get:
      summary: "CoinPaprika search"
      description: "Search coins"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_search"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coinpaprika/price-converter:
    get:
      summary: "CoinPaprika converter"
      description: "Price converter"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_price_converter"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coinpaprika/contracts/{platform}:
    get:
      summary: "CoinPaprika contracts"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nContracts by platform"
      tags:
        - "Chain"
      operationId: "get_api_external_coinpaprika_contracts_platform"
      parameters:
        - name: "platform"
          in: "path"
          required: true
          description: "Platform ID"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/contracts/{platform}/{address}:
    get:
      summary: "CoinPaprika contract"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nContract details"
      tags:
        - "Chain"
      operationId: "get_api_external_coinpaprika_contracts_platform_address"
      parameters:
        - name: "platform"
          in: "path"
          required: true
          description: "Platform"
          schema:
            type: "string"
          example: "example"
        - name: "address"
          in: "path"
          required: true
          description: "Contract address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coincap/assets:
    get:
      summary: "CoinCap assets"
      description: "All assets"
      tags:
        - "Prices"
      operationId: "get_api_external_coincap_assets"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coincap/asset/{id}:
    get:
      summary: "CoinCap asset"
      description: "Asset details"
      tags:
        - "Prices"
      operationId: "get_api_external_coincap_asset_id"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Asset ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coincap/asset/{id}/history:
    get:
      summary: "CoinCap history"
      description: "Price history"
      tags:
        - "Prices"
      operationId: "get_api_external_coincap_asset_id_history"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Asset ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coincap/asset/{id}/markets:
    get:
      summary: "CoinCap markets"
      description: "Asset markets"
      tags:
        - "Prices"
      operationId: "get_api_external_coincap_asset_id_markets"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Asset ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coincap/rates:
    get:
      summary: "CoinCap rates"
      description: "Exchange rates"
      tags:
        - "Prices"
      operationId: "get_api_external_coincap_rates"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coincap/rate/{id}:
    get:
      summary: "CoinCap rate"
      description: "Single rate"
      tags:
        - "Prices"
      operationId: "get_api_external_coincap_rate_id"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Rate ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coincap/exchanges:
    get:
      summary: "CoinCap exchanges"
      description: "All exchanges"
      tags:
        - "DeFi"
      operationId: "get_api_external_coincap_exchanges"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coincap/exchange/{id}:
    get:
      summary: "CoinCap exchange"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nExchange details"
      tags:
        - "DeFi"
      operationId: "get_api_external_coincap_exchange_id"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Exchange ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coincap/markets:
    get:
      summary: "CoinCap markets"
      description: "All markets"
      tags:
        - "DeFi"
      operationId: "get_api_external_coincap_markets"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/coincap/candles:
    get:
      summary: "CoinCap candles"
      description: "OHLCV candles"
      tags:
        - "Prices"
      operationId: "get_api_external_coincap_candles"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/messari/assets:
    get:
      summary: "Messari assets"
      description: "All assets"
      tags:
        - "Prices"
      operationId: "get_api_external_messari_assets"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/messari/asset/{asset}:
    get:
      summary: "Messari asset"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAsset details"
      tags:
        - "Prices"
      operationId: "get_api_external_messari_asset_asset"
      parameters:
        - name: "asset"
          in: "path"
          required: true
          description: "Asset slug"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/messari/asset/{asset}/metrics:
    get:
      summary: "Messari metrics"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAsset metrics"
      tags:
        - "Prices"
      operationId: "get_api_external_messari_asset_asset_metrics"
      parameters:
        - name: "asset"
          in: "path"
          required: true
          description: "Asset slug"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/messari/asset/{asset}/profile:
    get:
      summary: "Messari profile"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAsset profile"
      tags:
        - "Prices"
      operationId: "get_api_external_messari_asset_asset_profile"
      parameters:
        - name: "asset"
          in: "path"
          required: true
          description: "Asset slug"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/messari/asset/{asset}/market-data:
    get:
      summary: "Messari market data"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMarket data"
      tags:
        - "Prices"
      operationId: "get_api_external_messari_asset_asset_market_data"
      parameters:
        - name: "asset"
          in: "path"
          required: true
          description: "Asset slug"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/messari/news:
    get:
      summary: "Messari news"
      description: "Latest news"
      tags:
        - "Social"
      operationId: "get_api_external_messari_news"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/external/messari/news/{asset}:
    get:
      summary: "Messari asset news"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAsset news"
      tags:
        - "Social"
      operationId: "get_api_external_messari_news_asset"
      parameters:
        - name: "asset"
          in: "path"
          required: true
          description: "Asset slug"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/messari/markets:
    get:
      summary: "Messari markets"
      description: "Market data"
      tags:
        - "Prices"
      operationId: "get_api_external_messari_markets"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/misc/cex/{exchange}:
    get:
      summary: "CEX data"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCentralized exchange data"
      tags:
        - "DeFi"
      operationId: "get_api_misc_cex_exchange"
      parameters:
        - name: "exchange"
          in: "path"
          required: true
          description: "Exchange name"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/categories:
    get:
      summary: "Token categories"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAll token categories"
      tags:
        - "Prices"
      operationId: "get_api_misc_categories"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/category/{name}:
    get:
      summary: "Category tokens"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTokens in category"
      tags:
        - "Prices"
      operationId: "get_api_misc_category_name"
      parameters:
        - name: "name"
          in: "path"
          required: true
          description: "Category name"
          schema:
            type: "string"
          example: "vitalik.eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/oracles:
    get:
      summary: "Oracle data"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPrice oracle data"
      tags:
        - "DeFi"
      operationId: "get_api_misc_oracles"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/coin/{id}:
    get:
      summary: "Coin data"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCoin details"
      tags:
        - "Prices"
      operationId: "get_api_misc_coin_id"
      parameters:
        - name: "id"
          in: "path"
          required: true
          description: "Coin ID"
          schema:
            type: "string"
          example: "bitcoin"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/atv:
    get:
      summary: "ATV info"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nATV agent info"
      tags:
        - "Agent"
      operationId: "get_api_misc_atv"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/hacks:
    get:
      summary: "Crypto hacks"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nRecent hacks/exploits"
      tags:
        - "Security"
      operationId: "get_api_misc_hacks"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/raises:
    get:
      summary: "Funding raises"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nRecent funding rounds"
      tags:
        - "DeFi"
      operationId: "get_api_misc_raises"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/unlocks:
    get:
      summary: "Token unlocks"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nUpcoming token unlocks"
      tags:
        - "DeFi"
      operationId: "get_api_misc_unlocks"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/derivatives:
    get:
      summary: "Derivatives data"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nDerivatives market data"
      tags:
        - "DeFi"
      operationId: "get_api_misc_derivatives"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/nft-marketplaces:
    get:
      summary: "NFT marketplaces"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nNFT marketplace stats"
      tags:
        - "NFT"
      operationId: "get_api_misc_nft_marketplaces"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/defi-chains:
    get:
      summary: "DeFi chains"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nDeFi by chain"
      tags:
        - "DeFi"
      operationId: "get_api_misc_defi_chains"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/stable-mcap:
    get:
      summary: "Stablecoin mcap"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nStablecoin market caps"
      tags:
        - "DeFi"
      operationId: "get_api_misc_stable_mcap"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/indexes:
    get:
      summary: "Crypto indexes"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nMarket indexes"
      tags:
        - "Prices"
      operationId: "get_api_misc_indexes"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/:
    get:
      summary: "API root"
      description: "API information"
      tags:
        - "Admin"
      operationId: "get_api"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/stats/nodecount:
    get:
      summary: "Node count"
      description: "Ethereum node count"
      tags:
        - "Chain"
      operationId: "get_api_etherscan_stats_nodecount"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/token/transfers/{address}:
    get:
      summary: "Token transfers"
      description: "ERC20 transfers"
      tags:
        - "Wallet"
      operationId: "get_api_etherscan_token_transfers_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/token/balance/{address}/{contractaddress}:
    get:
      summary: "Token balance"
      description: "Token balance for address"
      tags:
        - "Wallet"
      operationId: "get_api_etherscan_token_balance_address_contractaddress"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Wallet"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
        - name: "contractaddress"
          in: "path"
          required: true
          description: "Token contract"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/nft/transfers/{address}:
    get:
      summary: "NFT transfers"
      description: "ERC721 transfers"
      tags:
        - "NFT"
      operationId: "get_api_etherscan_nft_transfers_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/etherscan/erc1155/transfers/{address}:
    get:
      summary: "ERC1155 transfers"
      description: "ERC1155 transfers"
      tags:
        - "NFT"
      operationId: "get_api_etherscan_erc1155_transfers_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                status: "1"
                message: "OK"
                result: {}
                source: "etherscan"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/wallet/checksum/{address}:
    get:
      summary: "Checksum address"
      description: "Get checksummed address"
      tags:
        - "Utilities"
      operationId: "get_api_utils_wallet_checksum_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/wallet/validate/{address}:
    get:
      summary: "Validate address"
      description: "Validate Ethereum address"
      tags:
        - "Utilities"
      operationId: "get_api_utils_wallet_validate_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/explorer/address/{address}:
    get:
      summary: "Explorer link"
      description: "Block explorer link"
      tags:
        - "Utilities"
      operationId: "get_api_utils_explorer_address_address"
      parameters:
        - name: "address"
          in: "path"
          required: true
          description: "Address"
          schema:
            type: "string"
          example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/explorer/tx/{hash}:
    get:
      summary: "TX explorer link"
      description: "Transaction explorer link"
      tags:
        - "Utilities"
      operationId: "get_api_utils_explorer_tx_hash"
      parameters:
        - name: "hash"
          in: "path"
          required: true
          description: "TX hash"
          schema:
            type: "string"
          example: "0xabc123def456789012345678901234567890abcd"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utils/explorer/block/{block}:
    get:
      summary: "Block explorer link"
      description: "Block explorer link"
      tags:
        - "Utilities"
      operationId: "get_api_utils_explorer_block_block"
      parameters:
        - name: "block"
          in: "path"
          required: true
          description: "Block number"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                valid: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/nft/{collection}:
    get:
      summary: "NFT collection"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCollection data"
      tags:
        - "NFT"
      operationId: "get_api_nft_collection"
      parameters:
        - name: "collection"
          in: "path"
          required: true
          description: "Collection ID"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                collection: "CryptoPunks"
                floorPrice: 50
                volume24h: 1000
                items: 10000
                owners: 3500
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/{collection}/floor:
    get:
      summary: "Collection floor"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nFloor price"
      tags:
        - "NFT"
      operationId: "get_api_nft_collection_floor"
      parameters:
        - name: "collection"
          in: "path"
          required: true
          description: "Collection ID"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                collection: "CryptoPunks"
                floorPrice: 50
                volume24h: 1000
                items: 10000
                owners: 3500
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/nft/{collection}/chart:
    get:
      summary: "Collection chart"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nPrice history"
      tags:
        - "NFT"
      operationId: "get_api_nft_collection_chart"
      parameters:
        - name: "collection"
          in: "path"
          required: true
          description: "Collection ID"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                collection: "CryptoPunks"
                floorPrice: 50
                volume24h: 1000
                items: 10000
                owners: 3500
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/coins/{category}:
    get:
      summary: "Coins by category"
      description: "Get coins in category"
      tags:
        - "Prices"
      operationId: "get_api_coins_category"
      parameters:
        - name: "category"
          in: "path"
          required: true
          description: "Category ID"
          schema:
            type: "string"
          example: "defi"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/coins/:
    get:
      summary: "All coins"
      description: "List all coins"
      tags:
        - "Prices"
      operationId: "get_api_coins"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/graph/query/{subgraph}:
    post:
      summary: "Query subgraph"
      description: "Execute GraphQL query"
      tags:
        - "DeFi"
      operationId: "post_api_graph_query_subgraph"
      parameters:
        - name: "subgraph"
          in: "path"
          required: true
          description: "Subgraph name"
          schema:
            type: "string"
          example: "example"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/graph/subgraphs:
    get:
      summary: "List subgraphs"
      description: "Available subgraphs"
      tags:
        - "DeFi"
      operationId: "get_api_graph_subgraphs"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/subscribe/:
    post:
      summary: "Subscribe"
      description: "Subscribe to updates"
      tags:
        - "Subscribe"
      operationId: "post_api_subscribe"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
    delete:
      summary: "Unsubscribe"
      description: "Unsubscribe"
      tags:
        - "Subscribe"
      operationId: "delete_api_subscribe"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/utility/atv:
    get:
      summary: "ATV info"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nATV agent information"
      tags:
        - "Agent"
      operationId: "get_api_utility_atv"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/utility/fortune:
    get:
      summary: "Fortune"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nRandom fortune message"
      tags:
        - "Utilities"
      operationId: "get_api_utility_fortune"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/agent/:
    get:
      summary: "Agent info"
      description: "Agent discovery endpoint"
      tags:
        - "Agent"
      operationId: "get_api_agent"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/aggregators/:
    get:
      summary: "Aggregators list"
      description: "DEX aggregators"
      tags:
        - "DeFi"
      operationId: "get_api_aggregators"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                name: "1inch"
                chains:
                  - "ethereum"
                  - "polygon"
                  - "arbitrum"
                volume24h: 500000000
                source: "defillama"
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/bridges/:
    get:
      summary: "Bridges list"
      description: "Cross-chain bridges"
      tags:
        - "L2"
      operationId: "get_api_bridges"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
        "429":
          description: "Rate Limited"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RateLimitError"
  /api/misc/treasury:
    get:
      summary: "Treasury data"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCorporate treasury holdings"
      tags:
        - "DeFi"
      operationId: "get_api_misc_treasury"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
        "429":
          description: "Rate Limited"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/misc/global:
    get:
      summary: "Global data"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nGlobal market data"
      tags:
        - "Prices"
      operationId: "get_api_misc_global"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                result: {}
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
        "429":
          description: "Rate Limited"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/btc:
    get:
      summary: "CoinPaprika BTC"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBitcoin data"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_btc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
        "429":
          description: "Rate Limited"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/eth:
    get:
      summary: "CoinPaprika ETH"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEthereum data"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
        "429":
          description: "Rate Limited"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/ada:
    get:
      summary: "CoinPaprika ADA"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nCardano data"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_ada"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
        "429":
          description: "Rate Limited"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/bnb:
    get:
      summary: "CoinPaprika BNB"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBNB data"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_bnb"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
        "429":
          description: "Rate Limited"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/avax:
    get:
      summary: "CoinPaprika AVAX"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nAvalanche data"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_avax"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
        "429":
          description: "Rate Limited"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/sol:
    get:
      summary: "CoinPaprika SOL"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSolana data"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_sol"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
        "429":
          description: "Rate Limited"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coinpaprika/xrp:
    get:
      summary: "CoinPaprika XRP"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nXRP data"
      tags:
        - "Prices"
      operationId: "get_api_external_coinpaprika_xrp"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
        "429":
          description: "Rate Limited"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coincap/btc:
    get:
      summary: "CoinCap BTC"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nBitcoin data"
      tags:
        - "Prices"
      operationId: "get_api_external_coincap_btc"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
        "429":
          description: "Rate Limited"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coincap/eth:
    get:
      summary: "CoinCap ETH"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nEthereum data"
      tags:
        - "Prices"
      operationId: "get_api_external_coincap_eth"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
        "429":
          description: "Rate Limited"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coincap/sol:
    get:
      summary: "CoinCap SOL"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nSolana data"
      tags:
        - "Prices"
      operationId: "get_api_external_coincap_sol"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
        "429":
          description: "Rate Limited"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coincap/top10:
    get:
      summary: "CoinCap top 10"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTop 10 by market cap"
      tags:
        - "Prices"
      operationId: "get_api_external_coincap_top10"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
        "429":
          description: "Rate Limited"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
  /api/external/coincap/top100:
    get:
      summary: "CoinCap top 100"
      description: "⚠️ This endpoint is documented but not currently implemented.\n\nStatus: Planned feature.\n\nThis route will return 404 in production.\n\nTop 100 by market cap"
      tags:
        - "Prices"
      operationId: "get_api_external_coincap_top100"
      responses:
        "200":
          description: "Success"
          content:
            application/json:
              schema:
                type: "object"
              example:
                data: {}
                source: "external"
                cached: true
                timestamp: "2026-02-13T19:00:00.000Z"
        "400":
          description: "Bad Request"
        "429":
          description: "Rate Limited"
      deprecated: true
      x-implemented: false
      x-deprecation-stage: "legacy"
      x-deprecated-at: "2026-02-19"
components:
  securitySchemes:
    ApiKeyAuth:
      type: "apiKey"
      in: "header"
      name: "X-API-Key"
      description: "API key for authenticated access (250 calls/day).\n\n**How to get a key:** Visit https://api.web3identity.com/admin/, sign in with SIWE, then create an API key in the Keys section.\n"
    SiweAuth:
      type: "http"
      scheme: "bearer"
      bearerFormat: "JWT"
      description: "Sign-In with Ethereum JWT token (200 calls/day).\n\n**How to use:**\n1. Visit https://api.web3identity.com/admin/\n2. Connect your wallet and sign the SIWE message\n3. Copy your JWT from the session info\n4. Paste it here (without \"Bearer \" prefix)\n"
    X402Payment:
      type: "apiKey"
      in: "header"
      name: "X-Payment"
      description: "x402 micropayment header for unlimited paid access.\n\n**Note:** This is auto-generated by x402-compatible wallet clients. You don't manually enter this — your wallet signs EIP-712 payment authorization when you call paid endpoints. See https://docs.web3identity.com/guides/x402 for integration details.\n"
  schemas:
    Error:
      type: "object"
      properties:
        error:
          oneOf:
            - type: "boolean"
            - type: "string"
          description: "Error flag or message"
        code:
          type: "string"
          description: "Error code"
      example:
        error: "Invalid address format"
        code: "INVALID_ADDRESS"
      description: "Standard error response returned when a request fails"
    PaymentRequired:
      type: "object"
      properties:
        error:
          type: "string"
          description: "Payment required message explaining why payment is needed (e.g., free tier exceeded)"
        x402:
          type: "object"
          description: "x402 protocol payment details for machine-to-machine micropayments"
          properties:
            accepts:
              type: "array"
              description: "Array of accepted payment methods (typically one method per endpoint)"
              items:
                type: "object"
                properties:
                  scheme:
                    type: "string"
                    description: "Payment scheme: 'exact' for fixed price, 'range' for flexible amount"
                    enum:
                      - "exact"
                      - "range"
                  network:
                    type: "string"
                    description: "Blockchain network for payment (e.g., 'base', 'ethereum', 'polygon')"
                  maxAmountRequired:
                    type: "string"
                    description: "Maximum payment amount in token's smallest unit (e.g., \"10000\" = 0.01 USDC with 6 decimals)"
                  resource:
                    type: "string"
                    description: "The API endpoint/resource being accessed"
                  description:
                    type: "string"
                    description: "Human-readable pricing description (e.g., \"ENS Profile - $0.01 per request\")"
                  mimeType:
                    type: "string"
                    description: "Response content type"
                  payTo:
                    type: "string"
                    description: "Recipient wallet address for payment (our collection address)"
                  maxTimeoutSeconds:
                    type: "integer"
                    description: "How long the payment authorization remains valid (typically 300s = 5min)"
                  asset:
                    type: "string"
                    description: "Token contract address (USDC on Base - 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)"
                  extra:
                    type: "object"
                    description: "Additional context like free tier limits and upgrade options"
      example:
        error: "Payment required - Free tier exceeded (100 requests/day)"
        x402:
          accepts:
            - scheme: "exact"
              network: "base"
              maxAmountRequired: "10000"
              resource: "/api/ens/profile/vitalik.eth"
              description: "ENS Profile Lookup - $0.01 per request"
              mimeType: "application/json"
              payTo: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
              maxTimeoutSeconds: 300
              asset: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
              extra:
                freeTier: 100
                freeRemaining: 0
                upgradeOptions:
                  siwe: "Sign in with Ethereum for 200 free requests/day"
                  apiKey: "API Key provides 250 free requests/day"
      description: "Response when x402 micropayment is required (HTTP 402).\n\nThe x402 protocol enables machine-to-machine payments using cryptocurrency.\nClients sign an EIP-712 authorization for USDC transfer on Base network.\nPayment is settled automatically via Coinbase facilitator.\n\n**How to handle 402 responses:**\n\n1. **Using our SDK (recommended):**\n```javascript\nimport { createClient } from '@atv-eth/x402-sdk';\nconst client = createClient({ signer: wallet });\nconst profile = await client.ens.getProfile('vitalik.eth');\n// SDK handles payment automatically\n```\n\n2. **Manual implementation:**\n- Parse the `x402.accepts[0]` object\n- Sign EIP-712 TransferWithAuthorization message\n- Retry request with `Payment` header\n\n**Learn more:**\n- [x402 Protocol Docs](https://docs.web3identity.com/concepts/x402-protocol)\n- [Payment System Guide](https://docs.web3identity.com/guides/payments)\n- [SDK Documentation](https://www.npmjs.com/package/@atv-eth/x402-sdk)\n"
    RateLimitError:
      allOf:
        - $ref: "#/components/schemas/ErrorResponse"
      example:
        error: true
        code: "RATE_LIMITED"
        message: "Rate limit exceeded. Free tier: 100 calls/day. Upgrade with SIWE auth or x402 payments."
        timestamp: "2026-02-12T19:00:00.000Z"
    Health:
      type: "object"
      properties:
        status:
          type: "string"
          description: "API health status: healthy, degraded, or unhealthy"
          enum:
            - "healthy"
            - "degraded"
            - "unhealthy"
        version:
          type: "string"
          description: "Current API version"
        uptime:
          type: "number"
          description: "Server uptime in seconds since last restart"
        timestamp:
          type: "string"
          description: "Current server time (ISO 8601)"
          format: "date-time"
      description: "API health status with uptime and version info"
    HealthResponse:
      type: "object"
      properties:
        status:
          type: "string"
          description: "API health status: healthy, degraded, or unhealthy"
          enum:
            - "healthy"
            - "degraded"
            - "unhealthy"
        version:
          type: "string"
          description: "Current API version"
        uptime:
          type: "number"
          description: "Server uptime in seconds since last restart"
        timestamp:
          type: "string"
          description: "Current server time (ISO 8601)"
          format: "date-time"
      description: "Extended health response with metrics"
    PriceResponse:
      type: "object"
      properties:
        symbol:
          type: "string"
          description: "Token ticker symbol (e.g., ETH, BTC)"
        price:
          type: "number"
          description: "Current market price in USD"
        currency:
          type: "string"
          description: "Price denomination (typically USD)"
        timestamp:
          type: "string"
          description: "When the price was fetched (ISO 8601)"
          format: "date-time"
        source:
          type: "string"
          description: "Data provider (e.g., CoinGecko, DefiLlama)"
      description: "Standard price response with timestamp"
    ENSProfile:
      type: "object"
      properties:
        name:
          type: "string"
          description: "ENS domain name (e.g., vitalik.eth)"
        address:
          type: "string"
          description: "Resolved Ethereum address (0x-prefixed)"
        avatar:
          type: "string"
          description: "Avatar URL or ENS avatar record"
        records:
          type: "object"
          description: "ENS text and address records as key-value pairs"
        contenthash:
          type: "string"
          description: "IPFS/IPNS content hash for web content"
        daysUntilExpiry:
          type: "string"
          description: "Days remaining until expiration"
        expiration:
          type: "string"
          description: "Expiration date"
        gracePeriodEnd:
          type: "string"
          description: "End of grace period"
        recommendation:
          type: "string"
          description: "Renewal recommendation"
        status:
          type: "string"
          description: "Current status"
        timestamp:
          type: "string"
          description: "Response generation timestamp"
        input:
          type: "string"
          description: "Input address"
        inputType:
          type: "string"
          description: "Type of input provided"
        note:
          type: "string"
          description: "Additional notes"
        ownedNames:
          type: "string"
          description: "List of owned ENS names"
        primaryName:
          type: "string"
          description: "Primary ENS name"
      description: "Complete ENS profile with address, avatar, and records"
    TVL:
      type: "object"
      properties:
        protocol:
          type: "string"
          description: "DeFi protocol name"
        tvl:
          type: "number"
          description: "Total Value Locked in USD"
        chain:
          type: "string"
          description: "Blockchain network"
        timestamp:
          type: "string"
          description: "When TVL was measured (ISO 8601)"
          format: "date-time"
        cached:
          type: "string"
          description: "Whether response is from cache"
        cachedAt:
          type: "string"
          description: "Cache timestamp"
        category:
          type: "string"
          description: "Protocol category"
        protocols:
          type: "string"
          description: "List of protocols"
        source:
          type: "string"
          description: "Data source identifier"
        totalTvl:
          type: "string"
          description: "Total value locked across all protocols"
      description: "Total Value Locked data for DeFi protocols"
    DeFiProtocolSummary:
      type: "object"
      description: "Protocol summary in list responses"
      properties:
        name:
          type: "string"
          description: "Protocol display name"
        symbol:
          type: "string"
          description: "Token symbol"
        tvl:
          type: "number"
          description: "Total Value Locked in USD"
        category:
          type: "string"
          description: "Protocol category (CEX, Lending, DEX, etc.)"
        chains:
          type: "array"
          items:
            type: "string"
          description: "Deployed chains"
        change_24h:
          type: "number"
          description: "24h TVL change percentage"
        change_7d:
          type: "number"
          description: "7d TVL change percentage"
    DeFiProtocolsResponse:
      type: "object"
      description: "Paginated list of DeFi protocols"
      properties:
        protocols:
          type: "array"
          items:
            $ref: "#/components/schemas/DeFiProtocolSummary"
        count:
          type: "number"
          description: "Number of protocols in response"
        total:
          type: "number"
          description: "Total protocols available"
        source:
          type: "string"
          description: "Data source"
        timestamp:
          type: "string"
          format: "date-time"
        cached:
          type: "boolean"
        cachedAt:
          type: "string"
          format: "date-time"
          nullable: true
    DeFiTVLSummary:
      type: "object"
      description: "Global DeFi TVL summary"
      properties:
        totalTvl:
          type: "number"
          description: "Total Value Locked across all chains (USD)"
        chainCount:
          type: "number"
          description: "Number of chains tracked"
        topChains:
          type: "array"
          items:
            type: "object"
            properties:
              name:
                type: "string"
              tvl:
                type: "number"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
        cached:
          type: "boolean"
        cachedAt:
          type: "string"
          format: "date-time"
          nullable: true
    DeFiChainsResponse:
      type: "object"
      description: "List of chains with TVL data"
      properties:
        chains:
          type: "array"
          items:
            type: "object"
            properties:
              name:
                type: "string"
              tvl:
                type: "number"
              tokenSymbol:
                type: "string"
                nullable: true
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
    DeFiTopProtocolsResponse:
      type: "object"
      description: "Top 20 protocols by TVL"
      properties:
        top20:
          type: "array"
          items:
            type: "object"
            properties:
              name:
                type: "string"
              slug:
                type: "string"
              tvl:
                type: "number"
              change24h:
                type: "number"
              category:
                type: "string"
              chains:
                type: "array"
                items:
                  type: "string"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
    DeFiYieldsResponse:
      type: "object"
      description: "Yield farming pools list"
      properties:
        pools:
          type: "array"
          items:
            $ref: "#/components/schemas/DeFiYieldPool"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
    DeFiYieldPool:
      type: "object"
      description: "Yield farming pool data"
      properties:
        chain:
          type: "string"
        project:
          type: "string"
        symbol:
          type: "string"
        tvlUsd:
          type: "number"
        apyBase:
          type: "number"
        apyReward:
          type: "number"
          nullable: true
        apy:
          type: "number"
        rewardTokens:
          type: "array"
          items:
            type: "string"
          nullable: true
        pool:
          type: "string"
          description: "Pool UUID"
        stablecoin:
          type: "boolean"
        ilRisk:
          type: "string"
        exposure:
          type: "string"
    DeFiYieldPoolDetail:
      type: "object"
      description: "Pool detail with historical data"
      properties:
        pool:
          type: "string"
        history:
          type: "array"
          items:
            type: "object"
            properties:
              timestamp:
                type: "string"
                format: "date-time"
              tvlUsd:
                type: "number"
              apy:
                type: "number"
              apyBase:
                type: "number"
              apyReward:
                type: "number"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
    DeFiStablecoinsResponse:
      type: "object"
      description: "Stablecoin market data"
      properties:
        stablecoins:
          type: "array"
          items:
            type: "object"
            properties:
              name:
                type: "string"
              symbol:
                type: "string"
              pegType:
                type: "string"
              circulating:
                type: "number"
              chains:
                type: "array"
                items:
                  type: "string"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
    TVLResponse:
      type: "object"
      properties:
        protocol:
          type: "string"
          description: "Protocol identifier (slug)"
        name:
          type: "string"
          description: "Human-readable protocol name"
        tvl:
          type: "number"
          description: "Total Value Locked in USD"
        change24h:
          type: "number"
          description: "24-hour TVL change percentage"
        category:
          type: "string"
          description: "Protocol category (e.g., Lending, DEX, Bridge)"
        chains:
          type: "array"
          items:
            type: "string"
          description: "Supported blockchain networks"
        url:
          type: "string"
          description: "Protocol website URL"
      description: "Protocol TVL response with metadata"
    YieldPool:
      type: "object"
      properties:
        pool:
          type: "string"
          description: "Pool name or identifier"
        protocol:
          type: "string"
          description: "DeFi protocol hosting the pool"
        apy:
          type: "number"
          description: "Annual Percentage Yield (as decimal, e.g., 0.05 = 5%)"
        tvl:
          type: "number"
          description: "Total Value Locked in the pool (USD)"
        chain:
          type: "string"
          description: "Blockchain network"
        tokens:
          type: "array"
          description: "Tokens comprising the pool"
          items:
            type: "string"
      description: "DeFi yield pool with APY and TVL info"
    YieldsResponse:
      type: "object"
      properties:
        yields:
          type: "array"
          items:
            $ref: "#/components/schemas/YieldPool"
          description: "List of yield opportunities"
      description: "Response containing multiple yield opportunities"
    Price:
      type: "object"
      properties:
        symbol:
          type: "string"
          description: "Token ticker symbol (e.g., ETH, BTC)"
        price:
          type: "number"
          description: "Current price in USD"
        change24h:
          type: "number"
          description: "24-hour price change as decimal (e.g., 0.05 = +5%)"
        volume24h:
          type: "number"
          description: "24-hour trading volume in USD"
        marketCap:
          type: "number"
          description: "Total market capitalization in USD"
        timestamp:
          type: "string"
          description: "Price timestamp (ISO 8601)"
          format: "date-time"
      description: "Token price with 24h change and market data"
    SocialProfile:
      type: "object"
      properties:
        address:
          type: "string"
          description: "Ethereum address"
        ens:
          type: "string"
          description: "Primary ENS name if set"
        farcaster:
          type: "object"
          description: "Farcaster profile data"
        lens:
          type: "object"
          description: "Lens Protocol profile data"
        twitter:
          type: "string"
          description: "Twitter/X handle"
      description: "Aggregated social profile from ENS/Farcaster/Lens"
    TokenPrice:
      type: "object"
      properties:
        address:
          type: "string"
          description: "Token contract address"
        symbol:
          type: "string"
          description: "Token ticker symbol"
        name:
          type: "string"
          description: "Full token name (e.g., Ethereum)"
        price:
          type: "number"
          description: "Current price in USD"
        decimals:
          type: "integer"
          description: "Token decimal places for formatting"
        chain:
          type: "string"
          description: "Blockchain network"
      description: "Detailed token price with volume and market cap"
    GasPrices:
      type: "object"
      properties:
        chain:
          type: "string"
          description: "Blockchain network name"
        chainId:
          type: "number"
          description: "EVM chain ID (e.g., 1 for mainnet)"
        slow:
          type: "number"
        standard:
          type: "number"
        fast:
          type: "number"
        instant:
          type: "number"
          description: "Instant gas price (next block)"
        unit:
          type: "string"
          description: "Gas price unit (typically gwei)"
        timestamp:
          type: "string"
          description: "When gas prices were fetched (ISO 8601)"
          format: "date-time"
        cached:
          type: "string"
          description: "Whether response is from cache"
        cachedAt:
          type: "string"
          description: "Cache timestamp"
        gasPrice:
          type: "string"
          description: "Gas price in gwei"
        gasPriceWei:
          type: "string"
          description: "Gas price in wei"
        network:
          type: "string"
          description: "Network identifier"
        source:
          type: "string"
          description: "Data source identifier"
      description: "Current gas prices (slow, standard, fast)"
    ProtocolTVL:
      type: "object"
      properties:
        id:
          type: "string"
          description: "Protocol slug (e.g., aave, uniswap-v3)"
        name:
          type: "string"
          description: "Protocol display name"
        tvl:
          type: "number"
          description: "Total Value Locked across all chains (USD)"
        chains:
          type: "array"
          description: "Chains where the protocol is deployed"
          items:
            type: "string"
        change24h:
          type: "number"
          description: "24-hour TVL change as decimal"
        category:
          type: "string"
          description: "Protocol type (DEX, Lending, Bridge, etc.)"
      description: "DeFi protocol TVL by chain"
    Protocol:
      type: "object"
      properties:
        name:
          type: "string"
          description: "Protocol display name"
          example: "Aave"
        slug:
          type: "string"
          description: "URL-safe protocol identifier"
          example: "aave"
        tvl:
          type: "number"
          format: "double"
          description: "Total Value Locked (USD)"
          example: 12345678901.23
        tvlPrevDay:
          type: "number"
          description: "TVL 24 hours ago"
          example: 12123456789.01
        tvlChange:
          type: "number"
          description: "24h TVL change percentage"
          example: 1.82
        chains:
          type: "array"
          description: "Deployed chains"
          items:
            type: "string"
          example:
            - "Ethereum"
            - "Polygon"
            - "Avalanche"
        category:
          type: "string"
          description: "Protocol category"
          example: "Lending"
        description:
          type: "string"
          description: "Protocol description"
          example: "Decentralized lending protocol"
        url:
          type: "string"
          description: "Official website URL"
          example: "https://aave.com"
        logo:
          type: "string"
          description: "Protocol logo URL"
          example: "https://icons.llamao.fi/icons/protocols/aave"
      additionalProperties: true
      description: "DeFi protocol information (may include additional fields like audit, twitter, etc)"
    ProtocolStats:
      type: "object"
      properties:
        protocolId:
          type: "string"
          description: "Protocol identifier"
          example: "1"
        name:
          type: "string"
          description: "Protocol name"
          example: "Aave"
        totalDataChart:
          type: "array"
          description: "Historical data points"
          items:
            type: "object"
            properties:
              timestamp:
                type: "integer"
                description: "Unix timestamp"
                example: 1704067200
              value:
                type: "number"
                description: "Metric value"
                example: 1234567.89
        totalFees24h:
          type: "number"
          description: "24-hour fees (USD)"
          example: 345678.9
        totalRevenue24h:
          type: "number"
          description: "24-hour revenue (USD)"
          example: 123456.78
        totalVolume24h:
          type: "number"
          description: "24-hour volume (USD)"
          example: 9876543210.12
      description: "Protocol statistics (fees, revenue, volume)"
    StablecoinData:
      type: "object"
      properties:
        id:
          type: "string"
          description: "Stablecoin identifier"
          example: "1"
        name:
          type: "string"
          description: "Stablecoin name"
          example: "USDC"
        symbol:
          type: "string"
          description: "Ticker symbol"
          example: "USDC"
        gecko_id:
          type: "string"
          description: "CoinGecko ID"
          example: "usd-coin"
        circulating:
          type: "number"
          format: "double"
          description: "Circulating supply (tokens)"
          example: 45678901234.56
        circulatingPrevDay:
          type: "number"
          description: "Circulating supply 24h ago"
          example: 45123456789.01
        circulatingChange:
          type: "number"
          description: "24h supply change percentage"
          example: 1.21
        price:
          type: "number"
          description: "Current price (USD)"
          example: 1.0001
        chains:
          type: "array"
          description: "Chain distribution"
          items:
            type: "object"
            properties:
              name:
                type: "string"
                description: "Chain name"
                example: "Ethereum"
              circulating:
                type: "number"
                description: "Supply on this chain"
                example: 23456789012.34
      description: "Stablecoin market data"
    ChainTVL:
      type: "object"
      properties:
        chainId:
          type: "string"
          description: "Chain identifier"
          example: "1"
        name:
          type: "string"
          description: "Chain name"
          example: "Ethereum"
        tvl:
          type: "number"
          format: "double"
          description: "Total Value Locked on chain (USD)"
          example: 45234567890.12
        tvlPrevDay:
          type: "number"
          description: "TVL 24 hours ago"
          example: 44987654321.01
        tvlChange:
          type: "number"
          description: "24h TVL change percentage"
          example: 0.55
        protocols:
          type: "integer"
          description: "Number of protocols deployed"
          example: 457
      description: "Chain-specific TVL data"
    AggregatorData:
      type: "object"
      properties:
        totalVolume:
          type: "number"
          format: "double"
          description: "Total aggregator volume (USD)"
          example: 123456789012.34
        totalVolume24hChange:
          type: "number"
          description: "24h volume change percentage"
          example: 2.45
        aggregators:
          type: "array"
          description: "Individual aggregator data"
          items:
            type: "object"
            properties:
              name:
                type: "string"
                description: "Aggregator name"
                example: "1inch"
              volume24h:
                type: "number"
                description: "24-hour volume (USD)"
                example: 45678901234.56
              volumeChange:
                type: "number"
                description: "24h volume change percentage"
                example: 3.21
              dominance:
                type: "number"
                description: "Market share percentage"
                example: 37.2
      description: "DEX aggregator volume data"
    ProtocolSearchResult:
      type: "object"
      properties:
        results:
          type: "array"
          description: "Matching protocols"
          items:
            type: "object"
            properties:
              name:
                type: "string"
                description: "Protocol name"
                example: "Uniswap"
              slug:
                type: "string"
                description: "Protocol slug"
                example: "uniswap"
              category:
                type: "string"
                description: "Protocol category"
                example: "Dexes"
              tvl:
                type: "number"
                description: "Total Value Locked (USD)"
                example: 5678901234.56
      description: "Protocol search results"
    ProtocolCategories:
      type: "object"
      properties:
        categories:
          type: "array"
          description: "Available protocol categories"
          items:
            type: "object"
            properties:
              name:
                type: "string"
                description: "Category name"
                example: "Lending"
              protocols:
                type: "integer"
                description: "Number of protocols"
                example: 156
              tvl:
                type: "number"
                description: "Category total TVL (USD)"
                example: 34567890123.45
      description: "DeFi protocol categories"
    Wallet:
      type: "object"
      properties:
        address:
          type: "string"
          description: "Wallet address being queried"
        balances:
          type: "array"
          description: "Token balances with amounts and USD values"
          items:
            type: "object"
        nfts:
          type: "array"
          description: "NFT holdings with metadata"
          items:
            type: "object"
        transactions:
          type: "array"
          description: "Recent transaction history"
          items:
            type: "object"
        chain:
          type: "string"
          description: "Blockchain network"
        codeHash:
          type: "string"
          description: "Contract code hash"
        codeLength:
          type: "string"
          description: "Contract code length in bytes"
        hasCode:
          type: "string"
          description: "Whether address has contract code"
        timestamp:
          type: "string"
          description: "Response generation timestamp"
      additionalProperties: true
      description: "Wallet data with balances and transactions (includes balance, balanceUsd, tokens, etc)"
    WalletOverview:
      type: "object"
      properties:
        address:
          type: "string"
          description: "Wallet address"
        totalValue:
          type: "number"
          description: "Combined portfolio value in USD"
        tokenCount:
          type: "integer"
          description: "Number of distinct tokens held"
        nftCount:
          type: "integer"
          description: "Number of NFTs owned"
        transactionCount:
          type: "integer"
          description: "Total historical transactions"
        chains:
          type: "array"
          description: "Chains with activity"
          items:
            type: "string"
      description: "High-level wallet summary"
    FarcasterProfile:
      type: "object"
      description: "Farcaster user profile response from Neynar API"
      properties:
        user:
          type: "object"
          description: "User profile data"
          properties:
            object:
              type: "string"
              example: "user"
            fid:
              type: "integer"
              description: "Farcaster user ID (numeric)"
            username:
              type: "string"
              description: "Farcaster username (without @)"
            display_name:
              type: "string"
              description: "Display name shown on profile"
            pfp_url:
              type: "string"
              description: "Profile picture URL"
            custody_address:
              type: "string"
              description: "Custody wallet address"
            profile:
              type: "object"
              properties:
                bio:
                  type: "object"
                  properties:
                    text:
                      type: "string"
            follower_count:
              type: "integer"
              description: "Number of followers"
            following_count:
              type: "integer"
              description: "Number of accounts following"
            verifications:
              type: "array"
              description: "Verified Ethereum addresses"
              items:
                type: "string"
            verified_addresses:
              type: "object"
              properties:
                eth_addresses:
                  type: "array"
                  items:
                    type: "string"
                sol_addresses:
                  type: "array"
                  items:
                    type: "string"
            score:
              type: "number"
              description: "Neynar user score (0-1)"
        source:
          type: "string"
          description: "Data source"
          example: "neynar"
        timestamp:
          type: "string"
          format: "date-time"
          description: "Response timestamp"
    FarcasterUser:
      type: "object"
      properties:
        fid:
          type: "number"
          description: "Farcaster user ID (numeric)"
        username:
          type: "string"
          description: "Farcaster username"
        displayName:
          type: "string"
          description: "Display name shown on profile"
        bio:
          type: "string"
          description: "User biography"
        pfp:
          type: "string"
          description: "Profile picture URL"
        followerCount:
          type: "number"
          description: "Number of followers"
        followingCount:
          type: "number"
          description: "Number of users following"
        verifications:
          type: "array"
          items:
            type: "string"
          description: "Verified Ethereum addresses"
        activeStatus:
          type: "string"
          description: "User activity status"
          enum:
            - "active"
            - "inactive"
        avatar:
          type: "string"
          description: "Avatar URL"
        followers:
          type: "string"
          description: "Follower count or list"
        following:
          type: "string"
          description: "Following count or list"
        source:
          type: "string"
          description: "Data source identifier"
        timestamp:
          type: "string"
          description: "Response generation timestamp"
        verified:
          type: "string"
          description: "Verification status"
      description: "Farcaster user data from Neynar API"
    FarcasterChannel:
      type: "object"
      properties:
        id:
          type: "string"
          description: "Channel ID/slug"
        name:
          type: "string"
          description: "Channel display name"
        description:
          type: "string"
          description: "Channel description"
        followerCount:
          type: "integer"
          description: "Number of followers"
        memberCount:
          type: "integer"
          description: "Number of members"
        imageUrl:
          type: "string"
          format: "uri"
          description: "Channel image URL"
        headerImageUrl:
          type: "string"
          format: "uri"
          description: "Channel header image"
        url:
          type: "string"
          format: "uri"
          description: "Farcaster channel URL"
        createdAt:
          type: "string"
          format: "date-time"
        lead:
          $ref: "#/components/schemas/FarcasterUser"
      description: "Farcaster channel data"
    FarcasterCast:
      type: "object"
      properties:
        hash:
          type: "string"
          description: "Cast hash identifier"
        text:
          type: "string"
          description: "Cast text content"
        timestamp:
          type: "string"
          format: "date-time"
        author:
          $ref: "#/components/schemas/FarcasterUser"
        reactions:
          type: "object"
          properties:
            likes:
              type: "integer"
            recasts:
              type: "integer"
        replies:
          type: "integer"
          description: "Number of replies"
        embeds:
          type: "array"
          items:
            type: "object"
      description: "Farcaster cast (post) data"
    FarcasterSearchResult:
      type: "object"
      properties:
        query:
          type: "string"
        users:
          type: "array"
          items:
            type: "object"
            properties:
              fid:
                type: "integer"
              username:
                type: "string"
              displayName:
                type: "string"
              avatar:
                type: "string"
                format: "uri"
              followers:
                type: "integer"
      description: "Farcaster user search results"
    FarcasterCastsResponse:
      type: "object"
      required:
        - "casts"
      properties:
        casts:
          type: "array"
          items:
            $ref: "#/components/schemas/FarcasterCast"
        next:
          type: "object"
          properties:
            cursor:
              type: "string"
              description: "Pagination cursor for next page"
        count:
          type: "string"
          description: "Total count"
        fid:
          type: "string"
          description: "Farcaster ID"
        includeReplies:
          type: "string"
          description: "Whether replies are included"
        source:
          type: "string"
          description: "Data source identifier"
        timestamp:
          type: "string"
          description: "Response generation timestamp"
      description: "Paginated list of Farcaster casts"
    PaginationCursor:
      type: "object"
      properties:
        cursor:
          type: "string"
          description: "Opaque pagination cursor"
      description: "Pagination cursor for subsequent requests"
    FarcasterFollowersResponse:
      type: "object"
      required:
        - "users"
      properties:
        users:
          type: "array"
          items:
            $ref: "#/components/schemas/FarcasterUser"
        next:
          $ref: "#/components/schemas/PaginationCursor"
      description: "Paginated list of Farcaster followers/following"
    FarcasterFeedAuthor:
      type: "object"
      properties:
        fid:
          type: "integer"
        username:
          type: "string"
        displayName:
          type: "string"
      description: "Author info in Farcaster feed response"
    FarcasterFeedReactions:
      type: "object"
      properties:
        likes:
          type: "integer"
        recasts:
          type: "integer"
      description: "Reaction counts for a Farcaster cast"
    FarcasterFeedCast:
      type: "object"
      properties:
        hash:
          type: "string"
          description: "Cast hash"
        text:
          type: "string"
          description: "Cast content"
        author:
          $ref: "#/components/schemas/FarcasterFeedAuthor"
        timestamp:
          type: "integer"
          description: "Unix timestamp"
        reactions:
          $ref: "#/components/schemas/FarcasterFeedReactions"
      description: "Individual cast in Farcaster feed"
    FarcasterFeedResponse:
      type: "object"
      required:
        - "fid"
        - "casts"
        - "timestamp"
      properties:
        fid:
          type: "string"
          description: "Farcaster ID queried"
        casts:
          type: "array"
          description: "List of casts in feed"
          items:
            $ref: "#/components/schemas/FarcasterFeedCast"
        source:
          type: "string"
          description: "Data source"
        timestamp:
          type: "string"
          format: "date-time"
      description: "Response from Farcaster feed endpoint"
    SubnameAvailability:
      type: "object"
      properties:
        name:
          type: "string"
          description: "Full subname (e.g., gary.aboutme.eth)"
        available:
          type: "boolean"
          description: "True if available for registration"
        parent:
          type: "string"
          description: "Parent ENS name (e.g., aboutme.eth)"
        owner:
          type: "string"
          description: "Current owner address if registered"
        price:
          type: "number"
          description: "Registration price in ETH"
      description: "Subname availability and pricing info"
    ENSResolveResponse:
      type: "object"
      description: "Response from ENS name resolution"
      properties:
        name:
          type: "string"
          description: "ENS name that was resolved"
        address:
          type: "string"
          description: "Resolved Ethereum address (0x-prefixed)"
        cached:
          type: "boolean"
          description: "Whether result was served from cache"
        cachedAt:
          type: "string"
          format: "date-time"
          description: "When the result was cached (ISO 8601)"
          nullable: true
    ENSReverseResponse:
      type: "object"
      description: "Response from reverse ENS resolution"
      properties:
        address:
          type: "string"
          description: "Ethereum address that was queried"
        name:
          type: "string"
          description: "Primary ENS name for this address"
          nullable: true
        hasReverseRecord:
          type: "boolean"
          description: "Whether address has a reverse record set"
        cached:
          type: "boolean"
          description: "Whether result was served from cache"
        cachedAt:
          type: "string"
          format: "date-time"
          description: "When the result was cached (ISO 8601)"
          nullable: true
    ENSResolverResponse:
      type: "object"
      description: "ENS resolver contract information"
      properties:
        name:
          type: "string"
          description: "ENS name queried"
        resolver:
          type: "string"
          description: "Resolver contract address"
          nullable: true
        hasResolver:
          type: "boolean"
          description: "Whether name has a resolver set"
        timestamp:
          type: "string"
          format: "date-time"
          description: "When data was fetched (ISO 8601)"
    HealthResponseExtended:
      type: "object"
      description: "API health status with memory metrics"
      properties:
        status:
          type: "string"
          enum:
            - "healthy"
            - "degraded"
            - "unhealthy"
          description: "Overall API health status"
        version:
          type: "string"
          description: "Current API version"
        uptime:
          type: "number"
          description: "Server uptime in seconds"
        memory:
          type: "object"
          description: "Node.js memory usage metrics"
          properties:
            rss:
              type: "integer"
              description: "Resident set size in bytes"
            heapTotal:
              type: "integer"
              description: "Total heap size in bytes"
            heapUsed:
              type: "integer"
              description: "Used heap size in bytes"
            external:
              type: "integer"
              description: "External memory in bytes"
            arrayBuffers:
              type: "integer"
              description: "ArrayBuffer memory in bytes"
        timestamp:
          type: "string"
          format: "date-time"
          description: "Current server time (ISO 8601)"
    ChainsResponse:
      type: "object"
      description: "Supported blockchain networks"
      properties:
        chains:
          type: "array"
          description: "List of supported chains"
          items:
            type: "object"
            properties:
              id:
                type: "integer"
                description: "Chain ID (e.g., 1 for Ethereum mainnet)"
              name:
                type: "string"
                description: "Human-readable chain name"
              symbol:
                type: "string"
                description: "Native token symbol (e.g., ETH)"
              type:
                type: "string"
                enum:
                  - "L1"
                  - "L2"
                description: "Layer 1 or Layer 2 network"
              explorer:
                type: "string"
                description: "Block explorer URL"
        count:
          type: "number"
          description: "Total number of supported chains"
        endpoints:
          type: "object"
          description: "Available endpoint paths for chain data"
        timestamp:
          type: "string"
          format: "date-time"
          description: "When data was fetched (ISO 8601)"
    GasPricesExtended:
      type: "object"
      description: "Gas prices with cache metadata"
      allOf:
        - $ref: "#/components/schemas/GasPrices"
      properties:
        source:
          type: "string"
          description: "Data source (e.g., etherscan, rpc)"
        cached:
          type: "boolean"
          description: "Whether result was served from cache"
        cachedAt:
          type: "string"
          format: "date-time"
          description: "When the result was cached (ISO 8601)"
          nullable: true
    SIWEVerifyRequest:
      type: "object"
      description: "Request body for SIWE signature verification"
      required:
        - "message"
        - "signature"
      properties:
        message:
          type: "string"
          description: "Complete SIWE message string (ERC-4361 format)"
          example: "api.web3identity.com wants you to sign in with your Ethereum account:\\n0x1234567890abcdef1234567890abcdef12345678\\n\\nSign in to access the Web3 Identity API\\n\\nURI: https://api.web3identity.com\\nVersion: 1\\nChain ID: 1\\nNonce: xJk92nP4mQ\\nIssued At: 2024-02-09T18:00:00.000Z"
        signature:
          type: "string"
          description: "Hex-encoded ECDSA signature (0x-prefixed)"
          pattern: "^0x[a-fA-F0-9]{130}$"
          example: "0x1234567890abcdef1234567890abcdef12345678"
    BatchENSRequest:
      type: "object"
      description: "Request body for batch ENS lookups"
      required:
        - "names"
      properties:
        names:
          type: "array"
          description: "Array of ENS names to resolve (max 10)"
          maxItems: 10
          items:
            type: "string"
            pattern: "^[a-z0-9-]+(\\.[a-z0-9-]+)*\\.eth$"
            example: "vitalik.eth"
          example:
            - "vitalik.eth"
            - "nick.eth"
            - "brantly.eth"
    SubnameRegisterRequest:
      type: "object"
      description: "Request body for subname registration"
      required:
        - "name"
        - "owner"
      properties:
        name:
          type: "string"
          description: "Subname label (alphanumeric + hyphens, max 63 chars)"
          pattern: "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
          maxLength: 63
          example: "alice"
        owner:
          type: "string"
          description: "Ethereum address that will own the subname"
          pattern: "^0x[a-fA-F0-9]{40}$"
          example: "0x701B4937e6c943789ffA74CC8601813b2D87B454"
        records:
          type: "object"
          description: "Optional ENS text records to set"
          additionalProperties:
            type: "string"
          example:
            description: "My personal subname"
            url: "https://example.com"
            avatar: "ipfs://QmRAQB6YaCyidP37UdDnjFY5vQuiBrcqdyoW1CuDgwxkD4"
            com.twitter: "@username"
    SubnameTransferRequest:
      type: "object"
      description: "Request body for subname ownership transfer"
      required:
        - "newOwner"
      properties:
        newOwner:
          type: "string"
          description: "Ethereum address of the new owner"
          pattern: "^0x[a-fA-F0-9]{40}$"
          example: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0"
        currentOwner:
          type: "string"
          description: "Optional current owner address for verification"
          pattern: "^0x[a-fA-F0-9]{40}$"
          example: "0x701B4937e6c943789ffA74CC8601813b2D87B454"
    SubnameRenewRequest:
      type: "object"
      description: "Request body for subname renewal"
      properties:
        years:
          type: "integer"
          description: "Number of years to renew (defaults to 1)"
          minimum: 1
          maximum: 10
          default: 1
          example: 1
    ENSBulkRequest:
      type: "object"
      description: "Request body for bulk ENS resolution (up to 20 names)"
      required:
        - "names"
      properties:
        names:
          type: "array"
          description: "Array of ENS names or Ethereum addresses to resolve (max 20)"
          maxItems: 20
          minItems: 1
          items:
            type: "string"
            example: "vitalik.eth"
          example:
            - "vitalik.eth"
            - "nick.eth"
            - "brantly.eth"
            - "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    AgentIdentity:
      type: "object"
      description: "Full agent identity profile with ENS name, capabilities, and metadata"
      properties:
        identity:
          type: "object"
          properties:
            name:
              type: "string"
              description: "Full ENS name (e.g., myagent.aboutme.eth)"
              example: "atv.aboutme.eth"
            shortName:
              type: "string"
              description: "Short name without parent domain"
              example: "atv"
            address:
              type: "string"
              description: "Ethereum address controlling this agent"
              pattern: "^0x[a-fA-F0-9]{40}$"
              example: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
            type:
              type: "string"
              enum:
                - "agent"
                - "human"
                - "organization"
              description: "Identity type"
              example: "agent"
            standard:
              type: "string"
              enum:
                - "ERC-8004"
              description: "Identity standard"
              example: "ERC-8004"
        controller:
          type: "object"
          properties:
            address:
              type: "string"
              description: "Controller wallet address"
              example: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
            type:
              type: "string"
              enum:
                - "eoa"
                - "agentic-wallet"
                - "multisig"
                - "smart-contract"
              description: "Controller type"
              example: "agentic-wallet"
        registration:
          type: "object"
          properties:
            registeredAt:
              type: "string"
              format: "date-time"
              description: "Registration timestamp"
            expiresAt:
              type: "string"
              format: "date-time"
              description: "Expiration timestamp"
            parent:
              type: "string"
              description: "Parent domain"
              example: "aboutme.eth"
            registrar:
              type: "string"
              description: "Registrar service"
              example: "api.web3identity.com"
        capabilities:
          type: "array"
          items:
            type: "string"
            enum:
              - "x402-payments"
              - "siwe-auth"
              - "xmtp-messaging"
              - "ens-resolution"
          description: "Agent capabilities"
          example:
            - "x402-payments"
            - "siwe-auth"
            - "ens-resolution"
        endpoints:
          type: "object"
          properties:
            profile:
              type: "string"
              format: "uri"
              description: "Profile URL"
              example: "https://atv.aboutme.eth.limo"
            api:
              type: "string"
              format: "uri"
              description: "API endpoint"
              example: "https://api.web3identity.com/api/agent/atv"
            siwe:
              type: "string"
              format: "uri"
              description: "SIWE authentication endpoint"
              example: "https://api.web3identity.com/api/auth/siwe"
            x402:
              type: "string"
              format: "uri"
              description: "x402 payment endpoint"
              example: "https://api.web3identity.com/api/"
        profile:
          type: "object"
          properties:
            description:
              type: "string"
              nullable: true
              description: "Profile description"
            url:
              type: "string"
              format: "uri"
              nullable: true
              description: "Website URL"
            avatar:
              type: "string"
              format: "uri"
              nullable: true
              description: "Avatar image URL"
            twitter:
              type: "string"
              nullable: true
              description: "Twitter handle"
            github:
              type: "string"
              nullable: true
              description: "GitHub username"
        metadata:
          type: "object"
          properties:
            version:
              type: "string"
              example: "1.0.0"
            schema:
              type: "string"
              format: "uri"
              example: "https://api.web3identity.com/api/agent/schema"
            timestamp:
              type: "string"
              format: "date-time"
        available:
          type: "string"
          description: "Whether the ENS name is available for registration"
        exists:
          type: "string"
          description: "Whether the entity exists"
        name:
          type: "string"
          description: "ENS name being queried"
        pricing:
          type: "string"
          description: "Pricing information"
        register:
          type: "string"
          description: "Registration endpoint URL"
        shortName:
          type: "string"
          description: "Short name or identifier"
        timestamp:
          type: "string"
          description: "Response generation timestamp"
        type:
          type: "string"
          description: "Entity type"
    AgentIdentityList:
      type: "object"
      description: "List of agent identities with pagination"
      properties:
        agents:
          type: "array"
          items:
            type: "object"
            properties:
              name:
                type: "string"
                description: "Full ENS name"
                example: "atv.aboutme.eth"
              shortName:
                type: "string"
                description: "Short name without parent"
                example: "atv"
              address:
                type: "string"
                description: "Controller address"
                example: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
              capabilities:
                type: "array"
                items:
                  type: "string"
                description: "Agent capabilities"
              profileUrl:
                type: "string"
                format: "uri"
                description: "Profile URL"
              apiUrl:
                type: "string"
                format: "uri"
                description: "API endpoint"
              registeredAt:
                type: "string"
                format: "date-time"
                description: "Registration timestamp"
        count:
          type: "integer"
          description: "Number of agents in this response"
          example: 10
        total:
          type: "integer"
          description: "Total number of registered agents"
          example: 28
        limit:
          type: "integer"
          description: "Pagination limit"
          example: 50
        offset:
          type: "integer"
          description: "Pagination offset"
          example: 0
        links:
          type: "object"
          properties:
            register:
              type: "string"
              format: "uri"
              description: "Agent registration endpoint"
            schema:
              type: "string"
              format: "uri"
              description: "Agent schema endpoint"
            docs:
              type: "string"
              format: "uri"
              description: "Documentation link"
        timestamp:
          type: "string"
          format: "date-time"
          description: "Response timestamp"
    AgentVerification:
      type: "object"
      description: "Agent ownership verification result"
      properties:
        verified:
          type: "boolean"
          description: "Whether the address owns any agent identities"
          example: true
        address:
          type: "string"
          description: "Ethereum address being verified"
          pattern: "^0x[a-fA-F0-9]{40}$"
          example: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
        count:
          type: "integer"
          description: "Number of agent identities owned (0 if not verified)"
          example: 2
        identities:
          type: "array"
          items:
            type: "object"
            properties:
              name:
                type: "string"
                description: "Full ENS name"
              shortName:
                type: "string"
                description: "Short name"
              createdAt:
                type: "string"
                format: "date-time"
              expiresAt:
                type: "string"
                format: "date-time"
              profileUrl:
                type: "string"
                format: "uri"
              apiUrl:
                type: "string"
                format: "uri"
        primary:
          type: "object"
          nullable: true
          description: "Primary (most recent) agent identity"
        message:
          type: "string"
          description: "Human-readable message"
        registerUrl:
          type: "string"
          format: "uri"
          description: "Registration URL (if not verified)"
        timestamp:
          type: "string"
          format: "date-time"
    AgentCapabilities:
      type: "object"
      description: "Agent capabilities and endpoints"
      properties:
        name:
          type: "string"
          description: "Full ENS name"
          example: "atv.aboutme.eth"
        address:
          type: "string"
          description: "Controller address"
          pattern: "^0x[a-fA-F0-9]{40}$"
          example: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
        capabilities:
          type: "array"
          items:
            type: "string"
            enum:
              - "x402-payments"
              - "siwe-auth"
              - "xmtp-messaging"
              - "ens-resolution"
          description: "List of capabilities"
          example:
            - "x402-payments"
            - "siwe-auth"
        endpoints:
          type: "object"
          properties:
            x402:
              type: "string"
              format: "uri"
              nullable: true
              description: "x402 payment endpoint (if supported)"
            siwe:
              type: "string"
              format: "uri"
              nullable: true
              description: "SIWE auth endpoint (if supported)"
            xmtp:
              type: "string"
              nullable: true
              description: "XMTP messaging address (if supported)"
        timestamp:
          type: "string"
          format: "date-time"
    JsonSchema:
      type: "object"
      description: "JSON Schema definition for agent identity structure"
      properties:
        $schema:
          type: "string"
          description: "JSON Schema version"
          example: "http://json-schema.org/draft-07/schema#"
        $id:
          type: "string"
          format: "uri"
          description: "Schema identifier"
        title:
          type: "string"
          description: "Schema title"
        description:
          type: "string"
          description: "Schema description"
        type:
          type: "string"
          enum:
            - "object"
            - "array"
            - "string"
            - "number"
            - "boolean"
          description: "Root type"
        properties:
          type: "object"
          description: "Object properties definition"
        required:
          type: "array"
          items:
            type: "string"
          description: "Required properties"
    VerifySignatureRequest:
      type: "object"
      description: "Request body for Ethereum signature verification"
      required:
        - "message"
        - "signature"
        - "address"
      properties:
        message:
          type: "string"
          description: "Original message that was signed"
          example: "Sign this message to verify your wallet"
        signature:
          type: "string"
          description: "Ethereum signature (0x-prefixed hex string, 130 chars)"
          pattern: "^0x[a-fA-F0-9]{130}$"
          example: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"
        address:
          type: "string"
          description: "Ethereum address that should have signed the message (0x-prefixed)"
          pattern: "^0x[a-fA-F0-9]{40}$"
          example: "0x701B4937e6c943789ffA74CC8601813b2D87B454"
    DecodeCalldataRequest:
      type: "object"
      description: "Request body for decoding Ethereum transaction calldata"
      required:
        - "data"
      properties:
        data:
          type: "string"
          description: "Hex-encoded calldata to decode (0x-prefixed)"
          pattern: "^0x[a-fA-F0-9]*$"
          example: "0xa9059cbb000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa960450000000000000000000000000000000000000000000000056bc75e2d63100000"
        abi:
          type: "array"
          description: "Optional ABI array if known (for more accurate decoding)"
          items:
            type: "object"
          example:
            - name: "transfer"
              type: "function"
              inputs:
                - name: "to"
                  type: "address"
                - name: "amount"
                  type: "uint256"
    LogoutRequest:
      type: "object"
      description: "Request body for session logout (optional - can also use Authorization header)"
      properties:
        sessionToken:
          type: "string"
          description: "JWT session token to invalidate (optional if provided in Authorization header)"
          example: "EXAMPLE_SESSION_TOKEN_12345"
    AlchemyBalancesResponse:
      type: "object"
      description: "ERC20 token balances for an address"
      properties:
        address:
          type: "string"
          description: "Wallet address queried"
        chain:
          type: "string"
          description: "Blockchain network"
        balances:
          type: "array"
          items:
            $ref: "#/components/schemas/AlchemyTokenBalance"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyTokenBalance:
      type: "object"
      properties:
        contractAddress:
          type: "string"
          description: "ERC20 token contract address"
        tokenBalance:
          type: "string"
          description: "Token balance in hex format"
    AlchemyTokenResponse:
      type: "object"
      description: "ERC20 token metadata"
      properties:
        contract:
          type: "string"
          description: "Token contract address"
        chain:
          type: "string"
        metadata:
          type: "object"
          properties:
            decimals:
              type: "integer"
            logo:
              type: "string"
            name:
              type: "string"
            symbol:
              type: "string"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyTxReceiptResponse:
      type: "object"
      description: "Transaction receipt"
      properties:
        hash:
          type: "string"
          description: "Transaction hash"
        chain:
          type: "string"
        status:
          type: "string"
          enum:
            - "success"
            - "failed"
        blockNumber:
          type: "number"
        from:
          type: "string"
        to:
          type: "string"
          nullable: true
        contractAddress:
          type: "string"
          nullable: true
        gasUsed:
          type: "number"
        effectiveGasPrice:
          type: "number"
        logsCount:
          type: "number"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyBlockResponse:
      type: "object"
      description: "Block data"
      properties:
        chain:
          type: "string"
        number:
          type: "number"
        hash:
          type: "string"
        timestamp:
          type: "number"
          description: "Unix timestamp"
        miner:
          type: "string"
        gasUsed:
          type: "number"
        gasLimit:
          type: "number"
        baseFeePerGas:
          type: "integer"
          nullable: true
        txCount:
          type: "number"
        source:
          type: "string"
          example: "alchemy"
        fetchedAt:
          type: "string"
          format: "date-time"
    AlchemyAssetTransfersResponse:
      type: "object"
      description: "Asset transfer history"
      properties:
        address:
          type: "string"
        chain:
          type: "string"
        direction:
          type: "string"
          enum:
            - "from"
            - "to"
            - "both"
        transfers:
          type: "array"
          items:
            $ref: "#/components/schemas/AlchemyTransfer"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyTransfer:
      type: "object"
      properties:
        from:
          type: "string"
        to:
          type: "string"
        value:
          type: "number"
          nullable: true
        asset:
          type: "string"
          nullable: true
        category:
          type: "string"
          enum:
            - "erc20"
            - "erc721"
            - "erc1155"
            - "external"
            - "internal"
        hash:
          type: "string"
        blockNum:
          type: "string"
    AlchemyNFTsResponse:
      type: "object"
      description: "NFT portfolio for an address"
      properties:
        address:
          type: "string"
        chain:
          type: "string"
        nfts:
          type: "array"
          items:
            type: "object"
          description: "NFT list (may be empty if no NFTs)"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyCollectionResponse:
      type: "object"
      description: "NFT collection metadata"
      properties:
        contract:
          type: "string"
        chain:
          type: "string"
        name:
          type: "string"
        symbol:
          type: "string"
        totalSupply:
          type: "number"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyNFTResponse:
      type: "object"
      description: "Single NFT metadata"
      properties:
        contract:
          type: "string"
        tokenId:
          type: "string"
        chain:
          type: "string"
        name:
          type: "string"
        description:
          type: "string"
        image:
          type: "string"
        attributes:
          type: "array"
          items:
            type: "object"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyFloorPriceResponse:
      type: "object"
      description: "NFT collection floor price"
      properties:
        contract:
          type: "string"
        chain:
          type: "string"
        floorPrice:
          type: "number"
          nullable: true
        currency:
          type: "string"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemySpamResponse:
      type: "object"
      description: "Contract spam classification"
      properties:
        contract:
          type: "string"
        chain:
          type: "string"
        isSpam:
          type: "boolean"
        spamClassifications:
          type: "array"
          items:
            type: "string"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyAllowancesResponse:
      type: "object"
      description: "Token allowances for owner/spender pair"
      properties:
        owner:
          type: "string"
        spender:
          type: "string"
        chain:
          type: "string"
        allowances:
          type: "array"
          items:
            type: "object"
            properties:
              contractAddress:
                type: "string"
              tokenBalance:
                type: "string"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyCollectionAttributesResponse:
      type: "object"
      description: "NFT collection trait distribution"
      properties:
        contract:
          type: "string"
        chain:
          type: "string"
        summary:
          type: "object"
          additionalProperties:
            type: "object"
            additionalProperties:
              type: "integer"
          description: "Trait type to value counts mapping"
        totalSupply:
          type: "string"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyCollectionSalesResponse:
      type: "object"
      description: "NFT collection recent sales"
      properties:
        contract:
          type: "string"
        chain:
          type: "string"
        sales:
          type: "array"
          items:
            $ref: "#/components/schemas/AlchemyNFTSale"
        count:
          type: "number"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyNFTSale:
      type: "object"
      description: "NFT sale record"
      properties:
        tokenId:
          type: "string"
        sellerAddress:
          type: "string"
        buyerAddress:
          type: "string"
        marketplace:
          type: "string"
        price:
          type: "string"
          description: "Price in wei"
        blockNumber:
          type: "integer"
    AlchemyCollectionsSearchResponse:
      type: "object"
      description: "Collection search results"
      properties:
        query:
          type: "string"
        chain:
          type: "string"
        contracts:
          type: "array"
          items:
            $ref: "#/components/schemas/AlchemyCollectionSearchResult"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyCollectionSearchResult:
      type: "object"
      description: "Collection search result item"
      properties:
        address:
          type: "string"
        name:
          type: "string"
        symbol:
          type: "string"
        totalSupply:
          type: "string"
        tokenType:
          type: "string"
          enum:
            - "ERC721"
            - "ERC1155"
        contractDeployer:
          type: "string"
        deployedBlockNumber:
          type: "integer"
        openSeaMetadata:
          type: "object"
          properties:
            floorPrice:
              type: "number"
            collectionName:
              type: "string"
            collectionSlug:
              type: "string"
            imageUrl:
              type: "string"
            description:
              type: "string"
    AlchemyContractsResponse:
      type: "object"
      description: "Contract metadata"
      properties:
        address:
          type: "string"
        chain:
          type: "string"
        name:
          type: "string"
        symbol:
          type: "string"
        tokenType:
          type: "string"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyHoldersResponse:
      type: "object"
      description: "Token/NFT holder count"
      properties:
        contract:
          type: "string"
        chain:
          type: "string"
        holderCount:
          type: "integer"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyLogsResponse:
      type: "object"
      description: "Contract event logs"
      properties:
        address:
          type: "string"
        chain:
          type: "string"
        logs:
          type: "array"
          items:
            type: "object"
            properties:
              blockNumber:
                type: "integer"
              transactionHash:
                type: "string"
              topics:
                type: "array"
                items:
                  type: "string"
              data:
                type: "string"
        count:
          type: "number"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyNFTRarityResponse:
      type: "object"
      description: "NFT rarity data"
      properties:
        contract:
          type: "string"
        tokenId:
          type: "string"
        chain:
          type: "string"
        rarities:
          type: "array"
          items:
            $ref: "#/components/schemas/AlchemyRarityTrait"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyRarityTrait:
      type: "object"
      description: "Individual rarity trait"
      properties:
        traitType:
          type: "string"
        value:
          type: "string"
        prevalence:
          type: "number"
          description: "Trait prevalence (0-1)"
    AlchemyOwnersResponse:
      type: "object"
      description: "NFT owner distribution"
      properties:
        contract:
          type: "string"
        chain:
          type: "string"
        owners:
          type: "array"
          items:
            type: "object"
            properties:
              ownerAddress:
                type: "string"
              tokenBalances:
                type: "array"
                items:
                  type: "object"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyPendingTxsResponse:
      type: "object"
      description: "Pending transactions"
      properties:
        chain:
          type: "string"
        transactions:
          type: "array"
          items:
            type: "object"
            properties:
              hash:
                type: "string"
              from:
                type: "string"
              to:
                type: "string"
              value:
                type: "string"
        count:
          type: "number"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemySalesResponse:
      type: "object"
      description: "NFT sales for a contract"
      properties:
        contract:
          type: "string"
        chain:
          type: "string"
        sales:
          type: "array"
          items:
            $ref: "#/components/schemas/AlchemyNFTSale"
        count:
          type: "integer"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    AlchemyTransfersResponse:
      type: "object"
      description: "Token transfers for an address"
      properties:
        address:
          type: "string"
        chain:
          type: "string"
        transfers:
          type: "array"
          items:
            $ref: "#/components/schemas/AlchemyTransfer"
        source:
          type: "string"
          example: "alchemy"
        timestamp:
          type: "string"
          format: "date-time"
    ErrorResponse:
      type: "object"
      required:
        - "error"
        - "code"
        - "message"
        - "timestamp"
      properties:
        error:
          type: "boolean"
          example: true
        code:
          type: "string"
          enum:
            - "NOT_FOUND"
            - "RATE_LIMITED"
            - "PAYMENT_REQUIRED"
            - "UNAUTHORIZED"
            - "BAD_REQUEST"
            - "INTERNAL_ERROR"
          description: "Error code for programmatic handling"
        message:
          type: "string"
          description: "Human-readable error message"
        timestamp:
          type: "string"
          format: "date-time"
          description: "ISO-8601 timestamp"
      example:
        error: true
        code: "NOT_FOUND"
        message: "Resource not found"
        timestamp: "2026-02-12T19:00:00.000Z"
    PaymentRequiredError:
      type: "object"
      properties:
        error:
          oneOf:
            - type: "boolean"
            - type: "string"
          description: "Error flag (true) or message (\"Payment Required\")"
        code:
          type: "string"
          example: "PAYMENT_REQUIRED"
        message:
          type: "string"
          example: "Payment required: $0.01 USDC"
        payment:
          type: "object"
          properties:
            scheme:
              type: "string"
              example: "exact"
            price:
              type: "string"
              example: "$0.01"
            network:
              type: "string"
              example: "eip155:8453"
            asset:
              type: "string"
              example: "USDC"
            payTo:
              type: "string"
              example: "0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b"
        facilitator:
          type: "string"
          example: "https://api.cdp.coinbase.com/platform/v2/x402"
    NFTCollectionSummary:
      type: "object"
      properties:
        id:
          type: "string"
          description: "Collection identifier"
        name:
          type: "string"
          description: "Collection name"
        symbol:
          type: "string"
          description: "Collection symbol"
        platform:
          type: "string"
          description: "Platform ID (ethereum, polygon, etc.)"
      required:
        - "id"
        - "name"
    NFTCollectionDetail:
      type: "object"
      properties:
        id:
          type: "string"
        name:
          type: "string"
        symbol:
          type: "string"
        floorPrice:
          type: "number"
          nullable: true
          description: "Floor price in native currency"
        floorPriceUsd:
          type: "number"
          nullable: true
          description: "Floor price in USD"
        marketCap:
          type: "number"
          nullable: true
          description: "Market cap in USD"
        volume24h:
          type: "number"
          nullable: true
          description: "24h trading volume in USD"
        owners:
          type: "integer"
          nullable: true
          description: "Number of unique owners"
        totalSupply:
          type: "integer"
          nullable: true
          description: "Total NFT supply"
        source:
          type: "string"
          example: "coingecko"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "id"
        - "name"
        - "source"
        - "timestamp"
    NFTCollectionsListResponse:
      type: "object"
      properties:
        collections:
          type: "array"
          items:
            $ref: "#/components/schemas/NFTCollectionSummary"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "collections"
        - "source"
        - "timestamp"
    NFTCollectionResponse:
      type: "object"
      allOf:
        - $ref: "#/components/schemas/NFTCollectionDetail"
    NFTTrendingResponse:
      type: "object"
      properties:
        nfts:
          type: "array"
          items:
            type: "object"
            properties:
              id:
                type: "string"
              name:
                type: "string"
              symbol:
                type: "string"
              thumb:
                type: "string"
                format: "uri"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
    NFTMarketplaceSummary:
      type: "object"
      properties:
        name:
          type: "string"
        tvl:
          type: "number"
          nullable: true
        chains:
          type: "array"
          items:
            type: "string"
      required:
        - "name"
    NFTMarketplacesResponse:
      type: "object"
      properties:
        marketplaces:
          type: "array"
          items:
            $ref: "#/components/schemas/NFTMarketplaceSummary"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
    NFTMarketplaceResponse:
      type: "object"
      properties:
        name:
          type: "string"
        tvl:
          type: "number"
          nullable: true
        chains:
          type: "array"
          items:
            type: "string"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "name"
    NFTLendingProtocolsResponse:
      type: "object"
      properties:
        protocols:
          type: "array"
          items:
            type: "object"
            properties:
              name:
                type: "string"
              tvl:
                type: "number"
                nullable: true
              chains:
                type: "array"
                items:
                  type: "string"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
    NFTFloorPriceResponse:
      type: "object"
      properties:
        floorPrice:
          type: "number"
          nullable: true
        floorPriceUsd:
          type: "number"
          nullable: true
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
      required: []
    NFTVolumeResponse:
      type: "object"
      properties:
        volume24h:
          type: "number"
          nullable: true
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
    TokenMetadata:
      type: "object"
      properties:
        name:
          type: "string"
        symbol:
          type: "string"
        price:
          type: "number"
          nullable: true
        marketCap:
          type: "number"
          nullable: true
        change24h:
          type: "number"
          nullable: true
          description: "24h price change percentage"
        volume24h:
          type: "number"
          nullable: true
        image:
          type: "string"
          format: "uri"
          nullable: true
      required:
        - "name"
        - "symbol"
    TokenInfoResponse:
      type: "object"
      properties:
        address:
          type: "string"
          description: "Token contract address"
        chain:
          type: "string"
          description: "Blockchain network"
          example: "ethereum"
        symbol:
          type: "string"
          description: "Token symbol"
        price:
          type: "number"
          nullable: true
          description: "Current price in USD"
        decimals:
          type: "number"
          nullable: true
          description: "Token decimals"
        confidence:
          type: "number"
          nullable: true
          description: "Price confidence score (0-1)"
        source:
          type: "string"
          description: "Data source"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "address"
        - "source"
        - "timestamp"
    TokenCategoryListResponse:
      type: "object"
      properties:
        tokens:
          type: "array"
          items:
            $ref: "#/components/schemas/TokenMetadata"
        count:
          type: "integer"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
    TokenStablecoinsResponse:
      type: "object"
      properties:
        stablecoins:
          type: "array"
          items:
            type: "object"
            properties:
              name:
                type: "string"
              symbol:
                type: "string"
              pegType:
                type: "string"
                description: "Type of peg (usd, eur, etc.)"
              circulating:
                type: "number"
                nullable: true
                description: "Circulating supply in USD"
              price:
                type: "number"
                nullable: true
              chains:
                type: "integer"
                description: "Number of chains available on"
        totalMarketCap:
          type: "number"
          description: "Total stablecoin market cap"
        count:
          type: "integer"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "stablecoins"
    TokenPriceResponse:
      type: "object"
      properties:
        price:
          type: "number"
          nullable: true
        change24h:
          type: "number"
          nullable: true
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
    TokenSupplyResponse:
      type: "object"
      properties:
        contract:
          type: "string"
        chain:
          type: "string"
        totalSupply:
          type: "string"
          nullable: true
          description: "Total supply (as string to handle large numbers)"
        circulatingSupply:
          type: "string"
          nullable: true
        note:
          type: "string"
          nullable: true
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "contract"
    TokenHoldersResponse:
      type: "object"
      properties:
        contract:
          type: "string"
        holders:
          type: "array"
          nullable: true
          items:
            type: "object"
            properties:
              address:
                type: "string"
              balance:
                type: "string"
              percentage:
                type: "number"
        note:
          type: "string"
          nullable: true
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "contract"
    TokenOHLCResponse:
      type: "object"
      properties:
        token:
          type: "string"
        days:
          type: "number"
        ohlc:
          type: "array"
          items:
            type: "object"
            properties:
              timestamp:
                type: "string"
                format: "date-time"
              open:
                type: "number"
              high:
                type: "number"
              low:
                type: "number"
              close:
                type: "number"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "token"
        - "days"
        - "ohlc"
        - "source"
        - "timestamp"
    TokenSymbolLookupResponse:
      type: "object"
      properties:
        symbol:
          type: "string"
        matches:
          type: "array"
          items:
            type: "object"
            properties:
              id:
                type: "string"
              name:
                type: "string"
              symbol:
                type: "string"
              marketCapRank:
                type: "integer"
                nullable: true
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "symbol"
        - "source"
        - "timestamp"
    TokenGainersResponse:
      type: "object"
      properties:
        gainers:
          type: "array"
          items:
            $ref: "#/components/schemas/TokenMetadata"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "source"
        - "timestamp"
    TokenLosersResponse:
      type: "object"
      properties:
        losers:
          type: "array"
          items:
            $ref: "#/components/schemas/TokenMetadata"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "losers"
        - "source"
        - "timestamp"
    TokenChainsResponse:
      type: "object"
      properties:
        symbol:
          type: "string"
        name:
          type: "string"
          nullable: true
        id:
          type: "string"
          nullable: true
        chains:
          type: "array"
          items:
            type: "object"
            properties:
              chain:
                type: "string"
              contract:
                type: "string"
              priceEndpoint:
                type: "string"
                nullable: true
        chainCount:
          type: "integer"
        note:
          type: "string"
          nullable: true
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "symbol"
        - "chains"
        - "chainCount"
        - "timestamp"
    TokenCategoriesResponse:
      type: "object"
      properties:
        categories:
          type: "array"
          items:
            type: "object"
            properties:
              id:
                type: "string"
              name:
                type: "string"
              marketCap:
                type: "number"
                nullable: true
              change24h:
                type: "number"
                nullable: true
              top3:
                type: "array"
                items:
                  type: "string"
                nullable: true
        count:
          type: "integer"
        source:
          type: "string"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "categories"
    AddressAgeResponse:
      type: "object"
      properties:
        address:
          type: "string"
          description: "Ethereum address"
        firstTransaction:
          type: "string"
          format: "date-time"
          description: "ISO 8601 timestamp of first transaction"
        age:
          type: "object"
          properties:
            days:
              type: "integer"
              description: "Age in days"
            years:
              type: "number"
              description: "Age in years (decimal)"
          required:
            - "days"
            - "years"
        firstTxHash:
          type: "string"
          description: "First transaction hash"
        blockNumber:
          type: "number"
          description: "First transaction block number"
        source:
          type: "string"
          example: "etherscan"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "address"
        - "firstTransaction"
        - "age"
        - "timestamp"
    ATVInfoResponse:
      type: "object"
      properties:
        name:
          type: "string"
          example: "ATV (Agent Trust Vector)"
        role:
          type: "string"
          example: "Autonomous trust & verification validator"
        wallet:
          type: "string"
          description: "ATV's Ethereum address"
        ens:
          type: "string"
          example: "atv.eth"
        erc8004:
          type: "object"
          description: "ERC-8004 compliance status"
          properties:
            base:
              type: "boolean"
            mainnet:
              type: "boolean"
        channels:
          type: "object"
          description: "Communication channels"
          properties:
            telegram:
              type: "string"
            email:
              type: "string"
            twitter:
              type: "string"
            xmtp:
              type: "string"
        api:
          type: "object"
          properties:
            baseUrl:
              type: "string"
              format: "uri"
            endpoints:
              type: "integer"
            version:
              type: "string"
        operator:
          type: "string"
          example: "GaryPalmerJr.eth"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "name"
        - "role"
        - "wallet"
        - "timestamp"
    AuthSessionResponse:
      type: "object"
      properties:
        authenticated:
          type: "boolean"
          description: "Whether user has valid session"
        address:
          type: "string"
          nullable: true
          description: "User's Ethereum address (if authenticated)"
        chainId:
          type: "integer"
          nullable: true
          description: "Chain ID from SIWE message"
        issuedAt:
          type: "string"
          format: "date-time"
          nullable: true
          description: "Session issuance time"
        expiresAt:
          type: "string"
          format: "date-time"
          nullable: true
          description: "Session expiration time"
        message:
          type: "string"
          nullable: true
          description: "Status message"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "authenticated"
        - "timestamp"
    AuthVerifyRequest:
      type: "object"
      properties:
        message:
          type: "string"
          description: "SIWE message string"
        signature:
          type: "string"
          description: "Hex-encoded signature (0x...)"
        rememberDevice:
          type: "boolean"
          default: false
          description: "Create long-lived refresh token"
        sessionLabel:
          type: "string"
          nullable: true
          description: "Optional session label for tracking"
      required:
        - "message"
        - "signature"
    AuthVerifyResponse:
      type: "object"
      properties:
        success:
          type: "boolean"
        address:
          type: "string"
          description: "Verified Ethereum address"
        chainId:
          type: "number"
          description: "Chain ID from verified message"
        accessToken:
          type: "string"
          description: "Short-lived JWT (1 hour)"
        refreshToken:
          type: "string"
          nullable: true
          description: "Long-lived refresh token (if rememberDevice=true)"
        expiresIn:
          type: "number"
          description: "Access token lifetime in seconds"
        requiresTwoFactor:
          type: "boolean"
          nullable: true
          description: "Whether 2FA is required for this account"
        twoFactorToken:
          type: "string"
          nullable: true
          description: "Temporary token for 2FA challenge"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "success"
        - "address"
        - "accessToken"
        - "timestamp"
    ENSAvatarResponse:
      type: "object"
      properties:
        name:
          type: "string"
          description: "ENS name"
        avatar:
          type: "string"
          format: "uri"
          nullable: true
          description: "Avatar URL (null if not set)"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "name"
        - "timestamp"
    Bitcoin24hTransactionCountResponse:
      type: "object"
      properties:
        transactionCount24h:
          type: "number"
          description: "Number of transactions in last 24 hours"
        source:
          type: "string"
          example: "blockchain.info"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "transactionCount24h"
        - "source"
        - "timestamp"
    BitcoinAvgTxSizeResponse:
      type: "object"
      properties:
        avgTxSize:
          type: "number"
          description: "Average transaction size"
        unit:
          type: "string"
          example: "bytes"
        source:
          type: "string"
          example: "blockchain.info"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "avgTxSize"
        - "unit"
        - "source"
        - "timestamp"
    BitcoinAvgTxValueResponse:
      type: "object"
      properties:
        avgTxValue:
          type: "number"
          description: "Average transaction value"
        unit:
          type: "string"
          example: "BTC"
        source:
          type: "string"
          example: "blockchain.info"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "avgTxValue"
        - "unit"
        - "source"
        - "timestamp"
    BitcoinBtcPerBlockResponse:
      type: "object"
      properties:
        btcPerBlock:
          type: "number"
          description: "BTC amount per block"
        satoshisPerBlock:
          type: "number"
          description: "Satoshis per block"
        source:
          type: "string"
          example: "blockchain.info"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "btcPerBlock"
        - "satoshisPerBlock"
        - "source"
        - "timestamp"
    BitcoinAllResponse:
      type: "object"
      properties:
        price:
          type: "object"
          properties:
            usd:
              type: "number"
            eur:
              type: "number"
              nullable: true
            gbp:
              type: "number"
              nullable: true
          required:
            - "usd"
        network:
          type: "object"
          properties:
            blockHeight:
              type: "integer"
            difficulty:
              type: "number"
            hashrate:
              type: "number"
            hashrateUnit:
              type: "string"
              example: "GH/s"
        supply:
          type: "object"
          properties:
            totalBtc:
              type: "number"
              description: "Total BTC mined"
            maxSupply:
              type: "integer"
              description: "Maximum BTC supply (21M)"
            percentMined:
              type: "string"
              description: "Percentage of total supply mined"
        market:
          type: "object"
          properties:
            marketCap:
              type: "number"
            tradeVolume24h:
              type: "number"
        source:
          type: "string"
          example: "blockchain.info"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "price"
        - "source"
        - "timestamp"
    BitcoinBlockCountResponse:
      type: "object"
      properties:
        blockHeight:
          type: "number"
          description: "Current Bitcoin block height"
        source:
          type: "string"
          example: "blockchain.info"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "blockHeight"
        - "source"
        - "timestamp"
    BitcoinEtaResponse:
      type: "object"
      properties:
        eta:
          type: "number"
          description: "Estimated seconds until next block (negative if overdue)"
        note:
          type: "string"
          description: "Explanation of ETA value"
        source:
          type: "string"
          example: "blockchain.info"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "eta"
        - "source"
        - "timestamp"
    BitcoinIntervalResponse:
      type: "object"
      properties:
        blockInterval:
          type: "number"
          description: "Average time between blocks"
        unit:
          type: "string"
          example: "seconds"
        source:
          type: "string"
          example: "blockchain.info"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "blockInterval"
        - "unit"
        - "source"
        - "timestamp"
    BitcoinLatestHashResponse:
      type: "object"
      properties:
        latestHash:
          type: "string"
          description: "Hash of the latest Bitcoin block"
        source:
          type: "string"
          example: "blockchain.info"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "latestHash"
        - "source"
        - "timestamp"
    BitcoinMarketCapResponse:
      type: "object"
      properties:
        marketCap:
          type: "number"
          description: "Total Bitcoin market capitalization"
        currency:
          type: "string"
          example: "USD"
        source:
          type: "string"
          example: "blockchain.info"
        timestamp:
          type: "string"
          format: "date-time"
      required:
        - "marketCap"
        - "currency"
        - "source"
        - "timestamp"
    DetailedGasPrices:
      type: "object"
      properties:
        chainId:
          type: "number"
        fast:
          type: "object"
          properties: &ref_2
            gasPrice:
              type: "number"
            maxFee:
              type: "number"
            maxPriorityFee:
              type: "number"
            estimatedTime:
              type: "number"
        standard:
          type: "object"
          properties: *ref_2
        slow:
          type: "object"
          properties: *ref_2
        timestamp:
          type: "string"
