{"uid":"cap_NqnKxKouHcvTTy4NplDCb","slug":"mpp-hyreagent-fun-63677a78","name":"mpp.hyreagent.fun Natural Language DeFi Query","description":"Natural language DeFi query","url":"https://mpp.hyreagent.fun/base/ask","method":"POST","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Natural language DeFi question"}}},"responseSchema":{"type":"object","required":["data","signal","insight","sources","timestamp","confidence","latency_ms","model_used"],"properties":{"data":{"type":"object","required":["query","context","available_endpoints"],"properties":{"query":{"type":"string"},"context":{"type":"object","required":["top_chains_by_tvl","top_meteora_pools_by_apr"],"properties":{"top_chains_by_tvl":{"type":"array","items":{"type":"object","required":["name","tvl_usd"],"properties":{"name":{"type":"string"},"tvl_usd":{"type":"number"}}}},"top_meteora_pools_by_apr":{"type":"array","items":{"type":"object","required":["name","apr_pct","tvl_usd"],"properties":{"name":{"type":"string"},"apr_pct":{"type":"number"},"tvl_usd":{"type":"number"}}}}}},"available_endpoints":{"type":"array","items":{"type":"string"}}}},"signal":{"type":"string"},"insight":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"timestamp":{"type":"string"},"confidence":{"type":"number"},"latency_ms":{"type":"number"},"model_used":{"type":"string"}}},"example":{"request":{"query":"What are the current top 5 whale holders of Ethereum and what percentage of the total supply do they control?"},"response":{"data":{"query":"What are the current top 5 whale holders of Ethereum and what percentage of the total supply do they control?","context":{"top_chains_by_tvl":[{"name":"Ethereum","tvl_usd":37725340212},{"name":"BSC","tvl_usd":5263016532},{"name":"Solana","tvl_usd":4709581596},{"name":"Tron","tvl_usd":4371947997},{"name":"Bitcoin","tvl_usd":4195232267},{"name":"Base","tvl_usd":4024030613},{"name":"Provenance","tvl_usd":1671384680},{"name":"Hyperliquid L1","tvl_usd":1457285633},{"name":"Arbitrum","tvl_usd":1270901417},{"name":"Polygon","tvl_usd":1053183741}],"top_meteora_pools_by_apr":[{"name":"🚀-SOL","apr_pct":60569578104.7,"tvl_usd":0},{"name":"SPCX-USDC","apr_pct":979055.52,"tvl_usd":28},{"name":"CUMROCKET-SOL","apr_pct":144054.46,"tvl_usd":266},{"name":"CUMROCKET-SOL","apr_pct":68914.94,"tvl_usd":511},{"name":"trelon-SOL","apr_pct":32431.43,"tvl_usd":3848},{"name":"SPCX-SOL","apr_pct":32385.82,"tvl_usd":3215},{"name":"drooling-USDC","apr_pct":15211.5,"tvl_usd":1446},{"name":"1B-SOL","apr_pct":13840.59,"tvl_usd":587},{"name":"HAPPY-SOL","apr_pct":13050.58,"tvl_usd":527},{"name":"B4GTA6-SOL","apr_pct":11255.13,"tvl_usd":8879}]},"available_endpoints":["/trenches/new-tokens","/trenches/curve/{mint}","/trenches/token/{mint}","/trenches/token/{mint}/snipers","/trenches/graduating","/trenches/token/{mint}/verdict","/traders/wallet/{address}/pnl","/traders/wallet/{address}/positions","/traders/token/{mint}/whales","/traders/token/{mint}/ohlcv","/traders/wallet/{address}/intel","/lp/meteora/pools","/lp/meteora/pools/recommend","/lp/meteora/pools/{address}","/lp/meteora/pools/strategy","/defi/tvl","/defi/yields"]},"signal":"research","insight":"The provided data does not contain information about the top 5 whale holders of **Ethereum** or the percentage of its total supply they control. The available context focuses on overall chain TVL and specific Solana-based Meteora pools.\n\nTo answer your question, we would need to query for **Ethereum** whale holdings. This would typically involve looking at large wallet balances for the **ETH** token.","sources":["defillama","meteora-dlmm"],"timestamp":"2026-06-13T04:14:54.845Z","confidence":0.8,"latency_ms":3641,"model_used":"gemini-2.5-flash"}},"exampleRequest":{"query":"What are the current top 5 whale holders of Ethereum and what percentage of the total supply do they control?"},"tags":["x402"],"displayCostAmount":"0.250000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.250000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cqc0stykDFJlDvokjHme7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Answers natural language questions about DeFi topics using AI-powered analysis across token data, holders, snipers, and on-chain metrics","exampleAgentPrompt":"Ask the HyreAgent DeFi query endpoint: 'What are the top whale holders of this Solana token and is the bonding curve close to completion?' — answer in plain English.","exampleUseCases":null,"resultDescription":"An AI-generated natural language answer to a DeFi question, potentially covering token holder distribution, bonding curve progress, sniper risk, dev wallet activity, freeze/mint authority status, or other on-chain signals depending on the query.","failureModes":["Missing or empty 'query' field returns a 400 validation error","Ambiguous or non-DeFi questions may return irrelevant or low-quality answers","Payment failure (x402) if USDC balance is insufficient or header is malformed","Rate limiting or service unavailability returns 5xx errors","Questions about tokens not indexed may return no data or a generic fallback response"],"whenToPreferThis":"Use this endpoint when you want a flexible, conversational interface to DeFi data without knowing which specific structured endpoint to call. Ideal for open-ended questions about Solana tokens, holder analysis, bonding curves, sniper detection, or general DeFi research where the user's intent is expressed in natural language rather than structured parameters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:58:19.028Z","isFirstParty":false}