{"openapi":"3.1.0","info":{"title":"AgentForge API","version":"1.4.0","description":"Production-grade AI services for autonomous agents. All paid endpoints use the x402 payment protocol — send a request without payment to receive pricing and payment instructions. Include signed USDC payment in the X-PAYMENT header to access the service. No API keys. No accounts. No subscriptions.","contact":{"name":"AgentForge","url":"https://agentforge-taupe.vercel.app"}},"servers":[{"url":"https://agentforge-taupe.vercel.app","description":"Production"}],"paths":{"/v1/token-intel":{"post":{"operationId":"getTokenIntel","summary":"Token metadata enrichment and risk assessment","description":"Get enriched metadata, market data, and AI-generated risk assessment for any EVM or Solana token. Price: $0.015 USDC via x402.","tags":["Crypto Intelligence"],"x-x402-price":"$0.015","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.015","protocols":["x402"]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":1},"chain":{"default":"ethereum","type":"string","enum":["ethereum","base","solana","polygon","arbitrum"]}},"required":["address","chain"],"additionalProperties":false}}}},"responses":{"200":{"description":"Token intelligence result","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"address":{"type":"string"},"chain":{"type":"string"},"decimals":{"type":"number"}},"required":["name","symbol","address","chain"],"additionalProperties":false},"market":{"type":"object","properties":{"priceUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"marketCap":{"anyOf":[{"type":"number"},{"type":"null"}]},"volume24h":{"anyOf":[{"type":"number"},{"type":"null"}]},"priceChange24h":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["priceUsd","marketCap","volume24h","priceChange24h"],"additionalProperties":false},"risk":{"type":"object","properties":{"score":{"type":"number","minimum":0,"maximum":100},"flags":{"type":"array","items":{"type":"string"}},"assessment":{"type":"string"}},"required":["score","flags","assessment"],"additionalProperties":false},"metadata":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string"}},"processingTimeMs":{"type":"number"}},"required":["sources","processingTimeMs"],"additionalProperties":false},"relatedServices":{"type":"array","items":{"type":"object","properties":{"endpoint":{"type":"string"},"description":{"type":"string"},"suggestedInput":{"type":"object","properties":{},"additionalProperties":{}}},"required":["endpoint","description","suggestedInput"],"additionalProperties":false}}},"required":["token","market","risk","metadata"],"additionalProperties":false}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required"}}}},"/v1/code-review":{"post":{"operationId":"reviewCode","summary":"Smart contract security analysis with gas optimization","description":"Analyze smart contract code for security vulnerabilities, gas optimization, and best practice violations. Supports diff review mode. Price: $0.05 USDC via x402.","tags":["Security"],"x-x402-price":"$0.05","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.05","protocols":["x402"]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":50000},"previousCode":{"type":"string","maxLength":50000},"language":{"default":"solidity","type":"string","enum":["solidity","rust","move","typescript"]},"focus":{"default":"all","type":"string","enum":["security","gas_optimization","best_practices","all"]}},"required":["code","language","focus"],"additionalProperties":false}}}},"responses":{"200":{"description":"Code review result","content":{"application/json":{"schema":{"type":"object","properties":{"overallRisk":{"type":"string","enum":["low","medium","high","critical"]},"issues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["info","low","medium","high","critical"]},"category":{"type":"string"},"description":{"type":"string"},"line":{"anyOf":[{"type":"number"},{"type":"null"}]},"suggestion":{"type":"string"}},"required":["severity","category","description","suggestion"],"additionalProperties":false}},"gasOptimization":{"type":"object","properties":{"estimatedSavings":{"type":"string","enum":["none","minor","moderate","significant"]},"suggestions":{"type":"array","items":{"type":"object","properties":{"location":{"type":"string"},"currentPattern":{"type":"string"},"suggestedPattern":{"type":"string"},"estimatedGasSaved":{"type":"string"},"difficulty":{"type":"string","enum":["trivial","moderate","complex"]}},"required":["location","currentPattern","suggestedPattern","estimatedGasSaved","difficulty"],"additionalProperties":false}},"summary":{"type":"string"}},"required":["estimatedSavings","suggestions","summary"],"additionalProperties":false},"summary":{"type":"string"},"metadata":{"type":"object","properties":{"model":{"type":"string"},"processingTimeMs":{"type":"number"},"linesAnalyzed":{"type":"number"}},"required":["model","processingTimeMs","linesAnalyzed"],"additionalProperties":false},"relatedServices":{"type":"array","items":{"type":"object","properties":{"endpoint":{"type":"string"},"description":{"type":"string"},"suggestedInput":{"type":"object","properties":{},"additionalProperties":{}}},"required":["endpoint","description","suggestedInput"],"additionalProperties":false}}},"required":["overallRisk","issues","summary","metadata"],"additionalProperties":false}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required"}}}},"/v1/token-research":{"post":{"operationId":"tokenResearch","summary":"Multi-source token research with price history and holders","description":"Aggregates market data (CoinGecko), DeFi metrics (DeFiLlama), price history, holder distribution, contract verification (Etherscan), prediction markets (Polymarket), and AI risk assessment. Price: $0.03 USDC via x402.","tags":["Crypto Intelligence"],"x-x402-price":"$0.03","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.03","protocols":["x402"]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":200},"chain":{"default":"ethereum","type":"string","enum":["ethereum","base","polygon","arbitrum","optimism","avalanche"]},"include":{"default":["market_data","defi_metrics","contract_info","risk_assessment"],"type":"array","items":{"type":"string","enum":["market_data","defi_metrics","contract_info","prediction_markets","institutional","risk_assessment","price_history","holders"]}}},"required":["query","chain","include"],"additionalProperties":false}}}},"responses":{"200":{"description":"Token research result","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"address":{"type":"string"},"chain":{"type":"string"}},"required":["name","symbol","chain"],"additionalProperties":false},"marketData":{"type":"object","properties":{"priceUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"marketCap":{"anyOf":[{"type":"number"},{"type":"null"}]},"fullyDilutedValuation":{"anyOf":[{"type":"number"},{"type":"null"}]},"volume24h":{"anyOf":[{"type":"number"},{"type":"null"}]},"priceChange24h":{"anyOf":[{"type":"number"},{"type":"null"}]},"priceChange7d":{"anyOf":[{"type":"number"},{"type":"null"}]},"priceChange30d":{"anyOf":[{"type":"number"},{"type":"null"}]},"allTimeHigh":{"anyOf":[{"type":"number"},{"type":"null"}]},"allTimeHighDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"circulatingSupply":{"anyOf":[{"type":"number"},{"type":"null"}]},"totalSupply":{"anyOf":[{"type":"number"},{"type":"null"}]},"source":{"type":"string","const":"coingecko"}},"required":["priceUsd","marketCap","fullyDilutedValuation","volume24h","priceChange24h","priceChange7d","priceChange30d","allTimeHigh","allTimeHighDate","circulatingSupply","totalSupply","source"],"additionalProperties":false},"defiMetrics":{"type":"object","properties":{"tvl":{"anyOf":[{"type":"number"},{"type":"null"}]},"tvlChange24h":{"anyOf":[{"type":"number"},{"type":"null"}]},"tvlChange7d":{"anyOf":[{"type":"number"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"chains":{"type":"array","items":{"type":"string"}},"associatedProtocols":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"tvl":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["name","tvl"],"additionalProperties":false}},"source":{"type":"string","const":"defillama"}},"required":["tvl","tvlChange24h","tvlChange7d","category","chains","associatedProtocols","source"],"additionalProperties":false},"contractInfo":{"type":"object","properties":{"isVerified":{"type":"boolean"},"compilerVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"optimizationUsed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"contractName":{"anyOf":[{"type":"string"},{"type":"null"}]},"creationTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"creatorAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"implementationAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"isProxy":{"type":"boolean"},"source":{"type":"string","const":"etherscan"}},"required":["isVerified","compilerVersion","optimizationUsed","contractName","creationTxHash","creatorAddress","implementationAddress","isProxy","source"],"additionalProperties":false},"predictionMarkets":{"type":"object","properties":{"relatedMarkets":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"outcomePrices":{"type":"object","properties":{"yes":{"type":"number"},"no":{"type":"number"}},"required":["yes","no"],"additionalProperties":false},"volume":{"anyOf":[{"type":"number"},{"type":"null"}]},"slug":{"type":"string"},"url":{"type":"string"}},"required":["title","outcomePrices","volume","slug","url"],"additionalProperties":false}},"source":{"type":"string","const":"polymarket"}},"required":["relatedMarkets","source"],"additionalProperties":false},"institutional":{"type":"object","properties":{"mentions":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string"},"context":{"type":"string"},"sentiment":{"type":"string","enum":["positive","negative","neutral"]},"approximate_date":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["institution","context","sentiment","approximate_date"],"additionalProperties":false}},"summary":{"type":"string"},"source":{"type":"string","const":"llm_analysis"}},"required":["mentions","summary","source"],"additionalProperties":false},"priceHistory":{"type":"object","properties":{"prices30d":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"priceUsd":{"type":"number"}},"required":["date","priceUsd"],"additionalProperties":false}},"volatility30d":{"type":"number"},"trend":{"type":"string","enum":["up","down","sideways"]},"maxDrawdown30d":{"type":"number"},"source":{"type":"string","const":"defillama"}},"required":["prices30d","volatility30d","trend","maxDrawdown30d","source"],"additionalProperties":false},"holderDistribution":{"type":"object","properties":{"topHolders":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"balance":{"type":"string"},"percentage":{"type":"number"},"isContract":{"type":"boolean"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["address","balance","percentage","isContract","label"],"additionalProperties":false}},"concentration":{"type":"object","properties":{"top5Percentage":{"type":"number"},"top10Percentage":{"type":"number"},"top20Percentage":{"type":"number"}},"required":["top5Percentage","top10Percentage","top20Percentage"],"additionalProperties":false},"riskFlag":{"type":"boolean"},"source":{"type":"string","const":"etherscan"}},"required":["topHolders","concentration","riskFlag","source"],"additionalProperties":false},"riskAssessment":{"type":"object","properties":{"overallScore":{"type":"number","minimum":0,"maximum":100},"riskLevel":{"type":"string","enum":["low","medium","high","critical"]},"factors":{"type":"array","items":{"type":"object","properties":{"factor":{"type":"string"},"impact":{"type":"string","enum":["positive","negative","neutral"]},"detail":{"type":"string"}},"required":["factor","impact","detail"],"additionalProperties":false}},"summary":{"type":"string"}},"required":["overallScore","riskLevel","factors","summary"],"additionalProperties":false},"metadata":{"type":"object","properties":{"sourcesQueried":{"type":"array","items":{"type":"string"}},"sourcesSucceeded":{"type":"array","items":{"type":"string"}},"sourcesFailed":{"type":"array","items":{"type":"string"}},"processingTimeMs":{"type":"number"},"estimatedCostUsd":{"type":"number"},"cachedSources":{"type":"array","items":{"type":"string"}}},"required":["sourcesQueried","sourcesSucceeded","sourcesFailed","processingTimeMs","estimatedCostUsd","cachedSources"],"additionalProperties":false},"relatedServices":{"type":"array","items":{"type":"object","properties":{"endpoint":{"type":"string"},"description":{"type":"string"},"suggestedInput":{"type":"object","properties":{},"additionalProperties":{}}},"required":["endpoint","description","suggestedInput"],"additionalProperties":false}}},"required":["token","metadata"],"additionalProperties":false}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required"}}}},"/v1/contract-docs":{"post":{"operationId":"generateContractDocs","summary":"Smart contract documentation with security posture","description":"Generate human-readable documentation for any verified smart contract. Includes interaction patterns and security posture analysis. Price: $0.02 USDC via x402.","tags":["Security"],"x-x402-price":"$0.02","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.02","protocols":["x402"]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":1},"chain":{"default":"ethereum","type":"string","enum":["ethereum","base","polygon","arbitrum","optimism","avalanche"]},"focusFunctions":{"type":"array","items":{"type":"string"}}},"required":["address","chain"],"additionalProperties":false}}}},"responses":{"200":{"description":"Contract documentation result","content":{"application/json":{"schema":{"type":"object","properties":{"contract":{"type":"object","properties":{"address":{"type":"string"},"chain":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"compilerVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"isVerified":{"type":"boolean"},"isProxy":{"type":"boolean"},"implementationAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"registryLabel":{"type":"string"},"registryProtocol":{"type":"string"},"registryCategory":{"type":"string"}},"required":["address","chain","name","compilerVersion","isVerified","isProxy","implementationAddress"],"additionalProperties":false},"functions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"signature":{"type":"string"},"type":{"type":"string","enum":["read","write","payable"]},"description":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"},"description":{"type":"string"}},"required":["name","type","description"],"additionalProperties":false}},"returns":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"description":{"type":"string"}},"required":["type","description"],"additionalProperties":false}},"riskFlags":{"type":"array","items":{"type":"string","enum":["owner_only","can_transfer_funds","can_modify_state","can_pause","can_upgrade","can_mint","can_burn","can_blacklist","self_destruct","delegatecall","unchecked_external_call"]}}},"required":["name","signature","type","description","parameters","returns","riskFlags"],"additionalProperties":false}},"events":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"},"indexed":{"type":"boolean"}},"required":["name","type","indexed"],"additionalProperties":false}}},"required":["name","description","parameters"],"additionalProperties":false}},"interactionPatterns":{"type":"array","items":{"type":"object","properties":{"pattern":{"type":"string"},"description":{"type":"string"},"functions":{"type":"array","items":{"type":"string"}},"gasEstimate":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["pattern","description","functions","gasEstimate"],"additionalProperties":false}},"securityPosture":{"type":"object","properties":{"hasOwnerControls":{"type":"boolean"},"isPausable":{"type":"boolean"},"isUpgradeable":{"type":"boolean"},"hasMintCapability":{"type":"boolean"},"hasBlacklistCapability":{"type":"boolean"},"usesExternalCalls":{"type":"boolean"},"adminFunctionCount":{"type":"number"},"assessment":{"type":"string"}},"required":["hasOwnerControls","isPausable","isUpgradeable","hasMintCapability","hasBlacklistCapability","usesExternalCalls","adminFunctionCount","assessment"],"additionalProperties":false},"proxyInfo":{"type":"object","properties":{"isProxy":{"type":"boolean"},"proxyType":{"type":"string"},"proxyAddress":{"type":"string"},"implementationAddress":{"type":"string"},"governanceFramework":{"type":"string"},"note":{"type":"string"}},"required":["isProxy","proxyAddress","implementationAddress","note"],"additionalProperties":false},"summary":{"type":"object","properties":{"totalFunctions":{"type":"number"},"readFunctions":{"type":"number"},"writeFunctions":{"type":"number"},"adminFunctions":{"type":"number"},"riskLevel":{"type":"string","enum":["low","medium","high"]},"overview":{"type":"string"}},"required":["totalFunctions","readFunctions","writeFunctions","adminFunctions","riskLevel","overview"],"additionalProperties":false},"metadata":{"type":"object","properties":{"model":{"type":"string"},"processingTimeMs":{"type":"number"},"estimatedCostUsd":{"type":"number"},"abiSize":{"type":"number"}},"required":["model","processingTimeMs","estimatedCostUsd","abiSize"],"additionalProperties":false},"relatedServices":{"type":"array","items":{"type":"object","properties":{"endpoint":{"type":"string"},"description":{"type":"string"},"suggestedInput":{"type":"object","properties":{},"additionalProperties":{}}},"required":["endpoint","description","suggestedInput"],"additionalProperties":false}}},"required":["contract","functions","events","summary","metadata"],"additionalProperties":false}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required"}}}},"/v1/contract-monitor":{"post":{"operationId":"monitorContract","summary":"Contract admin activity monitor","description":"Monitor recent contract admin activity for ownership transfers, upgrades, pause state changes, and other admin operations. Price: $0.025 USDC via x402.","tags":["Security"],"x-x402-price":"$0.025","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.025","protocols":["x402"]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":1},"chain":{"default":"ethereum","type":"string","enum":["ethereum","base","polygon","arbitrum","optimism","avalanche"]},"lookbackHours":{"default":24,"type":"number","minimum":1,"maximum":168}},"required":["address","chain","lookbackHours"],"additionalProperties":false}}}},"responses":{"200":{"description":"Contract monitor result","content":{"application/json":{"schema":{"type":"object","properties":{"contract":{"type":"object","properties":{"address":{"type":"string"},"chain":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"isProxy":{"type":"boolean"},"registryLabel":{"type":"string"},"registryProtocol":{"type":"string"},"registryCategory":{"type":"string"}},"required":["address","chain","name","isProxy"],"additionalProperties":false},"recentActivity":{"type":"object","properties":{"transactionCount":{"type":"number"},"adminTransactions":{"type":"array","items":{"type":"object","properties":{"txHash":{"type":"string"},"functionName":{"type":"string"},"timestamp":{"type":"string"},"from":{"type":"string"},"summary":{"type":"string"}},"required":["txHash","functionName","timestamp","from","summary"],"additionalProperties":false}},"implementationChanged":{"type":"boolean"},"ownershipChanged":{"type":"boolean"},"pauseStateChanged":{"type":"boolean"}},"required":["transactionCount","adminTransactions","implementationChanged","ownershipChanged","pauseStateChanged"],"additionalProperties":false},"riskAlert":{"type":"object","properties":{"level":{"type":"string","enum":["none","low","medium","high","critical"]},"alerts":{"type":"array","items":{"type":"string"}},"recommendation":{"type":"string"}},"required":["level","alerts","recommendation"],"additionalProperties":false},"metadata":{"type":"object","properties":{"lookbackHours":{"type":"number"},"processingTimeMs":{"type":"number"},"estimatedCostUsd":{"type":"number"}},"required":["lookbackHours","processingTimeMs","estimatedCostUsd"],"additionalProperties":false},"relatedServices":{"type":"array","items":{"type":"object","properties":{"endpoint":{"type":"string"},"description":{"type":"string"},"suggestedInput":{"type":"object","properties":{},"additionalProperties":{}}},"required":["endpoint","description","suggestedInput"],"additionalProperties":false}}},"required":["contract","recentActivity","riskAlert","metadata"],"additionalProperties":false}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required"}}}},"/v1/token-compare":{"post":{"operationId":"compareTokens","summary":"Multi-token comparative analysis","description":"Compare a primary token against up to 3 competitors with full research, metrics, and AI comparative analysis. Price: $0.08 USDC via x402.","tags":["Crypto Intelligence"],"x-x402-price":"$0.08","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.08","protocols":["x402"]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"primary":{"type":"string","minLength":1},"compare":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string"}},"chain":{"default":"ethereum","type":"string","enum":["ethereum","base","polygon","arbitrum","optimism","avalanche"]}},"required":["primary","compare","chain"],"additionalProperties":false}}}},"responses":{"200":{"description":"Token comparison result","content":{"application/json":{"schema":{"type":"object","properties":{"primary":{"type":"object","properties":{"token":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"address":{"type":"string"},"chain":{"type":"string"}},"required":["name","symbol","chain"],"additionalProperties":false},"marketData":{"type":"object","properties":{"priceUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"marketCap":{"anyOf":[{"type":"number"},{"type":"null"}]},"fullyDilutedValuation":{"anyOf":[{"type":"number"},{"type":"null"}]},"volume24h":{"anyOf":[{"type":"number"},{"type":"null"}]},"priceChange24h":{"anyOf":[{"type":"number"},{"type":"null"}]},"priceChange7d":{"anyOf":[{"type":"number"},{"type":"null"}]},"priceChange30d":{"anyOf":[{"type":"number"},{"type":"null"}]},"allTimeHigh":{"anyOf":[{"type":"number"},{"type":"null"}]},"allTimeHighDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"circulatingSupply":{"anyOf":[{"type":"number"},{"type":"null"}]},"totalSupply":{"anyOf":[{"type":"number"},{"type":"null"}]},"source":{"type":"string","const":"coingecko"}},"required":["priceUsd","marketCap","fullyDilutedValuation","volume24h","priceChange24h","priceChange7d","priceChange30d","allTimeHigh","allTimeHighDate","circulatingSupply","totalSupply","source"],"additionalProperties":false},"defiMetrics":{"type":"object","properties":{"tvl":{"anyOf":[{"type":"number"},{"type":"null"}]},"tvlChange24h":{"anyOf":[{"type":"number"},{"type":"null"}]},"tvlChange7d":{"anyOf":[{"type":"number"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"chains":{"type":"array","items":{"type":"string"}},"associatedProtocols":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"tvl":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["name","tvl"],"additionalProperties":false}},"source":{"type":"string","const":"defillama"}},"required":["tvl","tvlChange24h","tvlChange7d","category","chains","associatedProtocols","source"],"additionalProperties":false},"contractInfo":{"type":"object","properties":{"isVerified":{"type":"boolean"},"compilerVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"optimizationUsed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"contractName":{"anyOf":[{"type":"string"},{"type":"null"}]},"creationTxHash":{"anyOf":[{"type":"string"},{"type":"null"}]},"creatorAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"implementationAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"isProxy":{"type":"boolean"},"source":{"type":"string","const":"etherscan"}},"required":["isVerified","compilerVersion","optimizationUsed","contractName","creationTxHash","creatorAddress","implementationAddress","isProxy","source"],"additionalProperties":false},"predictionMarkets":{"type":"object","properties":{"relatedMarkets":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"outcomePrices":{"type":"object","properties":{"yes":{"type":"number"},"no":{"type":"number"}},"required":["yes","no"],"additionalProperties":false},"volume":{"anyOf":[{"type":"number"},{"type":"null"}]},"slug":{"type":"string"},"url":{"type":"string"}},"required":["title","outcomePrices","volume","slug","url"],"additionalProperties":false}},"source":{"type":"string","const":"polymarket"}},"required":["relatedMarkets","source"],"additionalProperties":false},"institutional":{"type":"object","properties":{"mentions":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string"},"context":{"type":"string"},"sentiment":{"type":"string","enum":["positive","negative","neutral"]},"approximate_date":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["institution","context","sentiment","approximate_date"],"additionalProperties":false}},"summary":{"type":"string"},"source":{"type":"string","const":"llm_analysis"}},"required":["mentions","summary","source"],"additionalProperties":false},"priceHistory":{"type":"object","properties":{"prices30d":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"priceUsd":{"type":"number"}},"required":["date","priceUsd"],"additionalProperties":false}},"volatility30d":{"type":"number"},"trend":{"type":"string","enum":["up","down","sideways"]},"maxDrawdown30d":{"type":"number"},"source":{"type":"string","const":"defillama"}},"required":["prices30d","volatility30d","trend","maxDrawdown30d","source"],"additionalProperties":false},"holderDistribution":{"type":"object","properties":{"topHolders":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"balance":{"type":"string"},"percentage":{"type":"number"},"isContract":{"type":"boolean"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["address","balance","percentage","isContract","label"],"additionalProperties":false}},"concentration":{"type":"object","properties":{"top5Percentage":{"type":"number"},"top10Percentage":{"type":"number"},"top20Percentage":{"type":"number"}},"required":["top5Percentage","top10Percentage","top20Percentage"],"additionalProperties":false},"riskFlag":{"type":"boolean"},"source":{"type":"string","const":"etherscan"}},"required":["topHolders","concentration","riskFlag","source"],"additionalProperties":false},"riskAssessment":{"type":"object","properties":{"overallScore":{"type":"number","minimum":0,"maximum":100},"riskLevel":{"type":"string","enum":["low","medium","high","critical"]},"factors":{"type":"array","items":{"type":"object","properties":{"factor":{"type":"string"},"impact":{"type":"string","enum":["positive","negative","neutral"]},"detail":{"type":"string"}},"required":["factor","impact","detail"],"additionalProperties":false}},"summary":{"type":"string"}},"required":["overallScore","riskLevel","factors","summary"],"additionalProperties":false},"metadata":{"type":"object","properties":{"sourcesQueried":{"type":"array","items":{"type":"string"}},"sourcesSucceeded":{"type":"array","items":{"type":"string"}},"sourcesFailed":{"type":"array","items":{"type":"string"}},"processingTimeMs":{"type":"number"},"estimatedCostUsd":{"type":"number"},"cachedSources":{"type":"array","items":{"type":"string"}}},"required":["sourcesQueried","sourcesSucceeded","sourcesFailed","processingTimeMs","estimatedCostUsd","cachedSources"],"additionalProperties":false},"relatedServices":{"type":"array","items":{"type":"object","properties":{"endpoint":{"type":"string"},"description":{"type":"string"},"suggestedInput":{"type":"object","properties":{},"additionalProperties":{}}},"required":["endpoint","description","suggestedInput"],"additionalProperties":false}}},"required":["token","metadata"],"additionalProperties":false},"comparisons":{"type":"array","items":{"type":"object","properties":{"query":{"type":"string"},"symbol":{"type":"string"},"priceUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"marketCap":{"anyOf":[{"type":"number"},{"type":"null"}]},"tvl":{"anyOf":[{"type":"number"},{"type":"null"}]},"riskScore":{"type":"number"}},"required":["query","symbol","priceUsd","marketCap","tvl","riskScore"],"additionalProperties":false}},"analysis":{"type":"string"},"metadata":{"type":"object","properties":{"processingTimeMs":{"type":"number"},"estimatedCostUsd":{"type":"number"}},"required":["processingTimeMs","estimatedCostUsd"],"additionalProperties":false},"relatedServices":{"type":"array","items":{"type":"object","properties":{"endpoint":{"type":"string"},"description":{"type":"string"},"suggestedInput":{"type":"object","properties":{},"additionalProperties":{}}},"required":["endpoint","description","suggestedInput"],"additionalProperties":false}}},"required":["primary","comparisons","analysis","metadata"],"additionalProperties":false}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required"}}}},"/v1/tx-decode":{"post":{"operationId":"decodeTx","summary":"Decode an EVM transaction","description":"Decode any EVM transaction: function call, parameters, token transfers, and plain-English explanation. Price: $0.01 USDC via x402.","tags":["Crypto Intelligence"],"x-x402-price":"$0.01","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.01","protocols":["x402"]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"txHash":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"chain":{"default":"ethereum","type":"string","enum":["ethereum","base","polygon","arbitrum","optimism","avalanche"]}},"required":["txHash","chain"],"additionalProperties":false}}}},"responses":{"200":{"description":"Decoded transaction","content":{"application/json":{"schema":{"type":"object","properties":{"transaction":{"type":"object","properties":{"hash":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"value":{"type":"string"},"valueUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"gasUsed":{"type":"string"},"gasPrice":{"type":"string"},"gasCostUsd":{"anyOf":[{"type":"number"},{"type":"null"}]},"timestamp":{"type":"string"},"blockNumber":{"type":"number"},"status":{"type":"string","enum":["success","failed"]}},"required":["hash","from","to","value","valueUsd","gasUsed","gasPrice","gasCostUsd","timestamp","blockNumber","status"],"additionalProperties":false},"decodedCall":{"anyOf":[{"type":"object","properties":{"functionName":{"anyOf":[{"type":"string"},{"type":"null"}]},"functionSignature":{"anyOf":[{"type":"string"},{"type":"null"}]},"parameters":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"},"value":{"type":"string"},"decoded":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","type","value","decoded"],"additionalProperties":false}},"contractName":{"anyOf":[{"type":"string"},{"type":"null"}]},"contractVerified":{"type":"boolean"},"registryLabel":{"type":"string"},"registryProtocol":{"type":"string"}},"required":["functionName","functionSignature","parameters","contractName","contractVerified"],"additionalProperties":false},{"type":"null"}]},"explanation":{"type":"string"},"tokenTransfers":{"type":"array","items":{"type":"object","properties":{"token":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"amount":{"type":"string"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["token","from","to","amount","symbol"],"additionalProperties":false}},"relatedServices":{"type":"array","items":{"type":"object","properties":{"endpoint":{"type":"string"},"description":{"type":"string"},"suggestedInput":{"type":"object","properties":{},"additionalProperties":{}}},"required":["endpoint","description","suggestedInput"],"additionalProperties":false}},"metadata":{"type":"object","properties":{"chain":{"type":"string"},"processingTimeMs":{"type":"number"},"estimatedCostUsd":{"type":"number"}},"required":["chain","processingTimeMs","estimatedCostUsd"],"additionalProperties":false}},"required":["transaction","decodedCall","explanation","tokenTransfers","metadata"],"additionalProperties":false}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required"}}}},"/v1/approval-scan":{"post":{"operationId":"scanApprovals","summary":"Scan wallet for risky ERC-20 approvals","description":"Scan a wallet for ERC-20 token approvals, identify risky spenders, and generate risk assessment. Price: $0.015 USDC via x402.","tags":["Security"],"x-x402-price":"$0.015","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.015","protocols":["x402"]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","minLength":1},"chain":{"default":"ethereum","type":"string","enum":["ethereum","base","polygon","arbitrum","optimism","avalanche","solana"]}},"required":["address","chain"],"additionalProperties":false}}}},"responses":{"200":{"description":"Approval scan result","content":{"application/json":{"schema":{"type":"object","properties":{"wallet":{"type":"object","properties":{"address":{"type":"string"},"chain":{"type":"string"}},"required":["address","chain"],"additionalProperties":false},"approvals":{"type":"array","items":{"type":"object","properties":{"token":{"type":"object","properties":{"address":{"type":"string"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["address","symbol","name"],"additionalProperties":false},"spender":{"type":"object","properties":{"address":{"type":"string"},"contractName":{"anyOf":[{"type":"string"},{"type":"null"}]},"isVerified":{"type":"boolean"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"registryLabel":{"type":"string"},"registryProtocol":{"type":"string"},"registryRisk":{"type":"string"}},"required":["address","contractName","isVerified","label"],"additionalProperties":false},"allowance":{"type":"string"},"riskLevel":{"type":"string","enum":["safe","low","medium","high","critical"]},"riskReason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["token","spender","allowance","riskLevel","riskReason"],"additionalProperties":false}},"summary":{"type":"object","properties":{"totalApprovals":{"type":"number"},"unlimitedApprovals":{"type":"number"},"riskyApprovals":{"type":"number"},"overallRisk":{"type":"string","enum":["clean","low","medium","high","critical"]},"recommendation":{"type":"string"}},"required":["totalApprovals","unlimitedApprovals","riskyApprovals","overallRisk","recommendation"],"additionalProperties":false},"relatedServices":{"type":"array","items":{"type":"object","properties":{"endpoint":{"type":"string"},"description":{"type":"string"},"suggestedInput":{"type":"object","properties":{},"additionalProperties":{}}},"required":["endpoint","description","suggestedInput"],"additionalProperties":false}},"metadata":{"type":"object","properties":{"chain":{"type":"string"},"processingTimeMs":{"type":"number"},"estimatedCostUsd":{"type":"number"},"approvalsScanned":{"type":"number"}},"required":["chain","processingTimeMs","estimatedCostUsd","approvalsScanned"],"additionalProperties":false}},"required":["wallet","approvals","summary","metadata"],"additionalProperties":false}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required"}}}},"/v1/wallet-safety":{"post":{"operationId":"checkWalletSafety","summary":"Comprehensive wallet safety check","description":"Scan a wallet for risky approvals, suspicious transaction patterns, and assess target contract safety. Returns composite risk score (0-100), risk level, action items, and related service suggestions. Price: $0.035 USDC via x402.","tags":["Security"],"x-x402-price":"$0.035","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.035","protocols":["x402"]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"walletAddress":{"type":"string","minLength":1},"chain":{"default":"ethereum","type":"string","enum":["ethereum","base","arbitrum","optimism","polygon","solana"]},"targetContract":{"type":"string"},"depth":{"default":"standard","type":"string","enum":["quick","standard","deep"]}},"required":["walletAddress","chain","depth"],"additionalProperties":false}}}},"responses":{"200":{"description":"Wallet safety check result","content":{"application/json":{"schema":{"type":"object","properties":{"walletAddress":{"type":"string"},"chain":{"type":"string"},"overallRisk":{"type":"string","enum":["safe","low","medium","high","critical","unknown"]},"riskScore":{"type":"number","minimum":0,"maximum":100},"timestamp":{"type":"string"},"approvals":{"type":"object","properties":{"totalApprovals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"riskyApprovals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unlimitedApprovals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"approvalDetails":{"type":"array","items":{"type":"object","properties":{"token":{"type":"string"},"spender":{"type":"string"},"spenderLabel":{"type":"string"},"spenderProtocol":{"type":"string"},"spenderRisk":{"type":"string","enum":["safe","low","medium","high","critical","unknown"]},"allowance":{"type":"string"},"recommendation":{"type":"string","enum":["revoke","reduce","ok"]}},"required":["token","spender","spenderRisk","allowance","recommendation"],"additionalProperties":false}}},"required":["totalApprovals","riskyApprovals","unlimitedApprovals","approvalDetails"],"additionalProperties":false},"recentActivity":{"type":"object","properties":{"transactionCount30d":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"uniqueContractsInteracted":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"suspiciousPatterns":{"type":"array","items":{"type":"object","properties":{"pattern":{"type":"string"},"severity":{"type":"string","enum":["info","warning","danger"]},"description":{"type":"string"},"transactions":{"type":"array","items":{"type":"string"}}},"required":["pattern","severity","description"],"additionalProperties":false}}},"required":["transactionCount30d","uniqueContractsInteracted","suspiciousPatterns"],"additionalProperties":false},"targetContractAssessment":{"type":"object","properties":{"address":{"type":"string"},"label":{"type":"string"},"protocol":{"type":"string"},"riskLevel":{"type":"string","enum":["safe","low","medium","high","critical","unknown"]},"isVerified":{"type":"boolean"},"isProxy":{"type":"boolean"},"concerns":{"type":"array","items":{"type":"string"}},"recommendation":{"type":"string","enum":["proceed","caution","avoid"]}},"required":["address","riskLevel","isVerified","isProxy","concerns","recommendation"],"additionalProperties":false},"summary":{"type":"string"},"actionItems":{"type":"array","items":{"type":"string"}},"relatedServices":{"type":"array","items":{"type":"object","properties":{"endpoint":{"type":"string"},"description":{"type":"string"},"suggestedInput":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["endpoint","description","suggestedInput"],"additionalProperties":false}},"metadata":{"type":"object","properties":{"chain":{"type":"string"},"depth":{"type":"string","enum":["quick","standard","deep"]},"processingTimeMs":{"type":"number"},"estimatedCostUsd":{"type":"number"},"subsystemResults":{"type":"object","properties":{"approvalScan":{"type":"string","enum":["success","partial","failed"]},"recentActivity":{"type":"string","enum":["success","partial","failed","skipped"]},"targetAssessment":{"type":"string","enum":["success","partial","failed","skipped"]}},"required":["approvalScan","recentActivity","targetAssessment"],"additionalProperties":false}},"required":["chain","depth","processingTimeMs","estimatedCostUsd","subsystemResults"],"additionalProperties":false}},"required":["walletAddress","chain","overallRisk","riskScore","timestamp","approvals","summary","actionItems","relatedServices","metadata"],"additionalProperties":false}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required"}}}},"/v1/gas":{"get":{"operationId":"getGasPrice","summary":"Gas price oracle with trend analysis","description":"Current gas prices (slow/standard/fast) for any supported EVM chain with trend analysis. Price: $0.003 USDC via x402.","tags":["Crypto Intelligence"],"x-x402-price":"$0.003","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.003","protocols":["x402"]},"parameters":[{"name":"chain","in":"query","schema":{"type":"string","enum":["ethereum","base","polygon","arbitrum","optimism","avalanche"],"default":"ethereum"},"description":"EVM chain to query gas prices for"}],"responses":{"200":{"description":"Gas price data","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"currentPrices":{"type":"object","properties":{"slow":{"type":"object","properties":{"gwei":{"type":"number"},"estimatedSeconds":{"type":"number"}},"required":["gwei","estimatedSeconds"],"additionalProperties":false},"standard":{"type":"object","properties":{"gwei":{"type":"number"},"estimatedSeconds":{"type":"number"}},"required":["gwei","estimatedSeconds"],"additionalProperties":false},"fast":{"type":"object","properties":{"gwei":{"type":"number"},"estimatedSeconds":{"type":"number"}},"required":["gwei","estimatedSeconds"],"additionalProperties":false}},"required":["slow","standard","fast"],"additionalProperties":false},"baseFee":{"anyOf":[{"type":"number"},{"type":"null"}]},"trend":{"type":"string","enum":["rising","falling","stable"]},"timestamp":{"type":"string"},"metadata":{"type":"object","properties":{"source":{"type":"string","const":"etherscan"},"processingTimeMs":{"type":"number"}},"required":["source","processingTimeMs"],"additionalProperties":false}},"required":["chain","currentPrices","baseFee","trend","timestamp","metadata"],"additionalProperties":false}}}},"402":{"description":"Payment required"}}}},"/v1/sentiment":{"post":{"operationId":"analyzeSentiment","summary":"AI sentiment analysis for crypto and finance","description":"Analyze text sentiment with crypto/finance awareness. Returns sentiment score, confidence, reasoning, and entity-level sentiment. Price: $0.003 USDC via x402.","tags":["AI Utilities"],"x-x402-price":"$0.003","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.003","protocols":["x402"]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":10000},"context":{"default":"crypto","type":"string","enum":["crypto","finance","general","social_media"]}},"required":["text","context"],"additionalProperties":false}}}},"responses":{"200":{"description":"Sentiment analysis result","content":{"application/json":{"schema":{"type":"object","properties":{"sentiment":{"type":"number","minimum":-1,"maximum":1},"confidence":{"type":"number","minimum":0,"maximum":1},"label":{"type":"string","enum":["very_bearish","bearish","neutral","bullish","very_bullish"]},"reasoning":{"type":"string"},"entities":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"sentiment":{"type":"number","minimum":-1,"maximum":1}},"required":["name","sentiment"],"additionalProperties":false}},"metadata":{"type":"object","properties":{"model":{"type":"string"},"processingTimeMs":{"type":"number"}},"required":["model","processingTimeMs"],"additionalProperties":false}},"required":["sentiment","confidence","label","reasoning","entities","metadata"],"additionalProperties":false}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required"}}}},"/v1/summarize":{"post":{"operationId":"summarizeText","summary":"AI text summarization with configurable format","description":"Summarize text with configurable length and format. Supports prose, bullet points, and structured output. Price: $0.008 USDC via x402.","tags":["AI Utilities"],"x-x402-price":"$0.008","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.008","protocols":["x402"]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":50000},"maxLength":{"default":"standard","type":"string","enum":["brief","standard","detailed"]},"format":{"default":"structured","type":"string","enum":["prose","bullet_points","structured"]},"focus":{"type":"string","maxLength":200}},"required":["text","maxLength","format"],"additionalProperties":false}}}},"responses":{"200":{"description":"Summarization result","content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"string"},"keyPoints":{"type":"array","items":{"type":"string"}},"wordCount":{"type":"number"},"compressionRatio":{"type":"number"},"metadata":{"type":"object","properties":{"model":{"type":"string"},"processingTimeMs":{"type":"number"}},"required":["model","processingTimeMs"],"additionalProperties":false}},"required":["summary","keyPoints","wordCount","compressionRatio","metadata"],"additionalProperties":false}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required"}}}},"/v1/translate":{"post":{"operationId":"translateText","summary":"AI-powered text translation with tone control","description":"Translate text to any language with configurable tone (formal, casual, technical). Auto-detects source language. Price: $0.002 USDC via x402.","tags":["AI Utilities"],"x-x402-price":"$0.002","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.002","protocols":["x402"]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":20000},"targetLanguage":{"type":"string","minLength":2,"maxLength":50},"sourceLanguage":{"type":"string"},"tone":{"default":"formal","type":"string","enum":["formal","casual","technical"]}},"required":["text","targetLanguage","tone"],"additionalProperties":false}}}},"responses":{"200":{"description":"Translation result","content":{"application/json":{"schema":{"type":"object","properties":{"translatedText":{"type":"string"},"detectedSourceLanguage":{"type":"string"},"targetLanguage":{"type":"string"},"metadata":{"type":"object","properties":{"model":{"type":"string"},"processingTimeMs":{"type":"number"}},"required":["model","processingTimeMs"],"additionalProperties":false}},"required":["translatedText","detectedSourceLanguage","targetLanguage","metadata"],"additionalProperties":false}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required"}}}},"/v1/pool-snapshot":{"get":{"operationId":"getPoolSnapshot","summary":"DeFi liquidity pool snapshot","description":"Cached snapshot of top 500 DeFi liquidity pools by TVL. Filter by protocol, chain, or token. Returns TVL, APY, volume, IL risk, and registry enrichment. Data refreshed every 15 minutes. Price: $0.005 USDC via x402.","tags":["DeFi"],"x-x402-price":"$0.005","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.005","protocols":["x402"]},"parameters":[{"name":"pool","in":"query","schema":{"type":"string"},"description":"Pool address or DeFi Llama pool ID"},{"name":"protocol","in":"query","schema":{"type":"string"},"description":"Protocol name, e.g. \"uniswap-v3\""},{"name":"chain","in":"query","schema":{"type":"string"},"description":"Chain, e.g. \"ethereum\""},{"name":"token","in":"query","schema":{"type":"string"},"description":"Token symbol, e.g. \"ETH\""},{"name":"sortBy","in":"query","schema":{"type":"string","enum":["tvl","apy","volume"],"default":"tvl"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Pool snapshot","content":{"application/json":{"schema":{"type":"object","properties":{"timestamp":{"type":"string"},"stalenessSec":{"type":"number"},"totalPoolsIndexed":{"type":"number"},"returned":{"type":"number"},"warning":{"type":"string"},"pools":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"address":{"type":"string"},"chain":{"type":"string"},"protocol":{"type":"string"},"symbol":{"type":"string"},"tokens":{"type":"array","items":{"type":"string"}},"tvlUsd":{"type":"number"},"apy":{"type":"number"},"apyBase":{"type":"number"},"apyReward":{"type":"number"},"volume24hUsd":{"type":"number"},"ilRisk":{"type":"string","enum":["none","low","medium","high"]},"stablecoin":{"type":"boolean"},"exposure":{"type":"string","enum":["single","multi"]},"registryLabel":{"type":"string"},"registryRisk":{"type":"string"}},"required":["id","chain","protocol","symbol","tokens","tvlUsd","apy","stablecoin"],"additionalProperties":false}},"relatedServices":{"type":"array","items":{"type":"object","properties":{"endpoint":{"type":"string"},"description":{"type":"string"},"suggestedInput":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["endpoint","description","suggestedInput"],"additionalProperties":false}}},"required":["timestamp","stalenessSec","totalPoolsIndexed","returned","pools","relatedServices"],"additionalProperties":false}}}},"402":{"description":"Payment required"}}}},"/v1/token-risk-metrics":{"post":{"operationId":"getTokenRiskMetrics","summary":"Quantitative token risk metrics","description":"Compute or retrieve pre-computed risk metrics for any ERC-20 token: holder concentration (top 10 %), contract permissions (mint/burn/pause/blacklist), liquidity depth vs market cap, deployer history, and composite risk score (0-100). Price: $0.008 USDC via x402.","tags":["Security","Crypto Intelligence"],"x-x402-price":"$0.008","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.008","protocols":["x402"]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"chain":{"default":"ethereum","type":"string","enum":["ethereum","base","arbitrum","optimism","polygon"]}},"required":["address","chain"],"additionalProperties":false}}}},"responses":{"200":{"description":"Token risk metrics result","content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"chain":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"source":{"type":"string","enum":["cached","live"]},"computedAt":{"type":"string"},"stalenessSec":{"type":"number"},"holders":{"type":"object","properties":{"totalHolders":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"top10HolderPct":{"type":"number","minimum":0,"maximum":100},"top10Addresses":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"label":{"type":"string"},"pct":{"type":"number"},"isContract":{"type":"boolean"}},"required":["address","pct","isContract"],"additionalProperties":false}},"concentrationRisk":{"type":"string","enum":["low","medium","high","critical"]}},"required":["top10HolderPct","top10Addresses","concentrationRisk"],"additionalProperties":false},"liquidity":{"type":"object","properties":{"totalLiquidityUsd":{"type":"number"},"marketCapUsd":{"type":"number"},"liquidityToMcapRatio":{"type":"number"},"liquidityRisk":{"type":"string","enum":["low","medium","high","critical"]},"topPools":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"dex":{"type":"string"},"pair":{"type":"string"},"tvlUsd":{"type":"number"}},"required":["dex","pair","tvlUsd"],"additionalProperties":false}}},"required":["liquidityRisk"],"additionalProperties":false},"permissions":{"type":"object","properties":{"canMint":{"type":"boolean"},"canBurn":{"type":"boolean"},"canPause":{"type":"boolean"},"canBlacklist":{"type":"boolean"},"canUpgrade":{"type":"boolean"},"hasOwner":{"type":"boolean"},"isRenounced":{"type":"boolean"},"permissionRisk":{"type":"string","enum":["none","low","medium","high","critical"]}},"required":["canMint","canBurn","canPause","canBlacklist","canUpgrade","hasOwner","permissionRisk"],"additionalProperties":false},"deployer":{"type":"object","properties":{"address":{"type":"string"},"label":{"type":"string"},"totalContractsDeployed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"knownRugPulls":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deployerRisk":{"type":"string","enum":["unknown","low","medium","high"]}},"required":["deployerRisk"],"additionalProperties":false},"overallRisk":{"type":"object","properties":{"score":{"type":"number","minimum":0,"maximum":100},"level":{"type":"string","enum":["low","medium","high","critical"]},"flags":{"type":"array","items":{"type":"string"}}},"required":["score","level","flags"],"additionalProperties":false},"relatedServices":{"type":"array","items":{"type":"object","properties":{"endpoint":{"type":"string"},"description":{"type":"string"},"suggestedInput":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["endpoint","description","suggestedInput"],"additionalProperties":false}}},"required":["address","chain","source","computedAt","stalenessSec","holders","liquidity","permissions","deployer","overallRisk","relatedServices"],"additionalProperties":false}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment required"}}}},"/v1/ping":{"get":{"operationId":"ping","summary":"Liveness check with payment verification","description":"Minimal endpoint to verify service is operational and x402 payment flow works. Price: $0.001 USDC via x402.","tags":["System"],"x-x402-price":"$0.001","x-x402-network":"base","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"pricingMode":"fixed","price":"$0.001","protocols":["x402"]},"responses":{"200":{"description":"Service is operational","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"ok"},"timestamp":{"type":"string","format":"date-time"},"message":{"type":"string"}}}}}},"402":{"description":"Payment required"}}}},"/feedback":{"post":{"operationId":"submitFeedback","summary":"Submit feedback (free)","description":"Submit feature requests, bug reports, or general feedback. No payment required. Rate limited.","tags":["Free"],"x-agentcash-auth":{"mode":"free"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["feature_request","bug_report","service_request","general"]},"endpoint":{"type":"string"},"message":{"type":"string","minLength":1,"maxLength":2000},"contact":{"type":"string","maxLength":200}},"required":["type","message"],"additionalProperties":false}}}},"responses":{"200":{"description":"Feedback submitted","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"ok"},"message":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}}}}}},"/.well-known/agent.json":{"get":{"operationId":"getAgentCard","summary":"A2A Agent Card (Google Agent-to-Agent Protocol)","description":"Returns an agent card following the A2A protocol with skills, capabilities, authentication methods, and protocol endpoints. Free — no payment required.","tags":["Discovery"],"x-agentcash-auth":{"mode":"free"},"responses":{"200":{"description":"A2A Agent Card","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"version":{"type":"string"},"provider":{"type":"object"},"capabilities":{"type":"object"},"authentication":{"type":"object"},"protocols":{"type":"object"},"skills":{"type":"array"}}}}}}}}},"/health":{"get":{"operationId":"healthCheck","summary":"Free health check","tags":["System"],"x-agentcash-auth":{"mode":"free"},"responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"ok"},"timestamp":{"type":"string","format":"date-time"}}}}}}}}},"/catalog":{"get":{"operationId":"getCatalog","summary":"Machine-readable service catalog","description":"Returns all available services with pricing, descriptions, and full JSON schemas. Free — no payment required.","tags":["Discovery"],"x-agentcash-auth":{"mode":"free"},"responses":{"200":{"description":"Service catalog","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"description":{"type":"string"},"services":{"type":"array"},"payment":{"type":"object"}}}}}}}}}}}