{"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**1004 API operations across 997 paths** 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/api) — 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/api/postman-collection.json)\n- [🤖 ATV.eth](https://atv.eth.limo) — About the builder\n | Updated 2026-09-03: Added ENSIP-25 agent identity, EIP-7702 security, identity cross-linking, MCP server, and tiered x402 pricing.","version":"3.0.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"},"x-p3-updated-at":"2026-09-03T20:36:53.180Z","x-p3-agent":"ATV P3 improvement pass 2026-09-03","x-last-updated":"2026-09-04","x-agent-discovery":{"agent-json":"https://api.web3identity.com/agent.json","x402-discovery":"https://api.web3identity.com/.well-known/x402","llms-txt":"https://api.web3identity.com/llms.txt","postman":"https://api.web3identity.com/postman-collection.json","mcp":"https://api.web3identity.com/mcp.json"}},"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)"},{"name":"Auto-Generated","description":"Auto-generated stubs from Gate 16 route surface extraction. These require manual schema refinement."},{"name":"Identity","description":"Cross-protocol identity links (ENS + Farcaster + Lens)"},{"name":"MCP","description":"Model Context Protocol server — tool integration for AI agents"},{"name":"x402","description":"x402 payment protocol analytics and settlement status"}],"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error - Something went wrong on our end","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Internal server error","code":"INTERNAL_ERROR"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error - Something went wrong on our end","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Internal server error","code":"INTERNAL_ERROR"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error - Something went wrong on our end","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Internal server error","code":"INTERNAL_ERROR"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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":5e-8,"unit":"BTC","source":"blockchain.info","timestamp":"2026-02-18T04:44:33.292Z"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error - Something went wrong on our end","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Internal server error","code":"INTERNAL_ERROR"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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":3e-8,"satoshisPerBlock":3,"source":"blockchain.info","timestamp":"2026-02-18T04:44:33.415Z"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error - Something went wrong on our end","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Internal server error","code":"INTERNAL_ERROR"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"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"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error - Something went wrong on our end","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Internal server error","code":"INTERNAL_ERROR"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error - Something went wrong on our end","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Internal server error","code":"INTERNAL_ERROR"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error - Something went wrong on our end","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Internal server error","code":"INTERNAL_ERROR"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error - Something went wrong on our end","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Internal server error","code":"INTERNAL_ERROR"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"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"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error - Something went wrong on our end","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"Internal server error","code":"INTERNAL_ERROR"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Current gas prices for Ethereum","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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"DeFi yield farming opportunities","security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Estimated value/appraisal for ENS name","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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Address not found on Farcaster","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}]}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"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"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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=="}}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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=="}}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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=="}}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Layer 2 network stats and TVL","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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Lens Protocol profile","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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Crypto Fear & Greed Index","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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Trending tokens and protocols","security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/api/network/metrics/btc":{"get":{"tags":["Prices"],"summary":"BTC metrics","operationId":"getBtcMetrics","x-price":"$0.01","responses":{"200":{"description":"Network market metrics. Returns 200 when at least one upstream source is available; failed sources are reported in sources/degraded.","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","example":"ETH"},"prices":{"type":"object","properties":{"coinpaprika":{"type":"number","nullable":true},"coincap":{"type":"number","nullable":true}}},"marketCap":{"type":"number","nullable":true},"volume24h":{"type":"number","nullable":true},"fearGreed":{"type":"integer","nullable":true,"description":"BTC only"},"source":{"type":"string","example":"aggregated"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"ok":{"type":"boolean"},"error":{"type":"string"}}}},"degraded":{"type":"boolean","description":"True when at least one upstream metrics source failed but another source supplied data."},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request - invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"503":{"description":"Metrics sources unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/api/network/metrics/eth":{"get":{"tags":["Prices"],"summary":"ETH metrics","operationId":"getEthMetrics","x-price":"$0.01","responses":{"200":{"description":"Network market metrics. Returns 200 when at least one upstream source is available; failed sources are reported in sources/degraded.","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","example":"ETH"},"prices":{"type":"object","properties":{"coinpaprika":{"type":"number","nullable":true},"coincap":{"type":"number","nullable":true}}},"marketCap":{"type":"number","nullable":true},"volume24h":{"type":"number","nullable":true},"fearGreed":{"type":"integer","nullable":true,"description":"BTC only"},"source":{"type":"string","example":"aggregated"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"ok":{"type":"boolean"},"error":{"type":"string"}}}},"degraded":{"type":"boolean","description":"True when at least one upstream metrics source failed but another source supplied data."},"timestamp":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Bad request - invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"503":{"description":"Metrics sources unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"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"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"parameters":[{"name":"chain","in":"query","schema":{"type":"string"},"description":"Blockchain (ethereum, polygon, base)","example":"ethereum"}],"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"parameters":[{"name":"chain","in":"query","schema":{"type":"string"},"description":"Blockchain (ethereum, polygon, base)","example":"ethereum"}],"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"parameters":[{"name":"chain","in":"query","schema":{"type":"string"},"description":"Blockchain (ethereum, polygon, base)","example":"ethereum"}],"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"parameters":[{"name":"chain","in":"query","schema":{"type":"string"},"description":"Blockchain (ethereum, polygon, base)","example":"ethereum"}],"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"parameters":[{"name":"chain","in":"query","schema":{"type":"string"},"description":"Blockchain (ethereum, polygon, base)","example":"ethereum"}],"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"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-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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/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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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/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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Get current price for a token (9-source fallback)","security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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/{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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"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-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"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-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"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-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"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-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"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-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"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-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"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-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","default":"1"},"description":"Chain ID for EIP-7702 delegation check (1=Ethereum, 8453=Base, 10=Optimism, 42161=Arbitrum)"}],"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"description":" | Updated 2026-09-03: Added EIP-7702 delegation detection. Accepts optional ?chain=<chainId> query param for multi-chain delegation check."}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Get current price for a token (9-source fallback)","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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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":{"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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":{"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"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-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"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-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"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-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"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-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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":[]}],"x-implemented":false,"x-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"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-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}],"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-deprecated-at":"2026-02-19","x-lifecycle":{"status":"active","since":"2026-01-01","sunset":null,"replacement":null,"note":null}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"security":[{},{"ApiKeyAuth":[]},{"X402Payment":[]}]}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Disable. Authentication endpoint for wallet-based access control. 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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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":984},"paths":{"type":"number","description":"Number of documented OpenAPI paths","example":978},"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":"Operational success percentage; handled client errors and expected x402 402 payment challenges are counted separately from server failures"},"expectedPaymentChallenges":{"type":"number","description":"Expected x402 payment challenge responses counted as handled API outcomes"},"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"},"clientErrors":{"type":"number","description":"Handled client-side error responses (4xx excluding expected x402 402 challenges)"},"serverErrors":{"type":"number","description":"Server or upstream error responses (5xx)"},"rateLimited":{"type":"number","description":"Handled rate-limit responses (429)"},"notFound":{"type":"number","description":"Handled not-found responses (404)"}}},"example":{"status":"healthy","version":"2.9.0","endpoints":984,"paths":978,"verification":{"verified_at":"2026-02-17T04:00:31.878Z","total_documented":984,"total_working":984,"success_rate":"100%"},"payment":"enabled","requestsToday":714,"avgResponseTime":42,"successRate":100,"expectedPaymentChallenges":15,"uniqueUsers":8,"cache":{"connected":true,"keys":1,"memory":"999.96K"},"uptime":7929,"memory":"70MB","timestamp":"2026-02-17T23:53:54.711Z"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"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"}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Chain. DEX aggregator data and statistics. 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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"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"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Export. Authentication endpoint for wallet-based access control. 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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"},"402":{"description":"Payment Required - x402 micropayment needed","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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Statistics. Bitcoin network statistics and blockchain data. Free tier: 100 calls/day."}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Btc-dominance.  Free tier: 100 calls/day."}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Coin.  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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Solidly.  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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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}]}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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}}]}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"},"402":{"description":"Payment Required - x402 micropayment needed","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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Gnosis.  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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Gas. Blockchain gas price tracking. Free tier: 100 calls/day."}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Marketcap.  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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Image-proxy.  Free tier: 100 calls/day."}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Health. Lens Protocol social graph data. 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"},"402":{"description":"Payment Required - x402 micropayment needed","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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Exchange-rates. Cryptocurrency market overview and statistics. Free tier: 100 calls/day."}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Status.  Free tier: 100 calls/day."}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Health.  Free tier: 100 calls/day.","security":[{"SiweAuth":[]},{"ApiKeyAuth":[]}]}},"/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"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Payment Required","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","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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":[]}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Check.  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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"},"402":{"description":"Payment Required - x402 micropayment needed","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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Bitcoin. Smart contract analysis and verification. Free tier: 100 calls/day."}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Summary.  Free tier: 100 calls/day."}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Subnames. ENS subname registration and management. Free tier: 100 calls/day."},"post":{"operationId":"auto_post_subnames_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for POST /api/subnames/{parent}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Subnames. ENS subname registration and management. Free tier: 100 calls/day."},"put":{"operationId":"auto_put_subnames_by_param_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for PUT /api/subnames/{parent}/{name}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}},"delete":{"operationId":"auto_delete_subnames_by_param_by_param","summary":"UPGRADED: Runtime route detected by Gate 16","description":"Auto-generated stub for DELETE /api/subnames/{parent}/{name}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 3 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"parent":{"type":"string"},"name":{"type":"string"},"fullName":{"type":"string"},"deleted":{"type":"boolean"},"timestamp":{"type":"string"}},"required":["success","parent","name","fullName","deleted","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Pairs.  Free tier: 100 calls/day."}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Timestamp.  Free tier: 100 calls/day."}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Ccip.  Free tier: 100 calls/day."}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/graph/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}},"description":"Subgraphs.  Free tier: 100 calls/day."}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}},"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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/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"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/batch/ethereum":{"get":{"operationId":"auto_get_batch_ethereum","summary":"UPGRADED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/batch/ethereum. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"gasPrice":{"type":"string"},"ethPrice":{"type":"string","nullable":true},"tvl":{"type":"integer"},"timestamp":{"type":"string"}},"required":["chain","gasPrice","tvl","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/batch/base":{"get":{"operationId":"auto_get_batch_base","summary":"UPGRADED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/batch/base. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"gasPrice":{"type":"string"},"ethPrice":{"type":"string","nullable":true},"tvl":{"type":"integer"},"timestamp":{"type":"string"}},"required":["chain","gasPrice","tvl","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/batch/arbitrum":{"get":{"operationId":"auto_get_batch_arbitrum","summary":"UPGRADED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/batch/arbitrum. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"gasPrice":{"type":"string"},"ethPrice":{"type":"string","nullable":true},"tvl":{"type":"integer"},"timestamp":{"type":"string"}},"required":["chain","gasPrice","tvl","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/batch/optimism":{"get":{"operationId":"auto_get_batch_optimism","summary":"UPGRADED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/batch/optimism. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"gasPrice":{"type":"string"},"ethPrice":{"type":"string","nullable":true},"tvl":{"type":"string","nullable":true},"timestamp":{"type":"string"}},"required":["chain","gasPrice","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/batch/polygon":{"get":{"operationId":"auto_get_batch_polygon","summary":"UPGRADED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/batch/polygon. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"gasPrice":{"type":"string"},"maticPrice":{"type":"string","nullable":true},"tvl":{"type":"integer"},"timestamp":{"type":"string"}},"required":["chain","gasPrice","tvl","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/batch/market":{"get":{"operationId":"auto_get_batch_market","summary":"UPGRADED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/batch/market. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"fearGreedIndex":{"type":"string","nullable":true},"btcPrice":{"type":"string","nullable":true},"ethPrice":{"type":"string","nullable":true},"timestamp":{"type":"string"}},"required":["timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/batch/defi":{"get":{"operationId":"auto_get_batch_defi","summary":"UPGRADED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/batch/defi. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"totalTvl":{"type":"integer"},"chainCount":{"type":"integer"},"protocolCount":{"type":"integer"},"topProtocols":{"type":"array","items":{"type":"object"}},"topChains":{"type":"array","items":{"type":"object"}},"timestamp":{"type":"string"}},"required":["totalTvl","chainCount","protocolCount","topProtocols","topChains","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/batch/ens":{"post":{"operationId":"auto_post_batch_ens","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for POST /api/batch/ens. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/coins/categories/{category}":{"get":{"operationId":"auto_get_coins_categories_by_param","summary":"UPGRADED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/coins/categories/{category}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 3 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string"},"categoryName":{"type":"string"},"count":{"type":"integer"},"page":{"type":"integer"},"limit":{"type":"integer"},"tokens":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"price":{"type":"number"},"change24h":{"type":"number"},"marketCap":{"type":"integer"},"volume24h":{"type":"integer"},"rank":{"type":"string","nullable":true},"image":{"type":"string"}},"required":["id","symbol","name","price","change24h","marketCap","volume24h","image"],"additionalProperties":false}},"source":{"type":"string"},"cached":{"type":"boolean"},"timestamp":{"type":"string"}},"required":["category","categoryName","count","page","limit","tokens","source","cached","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/ens/{nameOrDomain}":{"get":{"operationId":"auto_get_ens_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/ens/{nameOrDomain}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/ethereum/status":{"get":{"operationId":"auto_get_ethereum_status","summary":"UPGRADED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/ethereum/status. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"network":{"type":"string"},"syncing":{"type":"boolean"},"healthy":{"type":"boolean"},"latencyMs":{"type":"integer"},"timestamp":{"type":"string"}},"required":["network","syncing","healthy","latencyMs","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/base/status":{"get":{"operationId":"auto_get_base_status","summary":"UPGRADED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/base/status. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"network":{"type":"string"},"syncing":{"type":"boolean"},"healthy":{"type":"boolean"},"latencyMs":{"type":"integer"},"timestamp":{"type":"string"}},"required":["network","syncing","healthy","latencyMs","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/arbitrum/status":{"get":{"operationId":"auto_get_arbitrum_status","summary":"UPGRADED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/arbitrum/status. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"network":{"type":"string"},"syncing":{"type":"boolean"},"healthy":{"type":"boolean"},"latencyMs":{"type":"integer"},"timestamp":{"type":"string"}},"required":["network","syncing","healthy","latencyMs","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/optimism/status":{"get":{"operationId":"auto_get_optimism_status","summary":"UPGRADED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/optimism/status. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"network":{"type":"string"},"syncing":{"type":"boolean"},"healthy":{"type":"boolean"},"latencyMs":{"type":"integer"},"timestamp":{"type":"string"}},"required":["network","syncing","healthy","latencyMs","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/polygon/status":{"get":{"operationId":"auto_get_polygon_status","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/polygon/status. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"network":{"type":"string"},"syncing":{"type":"boolean"},"healthy":{"type":"boolean"},"latencyMs":{"type":"integer"},"timestamp":{"type":"string"}},"required":["network","syncing","healthy","latencyMs","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/bsc/status":{"get":{"operationId":"auto_get_bsc_status","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/bsc/status. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"network":{"type":"string"},"syncing":{"type":"boolean"},"healthy":{"type":"boolean"},"latencyMs":{"type":"integer"},"timestamp":{"type":"string"}},"required":["network","syncing","healthy","latencyMs","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/avalanche/status":{"get":{"operationId":"auto_get_avalanche_status","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/avalanche/status. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"network":{"type":"string"},"syncing":{"type":"boolean"},"healthy":{"type":"boolean"},"latencyMs":{"type":"integer"},"timestamp":{"type":"string"}},"required":["network","syncing","healthy","latencyMs","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/fantom/status":{"get":{"operationId":"auto_get_fantom_status","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/fantom/status. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"network":{"type":"string"},"healthy":{"type":"boolean"},"error":{"type":"string"},"timestamp":{"type":"string"}},"required":["network","healthy","error","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/gnosis/status":{"get":{"operationId":"auto_get_gnosis_status","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/gnosis/status. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"network":{"type":"string"},"syncing":{"type":"boolean"},"healthy":{"type":"boolean"},"latencyMs":{"type":"integer"},"timestamp":{"type":"string"}},"required":["network","syncing","healthy","latencyMs","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/status/all":{"get":{"operationId":"auto_get_status_all","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/status/all. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"networks":{"type":"array","items":{"type":"object","properties":{"network":{"type":"string"},"syncing":{"type":"boolean"},"healthy":{"type":"boolean"},"latencyMs":{"type":"integer"},"timestamp":{"type":"string"}},"required":["network","syncing","healthy","latencyMs","timestamp"],"additionalProperties":false}},"healthy":{"type":"integer"},"total":{"type":"integer"},"healthPercentage":{"type":"integer"},"timestamp":{"type":"string"}},"required":["networks","healthy","total","healthPercentage","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/events/upcoming":{"get":{"operationId":"auto_get_events_upcoming","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/events/upcoming. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"date":{"type":"string"},"date_to":{"type":"string","nullable":true},"name":{"type":"string"},"description":{"type":"string"},"is_conference":{"type":"boolean"},"link":{"type":"string"},"proof_image_link":{"type":"string","nullable":true}},"required":["id","date","name","description","is_conference","link"],"additionalProperties":false}},"source":{"type":"string"},"timestamp":{"type":"string"}},"required":["events","source","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/events":{"get":{"operationId":"auto_get_events","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/events. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"note":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"timestamp":{"type":"string"}},"required":["note","sources","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/og/lookup/{nameOrAddress}":{"get":{"operationId":"auto_get_og_lookup_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/og/lookup/{nameOrAddress}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/protocols/uniswap":{"get":{"operationId":"auto_get_protocols_uniswap","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/protocols/uniswap. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/qr/url":{"get":{"operationId":"auto_get_qr_url","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/qr/url. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/qr/address/{address}":{"get":{"operationId":"auto_get_qr_address_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/qr/address/{address}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/qr/ens/{name}":{"get":{"operationId":"auto_get_qr_ens_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/qr/ens/{name}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/qr/payment":{"get":{"operationId":"auto_get_qr_payment","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/qr/payment. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/qr/profile/{name}":{"get":{"operationId":"auto_get_qr_profile_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/qr/profile/{name}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/stablecoin/{asset}":{"get":{"operationId":"auto_get_stablecoin_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/stablecoin/{asset}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/stablecoin/{id}/chains":{"get":{"operationId":"auto_get_stablecoin_by_param_chains","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/stablecoin/{id}/chains. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/stablecoin/usdt":{"get":{"operationId":"auto_get_stablecoin_usdt","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/stablecoin/usdt. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"pegType":{"type":"string"},"price":{"type":"number"},"circulating":{"type":"object","properties":{"peggedUSD":{"type":"number"}},"required":["peggedUSD"],"additionalProperties":false},"chains":{"type":"array","items":{"type":"string"}},"source":{"type":"string"},"timestamp":{"type":"string"}},"required":["name","symbol","pegType","price","circulating","chains","source","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/stablecoin/usdc":{"get":{"operationId":"auto_get_stablecoin_usdc","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/stablecoin/usdc. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"pegType":{"type":"string"},"price":{"type":"number"},"circulating":{"type":"object","properties":{"peggedUSD":{"type":"number"}},"required":["peggedUSD"],"additionalProperties":false},"chains":{"type":"array","items":{"type":"string"}},"source":{"type":"string"},"timestamp":{"type":"string"}},"required":["name","symbol","pegType","price","circulating","chains","source","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/stablecoin/dai":{"get":{"operationId":"auto_get_stablecoin_dai","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/stablecoin/dai. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"pegType":{"type":"string"},"price":{"type":"number"},"circulating":{"type":"object","properties":{"peggedUSD":{"type":"number"}},"required":["peggedUSD"],"additionalProperties":false},"chains":{"type":"array","items":{"type":"string"}},"source":{"type":"string"},"timestamp":{"type":"string"}},"required":["name","symbol","pegType","price","circulating","chains","source","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/stablecoin/frax":{"get":{"operationId":"auto_get_stablecoin_frax","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/stablecoin/frax. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"pegType":{"type":"string"},"price":{"type":"number"},"circulating":{"type":"object","properties":{"peggedUSD":{"type":"number"}},"required":["peggedUSD"],"additionalProperties":false},"chains":{"type":"array","items":{"type":"string"}},"source":{"type":"string"},"timestamp":{"type":"string"}},"required":["name","symbol","pegType","price","circulating","chains","source","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/stablecoin/lusd":{"get":{"operationId":"auto_get_stablecoin_lusd","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/stablecoin/lusd. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"pegType":{"type":"string"},"price":{"type":"number"},"circulating":{"type":"object","properties":{"peggedUSD":{"type":"number"}},"required":["peggedUSD"],"additionalProperties":false},"chains":{"type":"array","items":{"type":"string"}},"source":{"type":"string"},"timestamp":{"type":"string"}},"required":["name","symbol","pegType","price","circulating","chains","source","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/usdt":{"get":{"operationId":"auto_get_usdt","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/usdt. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"circulating":{"type":"number"},"price":{"type":"number"},"pegMechanism":{"type":"string"},"chains":{"type":"array","items":{"type":"string"}},"source":{"type":"string"},"timestamp":{"type":"string"}},"required":["name","symbol","circulating","price","pegMechanism","chains","source","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/usdc":{"get":{"operationId":"auto_get_usdc","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/usdc. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"circulating":{"type":"number"},"price":{"type":"number"},"pegMechanism":{"type":"string"},"chains":{"type":"array","items":{"type":"string"}},"source":{"type":"string"},"timestamp":{"type":"string"}},"required":["name","symbol","circulating","price","pegMechanism","chains","source","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/dai":{"get":{"operationId":"auto_get_dai","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/dai. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"circulating":{"type":"number"},"price":{"type":"number"},"pegMechanism":{"type":"string"},"chains":{"type":"array","items":{"type":"string"}},"source":{"type":"string"},"timestamp":{"type":"string"}},"required":["name","symbol","circulating","price","pegMechanism","chains","source","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/frax":{"get":{"operationId":"auto_get_frax","summary":"STRICTIFIED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/frax. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (inferred from 1 production samples)","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"circulating":{"type":"number"},"price":{"type":"number"},"pegMechanism":{"type":"string"},"chains":{"type":"array","items":{"type":"string"}},"source":{"type":"string"},"timestamp":{"type":"string"}},"required":["name","symbol","circulating","price","pegMechanism","chains","source","timestamp"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/usde":{"get":{"operationId":"auto_get_usde","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/usde. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/tusd":{"get":{"operationId":"auto_get_tusd","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/tusd. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/busd":{"get":{"operationId":"auto_get_busd","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/busd. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/gusd":{"get":{"operationId":"auto_get_gusd","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/gusd. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/lusd":{"get":{"operationId":"auto_get_lusd","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/lusd. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/susd":{"get":{"operationId":"auto_get_susd","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/susd. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/stablecoins/{coin}":{"get":{"operationId":"auto_get_stablecoins_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/stablecoins/{coin}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/ta/{symbol}":{"get":{"operationId":"auto_get_ta_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/ta/{symbol}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/ta/breakouts":{"get":{"operationId":"auto_get_ta_breakouts","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/ta/breakouts. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/ta/correlation":{"get":{"operationId":"auto_get_ta_correlation","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/ta/correlation. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/ta/support-resistance/{symbol}":{"get":{"operationId":"auto_get_ta_support_resistance_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/ta/support-resistance/{symbol}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/ta/ma-ribbon/{symbol}":{"get":{"operationId":"auto_get_ta_ma_ribbon_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/ta/ma-ribbon/{symbol}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/ta/bollinger/{symbol}":{"get":{"operationId":"auto_get_ta_bollinger_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/ta/bollinger/{symbol}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/ta/fear-greed":{"get":{"operationId":"auto_get_ta_fear_greed","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/ta/fear-greed. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/ta/performance/{symbol}":{"get":{"operationId":"auto_get_ta_performance_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/ta/performance/{symbol}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/ta/volatility/{symbol}":{"get":{"operationId":"auto_get_ta_volatility_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/ta/volatility/{symbol}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/tokens/{symbol}/chains":{"get":{"operationId":"auto_get_tokens_by_param_chains","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/tokens/{symbol}/chains. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"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","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/tx/{hash}/receipt":{"get":{"operationId":"auto_get_tx_by_param_receipt","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/tx/{hash}/receipt. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/category/{category}":{"get":{"operationId":"auto_get_category_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/category/{category}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/ranking":{"get":{"operationId":"auto_get_ranking","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/ranking. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/tvl/{protocol}":{"get":{"operationId":"auto_get_tvl_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/tvl/{protocol}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/user/keys":{"get":{"operationId":"auto_get_user_keys","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/user/keys. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}},"post":{"operationId":"auto_post_user_keys","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for POST /api/user/keys. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/user/keys/{keyId}":{"delete":{"operationId":"auto_delete_user_keys_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for DELETE /api/user/keys/{keyId}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}},"patch":{"operationId":"auto_patch_user_keys_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for PATCH /api/user/keys/{keyId}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/user/keys/{keyId}/rotate":{"post":{"operationId":"auto_post_user_keys_by_param_rotate","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for POST /api/user/keys/{keyId}/rotate. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/user/audit":{"get":{"operationId":"auto_get_user_audit","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/user/audit. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/user/keys/{keyId}/audit":{"get":{"operationId":"auto_get_user_keys_by_param_audit","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/user/keys/{keyId}/audit. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/user/keys/{keyId}/extend":{"post":{"operationId":"auto_post_user_keys_by_param_extend","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for POST /api/user/keys/{keyId}/extend. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/exchange/volumes":{"get":{"operationId":"auto_get_exchange_volumes","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/exchange/volumes. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/ethereum":{"get":{"operationId":"auto_get_ethereum","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/ethereum. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/arbitrum":{"get":{"operationId":"auto_get_arbitrum","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/arbitrum. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/optimism":{"get":{"operationId":"auto_get_optimism","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/optimism. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/base":{"get":{"operationId":"auto_get_base","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/base. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/polygon":{"get":{"operationId":"auto_get_polygon","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/polygon. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/bsc":{"get":{"operationId":"auto_get_bsc","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/bsc. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/avalanche":{"get":{"operationId":"auto_get_avalanche","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/avalanche. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/fantom":{"get":{"operationId":"auto_get_fantom","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/fantom. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/solana":{"get":{"operationId":"auto_get_solana","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/solana. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/gnosis":{"get":{"operationId":"auto_get_gnosis","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/gnosis. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/linea":{"get":{"operationId":"auto_get_linea","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/linea. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/scroll":{"get":{"operationId":"auto_get_scroll","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/scroll. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/zksync":{"get":{"operationId":"auto_get_zksync","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/zksync. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/mantle":{"get":{"operationId":"auto_get_mantle","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/mantle. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/mode":{"get":{"operationId":"auto_get_mode","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/mode. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/moonbeam":{"get":{"operationId":"auto_get_moonbeam","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/moonbeam. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/celo":{"get":{"operationId":"auto_get_celo","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/celo. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/cex-vs-dex":{"get":{"operationId":"auto_get_cex_vs_dex","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/cex-vs-dex. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/aave":{"get":{"operationId":"auto_get_aave","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/aave. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/compound":{"get":{"operationId":"auto_get_compound","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/compound. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/lido":{"get":{"operationId":"auto_get_lido","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/lido. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/convex":{"get":{"operationId":"auto_get_convex","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/convex. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/yearn":{"get":{"operationId":"auto_get_yearn","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/yearn. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/curve":{"get":{"operationId":"auto_get_curve","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/curve. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/pendle":{"get":{"operationId":"auto_get_pendle","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/pendle. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/eigenlayer":{"get":{"operationId":"auto_get_eigenlayer","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/eigenlayer. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/chain/ethereum":{"get":{"operationId":"auto_get_chain_ethereum","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/chain/ethereum. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/chain/fantom":{"get":{"operationId":"auto_get_chain_fantom","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/chain/fantom. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/chain/solana":{"get":{"operationId":"auto_get_chain_solana","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/chain/solana. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/eth":{"get":{"operationId":"auto_get_eth","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/eth. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/btc":{"get":{"operationId":"auto_get_btc","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/btc. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/stables":{"get":{"operationId":"auto_get_stables","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/stables. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/high-apy":{"get":{"operationId":"auto_get_high_apy","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/high-apy. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/median/{chain}":{"get":{"operationId":"auto_get_median_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/median/{chain}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/pool/{uuid}":{"get":{"operationId":"auto_get_pool_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/pool/{uuid}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/top":{"get":{"operationId":"auto_get_top","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/top. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/project/{name}":{"get":{"operationId":"auto_get_project_by_param","summary":"AUTO-GENERATED: Runtime route detected by Gate 16","description":"Auto-generated stub for GET /api/project/{name}. Requires schema refinement and proper documentation.","tags":["Auto-Generated"],"x-lifecycle":{"status":"active","visibility":"public","note":"Generated by Gate 16 route surface extraction - needs manual refinement"},"x-implemented":true,"responses":{"200":{"description":"Successful response (stub)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"description":"Response schema needs to be defined"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/crypto/list":{"get":{"operationId":"getCryptoList","summary":"List supported cryptocurrencies","description":"Get list of all supported cryptocurrencies and trading pairs (3,000+)","tags":["Crypto Market"],"responses":{"200":{"description":"List of supported cryptocurrencies","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean"},"resultset_size":{"type":"integer"},"result":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"source":{"type":"string"}}}}}}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/crypto/data/{symbol}":{"get":{"operationId":"getCryptoData","summary":"Get live crypto data","description":"Get real-time price and market data for a cryptocurrency","tags":["Crypto Market"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"example":"BTC"}],"responses":{"200":{"description":"Live cryptocurrency data","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"symbols":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"last":{"type":"string"},"lowest":{"type":"string"},"highest":{"type":"string"},"daily_change_percentage":{"type":"string"}}}}}}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/crypto/data":{"get":{"operationId":"getCryptoDataMultiple","summary":"Get live data for multiple cryptos","description":"Get real-time price data for multiple cryptocurrencies","tags":["Crypto Market"],"parameters":[{"name":"symbols","in":"query","required":true,"schema":{"type":"string"},"example":"BTC,ETH,SOL"}],"responses":{"200":{"description":"Live cryptocurrency data for multiple symbols"},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/crypto/exchange/{exchange}":{"get":{"operationId":"getCryptoExchange","summary":"Get exchange pairs","description":"Get all trading pairs and their latest data on a specific exchange","tags":["Crypto Market"],"parameters":[{"name":"exchange","in":"path","required":true,"schema":{"type":"string","enum":["binance","okx","bybit","kucoin","gateio"]},"example":"binance"}],"responses":{"200":{"description":"Exchange trading pairs and data"},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/crypto/convert":{"get":{"operationId":"convertCrypto","summary":"Convert between cryptocurrencies","description":"Convert between any two cryptocurrencies","tags":["Crypto Market"],"parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string"},"example":"BTC"},{"name":"to","in":"query","required":true,"schema":{"type":"string"},"example":"ETH"},{"name":"amount","in":"query","schema":{"type":"number"},"example":1}],"responses":{"200":{"description":"Conversion result"},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/agent/verify/{ensName}/{registryChain}/{tokenId}":{"get":{"tags":["Agent"],"summary":"Verify ENSIP-25 agent identity","operationId":"verifyAgentENSIP25","description":"Verify ENSIP-25 association between an ENS name and a specific ERC-8004 agent NFT token. Checks the ENS text record `agent-registration[<ERC-7930-address>][<tokenId>]` and cross-validates with on-chain ERC-8004 registry data. Requires x402 payment or free tier.","parameters":[{"name":"ensName","in":"path","required":true,"schema":{"type":"string"},"description":"ENS name to verify (e.g., atv.eth)","example":"atv.eth"},{"name":"registryChain","in":"path","required":true,"schema":{"type":"string","enum":["base","ethereum","optimism","arbitrum"]},"description":"Chain where the ERC-8004 registry is deployed","example":"base"},{"name":"tokenId","in":"path","required":true,"schema":{"type":"integer"},"description":"ERC-8004 agent token ID","example":32407}],"responses":{"200":{"description":"ENSIP-25 verification result","content":{"application/json":{"schema":{"type":"object"},"example":{"ensName":"atv.eth","address":"0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b","registryChain":"base","chainId":8453,"tokenId":32407,"verified":true,"crossVerified":true,"agent":{"owner":"0xf499102c8707c6501cadd2028c6df1c6c6e813b","created":"2024-01-01T00:00:00.000Z","metadataURI":null},"standard":"ENSIP-25","timestamp":"2026-09-03T00:00:00.000Z"}}}},"400":{"description":"Bad request (invalid ENS name, chain, or tokenId)"},"402":{"description":"Payment required — free tier exhausted; send x402 USDC payment on Base","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"PAYMENT_REQUIRED","message":"Rate limit exceeded. Send x402 payment via X-Payment header.","paymentConfig":"https://api.web3identity.com/.well-known/x402"}}},"headers":{"X-Payment-Required":{"description":"x402 payment challenge","schema":{"type":"string"}}}},"429":{"description":"Rate limit exceeded — back off and retry or use x402 payment","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"RATE_LIMIT_EXCEEDED","message":"Too many requests. Retry after delay or pay via x402."}}},"headers":{"Retry-After":{"description":"Seconds until rate limit resets","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Request limit per day","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining","schema":{"type":"integer"}}}},"500":{"description":"Internal Server Error"},"503":{"description":"Service temporarily unavailable — upstream dependency issue","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"SERVICE_UNAVAILABLE","message":"Upstream service temporarily unavailable. Retry in 30s."}}}}},"security":[{"X402Payment":[]}]}},"/api/agent/lookup/{ensName}":{"get":{"tags":["Agent"],"summary":"Look up all ENSIP-25 agent registrations for an ENS name","operationId":"lookupAgentENSIP25","description":"Look up all ENSIP-25 agent-registration text records on an ENS name. Returns all agent NFT associations with verification status for each registered chain. Requires x402 payment or free tier.","parameters":[{"name":"ensName","in":"path","required":true,"schema":{"type":"string"},"description":"ENS name to look up","example":"atv.eth"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","ethereum","optimism","arbitrum"]},"description":"Filter to a specific chain (default: all supported chains)"}],"responses":{"200":{"description":"List of ENSIP-25 agent registrations","content":{"application/json":{"schema":{"type":"object"},"example":{"ensName":"atv.eth","registrations":[{"chain":"base","chainId":8453,"tokenId":32407,"registryAddress":"0x8004A169FB4a3325136EB29fA0ceB6D2e539a432"}],"count":1}}}},"400":{"description":"Bad request — missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"BAD_REQUEST","message":"Invalid or missing parameter"}}}},"402":{"description":"Payment required — free tier exhausted; send x402 USDC payment on Base","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"PAYMENT_REQUIRED","message":"Rate limit exceeded. Send x402 payment via X-Payment header.","paymentConfig":"https://api.web3identity.com/.well-known/x402"}}},"headers":{"X-Payment-Required":{"description":"x402 payment challenge","schema":{"type":"string"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"NOT_FOUND","message":"The requested resource does not exist"}}}},"429":{"description":"Rate limit exceeded — back off and retry or use x402 payment","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"RATE_LIMIT_EXCEEDED","message":"Too many requests. Retry after delay or pay via x402."}}},"headers":{"Retry-After":{"description":"Seconds until rate limit resets","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Request limit per day","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining","schema":{"type":"integer"}}}},"503":{"description":"Service temporarily unavailable — upstream dependency issue","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"SERVICE_UNAVAILABLE","message":"Upstream service temporarily unavailable. Retry in 30s."}}}}},"security":[{"X402Payment":[]}]}},"/api/agent/registry/{chain}/{registryAddress}/{tokenId}":{"get":{"tags":["Agent"],"summary":"Read ERC-8004 agent NFT metadata from registry","operationId":"getAgentRegistryToken","description":"Fetch full ERC-8004 agent NFT metadata from a specific registry contract. Returns agent endpoint, MCP reference, tags, and controlling wallet. Requires x402 payment or free tier.","parameters":[{"name":"chain","in":"path","required":true,"schema":{"type":"string","enum":["base","ethereum","optimism","arbitrum"]},"example":"base"},{"name":"registryAddress","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"description":"ERC-8004 registry contract address","example":"0x8004A169FB4a3325136EB29fA0ceB6D2e539a432"},{"name":"tokenId","in":"path","required":true,"schema":{"type":"integer"},"example":32407}],"responses":{"200":{"description":"ERC-8004 agent token data","content":{"application/json":{"schema":{"type":"object"},"example":{"chain":"base","chainId":8453,"exists":true,"agent":{"owner":"0xf499102c8707c6501cadd2028c6df1c6c6e813b","created":"2024-01-01T00:00:00.000Z"},"ensip25":{"standard":"ENSIP-25","textRecordKey":"agent-registration[...][32407]"}}}}},"400":{"description":"Bad request — missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"BAD_REQUEST","message":"Invalid or missing parameter"}}}},"402":{"description":"Payment required — free tier exhausted; send x402 USDC payment on Base","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"PAYMENT_REQUIRED","message":"Rate limit exceeded. Send x402 payment via X-Payment header.","paymentConfig":"https://api.web3identity.com/.well-known/x402"}}},"headers":{"X-Payment-Required":{"description":"x402 payment challenge","schema":{"type":"string"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"NOT_FOUND","message":"The requested resource does not exist"}}}},"429":{"description":"Rate limit exceeded — back off and retry or use x402 payment","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"RATE_LIMIT_EXCEEDED","message":"Too many requests. Retry after delay or pay via x402."}}},"headers":{"Retry-After":{"description":"Seconds until rate limit resets","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Request limit per day","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining","schema":{"type":"integer"}}}},"503":{"description":"Service temporarily unavailable — upstream dependency issue","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"SERVICE_UNAVAILABLE","message":"Upstream service temporarily unavailable. Retry in 30s."}}}}},"security":[{"X402Payment":[]}]}},"/api/identity/{identifier}/links":{"get":{"tags":["Identity"],"summary":"Cross-protocol identity links","operationId":"getIdentityLinks","description":"Returns unified cross-protocol identity data linking ENS, Farcaster, and Lens for any identifier (ENS name, Ethereum address, Farcaster FID, or username). Cross-verification status confirms both ENS text records and Farcaster custody addresses agree. Requires x402 payment or free tier.","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string"},"description":"ENS name, Ethereum address, Farcaster FID (number), or Farcaster/Lens username","example":"vitalik.eth"}],"responses":{"200":{"description":"Unified identity cross-links","content":{"application/json":{"schema":{"type":"object"},"example":{"identifier":"vitalik.eth","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","ens":{"name":"vitalik.eth","avatar":"https://..."},"farcaster":{"fid":5650,"username":"vitalik","followerCount":287000},"lens":{"handle":"lens/@vitalik"},"crossVerified":true,"timestamp":"2026-09-03T00:00:00.000Z"}}}},"400":{"description":"Bad request — missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"BAD_REQUEST","message":"Invalid or missing parameter"}}}},"402":{"description":"Payment required — free tier exhausted; send x402 USDC payment on Base","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"PAYMENT_REQUIRED","message":"Rate limit exceeded. Send x402 payment via X-Payment header.","paymentConfig":"https://api.web3identity.com/.well-known/x402"}}},"headers":{"X-Payment-Required":{"description":"x402 payment challenge","schema":{"type":"string"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"NOT_FOUND","message":"The requested resource does not exist"}}}},"429":{"description":"Rate limit exceeded — back off and retry or use x402 payment","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"RATE_LIMIT_EXCEEDED","message":"Too many requests. Retry after delay or pay via x402."}}},"headers":{"Retry-After":{"description":"Seconds until rate limit resets","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Request limit per day","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining","schema":{"type":"integer"}}}},"503":{"description":"Service temporarily unavailable — upstream dependency issue","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"SERVICE_UNAVAILABLE","message":"Upstream service temporarily unavailable. Retry in 30s."}}}}},"security":[{"X402Payment":[]}]}},"/agent.json":{"get":{"tags":["Discovery"],"summary":"Machine-readable agent capabilities manifest","operationId":"getAgentJson","description":"ENSIP-27 draft format agent capabilities manifest. Describes this API's protocols, pricing, capabilities, and endpoints for AI agent discovery.","responses":{"200":{"description":"Agent manifest (ENSIP-27 draft format)","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/llms.txt":{"get":{"tags":["Discovery"],"summary":"AI site map (llms.txt)","operationId":"getLlmsTxt","description":"Human and AI-readable site map describing this API's capabilities, endpoints, and payment model.","responses":{"200":{"description":"llms.txt content","content":{"text/plain":{"schema":{"type":"string"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/mcp":{"get":{"tags":["MCP"],"summary":"MCP server discovery manifest","operationId":"getMCPManifest","description":"Model Context Protocol server stub. Returns tool list and discovery info. Full MCP implementation at scripts/x402/mcp.mjs.","responses":{"200":{"description":"MCP server manifest with tool list"},"400":{"description":"Bad request — missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"BAD_REQUEST","message":"Invalid or missing parameter"}}}},"429":{"description":"Rate limit exceeded — back off and retry or use x402 payment","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"RATE_LIMIT_EXCEEDED","message":"Too many requests. Retry after delay or pay via x402."}}},"headers":{"Retry-After":{"description":"Seconds until rate limit resets","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Request limit per day","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining","schema":{"type":"integer"}}}},"503":{"description":"Service temporarily unavailable — upstream dependency issue","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"SERVICE_UNAVAILABLE","message":"Upstream service temporarily unavailable. Retry in 30s."}}}}}},"post":{"tags":["MCP"],"summary":"MCP JSON-RPC endpoint","operationId":"postMCPRPC","description":"MCP JSON-RPC 2.0 endpoint for tool calls. Currently a stub — start standalone MCP server for full support.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}}}},"responses":{"200":{"description":"JSON-RPC 2.0 response"},"400":{"description":"Bad request — missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"BAD_REQUEST","message":"Invalid or missing parameter"}}}},"402":{"description":"Payment required — free tier exhausted; send x402 USDC payment on Base","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"PAYMENT_REQUIRED","message":"Rate limit exceeded. Send x402 payment via X-Payment header.","paymentConfig":"https://api.web3identity.com/.well-known/x402"}}},"headers":{"X-Payment-Required":{"description":"x402 payment challenge","schema":{"type":"string"}}}},"429":{"description":"Rate limit exceeded — back off and retry or use x402 payment","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"RATE_LIMIT_EXCEEDED","message":"Too many requests. Retry after delay or pay via x402."}}},"headers":{"Retry-After":{"description":"Seconds until rate limit resets","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Request limit per day","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining","schema":{"type":"integer"}}}},"503":{"description":"Service temporarily unavailable — upstream dependency issue","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"SERVICE_UNAVAILABLE","message":"Upstream service temporarily unavailable. Retry in 30s."}}}}},"security":[{"X402Payment":[]}]}},"/api/x402/settlement-status":{"get":{"tags":["x402"],"summary":"x402 settlement status","operationId":"getX402SettlementStatus","description":"Returns current x402 payment settlement statistics: total paid requests, revenue, settlement count, and recent on-chain USDC transfer events from the merchant wallet on Base. Useful for verifying that payments are being processed correctly. Admin-only endpoint; requires SiweAuth with operator address or ApiKeyAuth.","security":[{"SiweAuth":[]},{"ApiKeyAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"minimum":1,"maximum":100},"description":"Number of recent settlement events to return","example":20},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"minimum":0},"description":"Pagination offset","example":0}],"responses":{"200":{"description":"Settlement status and recent events","content":{"application/json":{"schema":{"type":"object","properties":{"merchantAddress":{"type":"string","description":"ATV wallet receiving payments"},"network":{"type":"string","description":"Settlement network (base)"},"summary":{"type":"object","properties":{"totalPaidRequests":{"type":"integer"},"totalRevenue":{"type":"number","description":"Total USDC received"},"settlementCount":{"type":"integer","description":"On-chain settlement events"},"lastSettlementAt":{"type":"string","format":"date-time"}}},"recentSettlements":{"type":"array","items":{"type":"object","properties":{"txHash":{"type":"string"},"from":{"type":"string"},"amount":{"type":"string","description":"USDC amount"},"blockNumber":{"type":"integer"},"timestamp":{"type":"string","format":"date-time"}}}}}},"example":{"merchantAddress":"0xF499102c8707c6501CaAdD2028c6DF1c6C6E813b","network":"base","summary":{"totalPaidRequests":12450,"totalRevenue":24.9,"settlementCount":48,"lastSettlementAt":"2026-09-03T18:00:00.000Z"},"recentSettlements":[{"txHash":"0xabc123...","from":"0xBuyerAddress...","amount":"0.001","blockNumber":21000000,"timestamp":"2026-09-03T18:00:00.000Z"}]}}}},"400":{"description":"Bad request — missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"BAD_REQUEST","message":"Invalid or missing parameter"}}}},"429":{"description":"Rate limit exceeded — back off and retry or use x402 payment","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"RATE_LIMIT_EXCEEDED","message":"Too many requests. Retry after delay or pay via x402."}}},"headers":{"Retry-After":{"description":"Seconds until rate limit resets","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Request limit per day","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining","schema":{"type":"integer"}}}},"503":{"description":"Service temporarily unavailable — upstream dependency issue","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"SERVICE_UNAVAILABLE","message":"Upstream service temporarily unavailable. Retry in 30s."}}}}}}},"/api/security/eip7702/{address}":{"get":{"tags":["Security"],"summary":"EIP-7702 delegation detection","operationId":"detectEIP7702Delegation","description":"Detects whether an Ethereum address has an active EIP-7702 delegation (Pectra upgrade, May 2025). EIP-7702 allows EOAs to delegate execution to a smart contract while keeping their original address. Returns the delegate implementation address, known implementation name (e.g. \"Safe\", \"Coinbase Smart Wallet\"), and risk assessment. SIWE signature verification for this address should use ERC-1271/ERC-6492 pathways.","security":[{"X402Payment":[]}],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Ethereum address to check for EIP-7702 delegation","example":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},{"name":"chainId","in":"query","required":false,"schema":{"type":"integer","default":1},"description":"Chain ID to check on (1=Ethereum, 8453=Base, 10=Optimism)","example":1}],"responses":{"200":{"description":"EIP-7702 delegation status","content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"chainId":{"type":"integer"},"eip7702":{"type":"object","properties":{"delegated":{"type":"boolean","description":"True if EIP-7702 delegation is active"},"delegateTo":{"type":"string","nullable":true,"description":"Implementation contract address"},"delegateName":{"type":"string","nullable":true,"description":"Known implementation name (e.g. \"Coinbase Smart Wallet\", \"Safe\")"},"eip":{"type":"string","example":"EIP-7702"},"note":{"type":"string","description":"Human-readable explanation"}}},"signingImplication":{"type":"string","description":"If delegated, SIWE must use ERC-1271 isValidSignature — ecrecover alone will fail"},"timestamp":{"type":"string","format":"date-time"}}},"example":{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chainId":1,"eip7702":{"delegated":true,"delegateTo":"0x94d9e02d115646dfc18dd3cf15313872cfb729e4","delegateName":"Coinbase Smart Wallet","eip":"EIP-7702","note":"Address is an EOA that has delegated execution to a smart contract implementation (Pectra)"},"signingImplication":"Use ERC-1271 isValidSignature or ERC-6492 for signature validation","timestamp":"2026-09-03T00:00:00.000Z"}}}},"400":{"description":"Bad request — missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"BAD_REQUEST","message":"Invalid or missing parameter"}}}},"402":{"description":"Payment required — free tier exhausted; send x402 USDC payment on Base","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"PAYMENT_REQUIRED","message":"Rate limit exceeded. Send x402 payment via X-Payment header.","paymentConfig":"https://api.web3identity.com/.well-known/x402"}}},"headers":{"X-Payment-Required":{"description":"x402 payment challenge","schema":{"type":"string"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"NOT_FOUND","message":"The requested resource does not exist"}}}},"429":{"description":"Rate limit exceeded — back off and retry or use x402 payment","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"RATE_LIMIT_EXCEEDED","message":"Too many requests. Retry after delay or pay via x402."}}},"headers":{"Retry-After":{"description":"Seconds until rate limit resets","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"Request limit per day","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining","schema":{"type":"integer"}}}},"503":{"description":"Service temporarily unavailable — upstream dependency issue","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"example":{"error":"SERVICE_UNAVAILABLE","message":"Upstream service temporarily unavailable. Retry in 30s."}}}}}}},"/api/idchain/info/{name}":{"get":{"operationId":"get_idchain_info","summary":"Get ID Chain agent identity info","description":"Returns ENS-based agent identity information from idchain.world for the given name. Supports multiple chains via `?chain=base|eth|op|arb`.","tags":["Agent Identity"],"x-lifecycle":{"status":"active","visibility":"public"},"x-implemented":true,"parameters":[{"name":"name","in":"path","description":"ENS name (e.g. agent-1.eth.xid.eth)","required":true,"schema":{"type":"string"}},{"name":"chain","in":"query","description":"Chain to query: base, eth, op, arb, sepolia","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"retryAfter":{"type":"integer"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/idchain/records/{name}":{"get":{"operationId":"get_idchain_records","summary":"Get ID Chain agent DNS/ENS records","description":"Returns all ENS text records and DNS records for a given agent name on idchain.world.","tags":["Agent Identity"],"x-lifecycle":{"status":"active","visibility":"public"},"x-implemented":true,"parameters":[{"name":"name","in":"path","description":"ENS name (e.g. agent-1.eth.xid.eth)","required":true,"schema":{"type":"string"}},{"name":"chain","in":"query","description":"Chain to query: base, eth, op, arb, sepolia","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"retryAfter":{"type":"integer"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/idchain/explore":{"get":{"operationId":"get_idchain_explore","summary":"Explore registered ID Chain agents","description":"Browse all registered agent identities on idchain.world. Filter by owner address, chain, and limit results.","tags":["Agent Identity"],"x-lifecycle":{"status":"active","visibility":"public"},"x-implemented":true,"parameters":[{"name":"chain","in":"query","description":"Chain: base, eth, op, arb","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max results (1-100, default 10)","required":false,"schema":{"type":"integer"}},{"name":"owner","in":"query","description":"Filter by owner ETH address","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"retryAfter":{"type":"integer"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/idchain/subnames/{name}":{"get":{"operationId":"get_idchain_subnames","summary":"List subnames under an ID Chain name","description":"Returns all subnames registered beneath a given parent name on idchain.world.","tags":["Agent Identity"],"x-lifecycle":{"status":"active","visibility":"public"},"x-implemented":true,"parameters":[{"name":"name","in":"path","description":"Parent ENS name","required":true,"schema":{"type":"string"}},{"name":"chain","in":"query","description":"Chain: base, eth, op, arb","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max results (1-100, default 10)","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"retryAfter":{"type":"integer"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/grails/names/{name}":{"get":{"operationId":"get_grails_name","summary":"Get Grails ENS name details","description":"Returns marketplace data for a specific ENS name listed on Grails, including price, owner, and status.","tags":["ENS Marketplace"],"x-lifecycle":{"status":"active","visibility":"public"},"x-implemented":true,"parameters":[{"name":"name","in":"path","description":"ENS name (e.g. vitalik.eth)","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"retryAfter":{"type":"integer"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/grails/listings":{"get":{"operationId":"get_grails_listings","summary":"List active Grails marketplace listings","description":"Returns ENS names currently listed for sale on Grails marketplace. Filter by status (active, sold, expired).","tags":["ENS Marketplace"],"x-lifecycle":{"status":"active","visibility":"public"},"x-implemented":true,"parameters":[{"name":"status","in":"query","description":"Listing status: active, sold, expired (default: active)","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max results (1-100, default 20)","required":false,"schema":{"type":"integer"}},{"name":"offset","in":"query","description":"Pagination offset","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"retryAfter":{"type":"integer"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/grails/trending":{"get":{"operationId":"get_grails_trending","summary":"Trending ENS names on Grails","description":"Returns currently trending ENS names based on views and activity on the Grails marketplace.","tags":["ENS Marketplace"],"x-lifecycle":{"status":"active","visibility":"public"},"x-implemented":true,"parameters":[{"name":"limit","in":"query","description":"Max results (1-50, default 10)","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"retryAfter":{"type":"integer"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/grails/search":{"get":{"operationId":"get_grails_search","summary":"Search Grails ENS marketplace","description":"Search for ENS names on Grails by keyword, TLD, or price range.","tags":["ENS Marketplace"],"x-lifecycle":{"status":"active","visibility":"public"},"x-implemented":true,"parameters":[{"name":"q","in":"query","description":"Search query string","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Max results (1-50, default 10)","required":false,"schema":{"type":"integer"}},{"name":"minPrice","in":"query","description":"Min price in ETH","required":false,"schema":{"type":"number"}},{"name":"maxPrice","in":"query","description":"Max price in ETH","required":false,"schema":{"type":"number"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"retryAfter":{"type":"integer"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/grails/sales":{"get":{"operationId":"get_grails_sales","summary":"Recent ENS name sales on Grails","description":"Returns recently completed ENS name sales on Grails marketplace with buyer, seller, and price data.","tags":["ENS Marketplace"],"x-lifecycle":{"status":"active","visibility":"public"},"x-implemented":true,"parameters":[{"name":"limit","in":"query","description":"Max results (1-100, default 20)","required":false,"schema":{"type":"integer"}},{"name":"offset","in":"query","description":"Pagination offset","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"retryAfter":{"type":"integer"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/grails/analytics":{"get":{"operationId":"get_grails_analytics","summary":"Grails marketplace analytics","description":"Returns aggregate analytics for the Grails ENS marketplace: volume, sales count, average price, and trending TLDs.","tags":["ENS Marketplace"],"x-lifecycle":{"status":"active","visibility":"public"},"x-implemented":true,"parameters":[{"name":"days","in":"query","description":"Lookback window in days (default 30, max 365)","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","example":true},"message":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"retryAfter":{"type":"integer"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"message":{"type":"string"}}}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/.well-known/agent.json":{"get":{"tags":["Discovery"],"summary":"Well-known agent capabilities manifest","operationId":"getWellKnownAgentJson","description":"ENSIP-27 draft format agent capabilities manifest. Describes this API's protocols, pricing, capabilities, and endpoints for AI agent discovery.","responses":{"200":{"description":"Agent manifest (ENSIP-27 draft format)","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/postman-collection.json":{"get":{"operationId":"getPostmanCollection","tags":["Discovery"],"summary":"Postman collection","description":"Machine-readable Postman collection for importing the API surface.","responses":{"200":{"description":"Postman collection","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}},"/api/postman-collection.json":{"get":{"operationId":"getApiPostmanCollection","tags":["Discovery"],"summary":"Postman collection alias","description":"Canonical Postman collection alias requested by API clients.","responses":{"200":{"description":"Postman collection alias","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Bad request - invalid parameters or malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate Limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"503":{"description":"Service Unavailable - upstream provider temporarily unavailable or degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":true,"code":"SERVICE_UNAVAILABLE","message":"Upstream provider temporarily unavailable","timestamp":"2026-09-04T00:00:00.000Z"}}}}}}}},"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":"array","items":{"type":"object","properties":{"date":{"type":"integer","description":"Unix timestamp"},"totalLiquidityUSD":{"type":"number","description":"Total liquidity in USD"}}},"description":"Historical TVL data points"},"chain":{"type":"string","description":"Blockchain network"},"timestamp":{"type":"string","description":"When TVL was measured (ISO 8601)","format":"date-time"},"cached":{"type":"boolean","description":"Whether response is from cache"},"cachedAt":{"type":"string","description":"Cache timestamp","nullable":true},"category":{"type":"string","description":"Protocol category"},"protocols":{"type":"array","items":{"type":"object"},"description":"List of protocol objects"},"source":{"type":"string","description":"Data source identifier"},"totalTvl":{"type":"number","description":"Total value locked across all protocols","nullable":true}},"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":"boolean","description":"Whether response is from cache"},"cachedAt":{"type":"string","description":"Cache timestamp","nullable":true},"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":"number","description":"Follower count"},"following":{"type":"number","description":"Following count"},"source":{"type":"string","description":"Data source identifier"},"timestamp":{"type":"string","description":"Response generation timestamp"},"verified":{"type":"boolean","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_count":{"type":"integer","description":"Number of likes"},"recasts_count":{"type":"integer","description":"Number of recasts"},"likes":{"type":"array","items":{"type":"object"},"description":"List of likes"},"recasts":{"type":"array","items":{"type":"object"},"description":"List of recasts"}}},"replies":{"type":"object","properties":{"count":{"type":"integer","description":"Number of replies"}},"description":"Reply count object"},"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":"number","description":"Total count of casts"},"fid":{"type":"string","description":"Farcaster ID"},"includeReplies":{"type":"boolean","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":["following"],"properties":{"fid":{"type":"string","description":"Farcaster ID"},"following":{"type":"array","items":{"$ref":"#/components/schemas/FarcasterUser"},"description":"List of users being followed"},"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"},"contenthash":{"type":"string","nullable":true,"description":"Decoded ENS contenthash value, such as an IPFS CID"},"contenthashRaw":{"type":"string","nullable":true,"description":"Raw on-chain ENS contenthash bytes"},"contenthashUri":{"type":"string","nullable":true,"description":"Protocol URI for the contenthash, such as ipfs://..."},"contenthashProtocol":{"type":"string","nullable":true,"description":"Decoded contenthash protocol"},"contenthashGatewayUrl":{"type":"string","nullable":true,"description":"HTTP gateway URL when available"},"hasContenthash":{"type":"boolean","description":"Whether name has a non-empty contenthash"},"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"},"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":{"gasPrice":{"type":"number"},"maxFee":{"type":"number"},"maxPriorityFee":{"type":"number"},"estimatedTime":{"type":"number"}}},"standard":{"type":"object","properties":{"gasPrice":{"type":"number"},"maxFee":{"type":"number"},"maxPriorityFee":{"type":"number"},"estimatedTime":{"type":"number"}}},"slow":{"type":"object","properties":{"gasPrice":{"type":"number"},"maxFee":{"type":"number"},"maxPriorityFee":{"type":"number"},"estimatedTime":{"type":"number"}}},"timestamp":{"type":"string"}}}}}}