--- name: meryol-agenticmarket-x402.hf.space description: This host provides three on-chain analysis utilities: wallet age and activity profiling, DeFi yield pool discovery, and address context explanation. It is oriented toward due-diligence and research tasks rather than execution or real-time trading data. host: meryol-agenticmarket-x402.hf.space --- # meryol-agenticmarket-x402.hf.space meryol-agenticmarket-x402.hf.space is a lightweight on-chain research host serving agents that need to vet wallets, understand unknown addresses, or identify yield opportunities in DeFi. It covers three distinct but complementary lookup tasks: wallet history, address classification, and yield pool ranking. It does not execute transactions, provide live price feeds, or return full contract source code. ## When to use this host Use this host when an agent needs to vet a wallet's age and activity, classify and explain an unknown on-chain address, or discover ranked DeFi yield pools by chain and asset. It is appropriate for pre-interaction due diligence and research workflows. Do not use this host for real-time token prices or swap quotes — use a DEX price or aggregator API instead. Do not use it for retrieving full transaction histories, contract ABIs, or source code — use a dedicated blockchain explorer or indexer API. It is also not suitable for executing any on-chain transactions. ## Capabilities ### Address Intelligence Provides contextual and historical information about on-chain addresses, covering both wallet age/activity profiling and contract or EOA classification with warnings. - **`fetch-wallet-age`** — Returns the age and on-chain activity summary of a wallet address on a specified blockchain, including first-seen timestamp, transaction count, and a freshness score. - **`explain-chain-address`** — Returns on-chain context for a given address on a specified chain, including verification status, contract type, a plain-language summary, and any warnings. ### Yield Discovery Identifies and ranks DeFi yield pools by chain, asset, TVL, and stability criteria, enabling agents to surface deposit opportunities before acting. - **`fetch-best-yield-opportunities`** — Returns a ranked list of DeFi yield pools filtered by chain, asset, minimum TVL, and stablecoin preference, including APY, TVL, IL risk, and stability metrics. ## Workflows ### Wallet Vetting Before Yield Interaction *Use when an agent needs to evaluate whether a wallet address is sufficiently established before recommending or executing a yield deposit strategy on its behalf.* 1. **`fetch-wallet-age`** — Retrieve the wallet's first-seen timestamp, transaction count, age in days, and freshness score to assess whether it is a new or established account. 2. **`fetch-best-yield-opportunities`** — Fetch ranked yield pools matching the wallet's target chain and asset, to be presented only if the wallet passes the age/activity threshold. ### Unknown Address Due Diligence *Use when an agent needs to fully characterize an unfamiliar on-chain address before interacting with it, combining classification with historical activity data.* 1. **`explain-chain-address`** — Determine whether the address is a verified contract, unverified contract, or EOA, and surface any associated warnings or a plain-language summary. 2. **`fetch-wallet-age`** — If the address is an EOA, retrieve its age and transaction history to assess how active or dormant it has been on-chain. ## Skill reference ### `fetch-wallet-age` **Wallet Age Check** — Returns the age and on-chain activity summary of a wallet address on a specified blockchain, including first-seen timestamp, transaction count, and a freshness score. *Use when:* Use when an agent needs to determine how old a wallet is, when it was first active, how many transactions it has made, or whether it has ever been active on supported chains. *Not for:* Do not use for real-time balance lookups or token holdings; use a balance API instead. Not suitable for retrieving transaction history details. **Inputs:** - `chain` (string, required) — Blockchain identifier for the chain to query (path parameter). - `address` (string, required) — Wallet address to look up (path parameter). **Returns:** Returns a JSON object with the wallet address, first-seen timestamp, age in days, transaction count, distinct counterparties, active chains, a freshness score, and status notes. **Example:** `GET https://meryol-agenticmarket-x402.hf.space/wallet/ethereum/0x402feee072d655b85e08f1751af9ddbcd249521f/age` --- ### `fetch-best-yield-opportunities` **Best Yield Finder** — Returns a ranked list of DeFi yield pools filtered by chain, asset, minimum TVL, and stablecoin preference, including APY, TVL, IL risk, and stability metrics. *Use when:* Use when an agent needs to identify the highest-yielding DeFi pools across chains for a given asset or filter set, before recommending or executing a yield deposit strategy. *Not for:* Do not use for real-time price feeds or swap quotes; use a DEX quote API instead. Not suitable for fetching historical yield data over custom date ranges. **Inputs:** - `chain` (string) — Filter results to a specific blockchain (e.g. 'Ethereum', 'BSC'). Returns all chains if omitted. - `asset` (string) — Filter results to a specific asset symbol or identifier. Returns all assets if omitted. - `min_tvl` (number) — Minimum pool TVL in USD to include in results. Defaults to 100000. - `max_results` (integer) — Maximum number of pools to return. Defaults to 5. - `stable_only` (boolean) — If true, restricts results to stablecoin pools only. Defaults to false. **Returns:** Returns requested_chain, requested_asset, min_tvl, queried_at, and a pools array with up to max_results entries each containing project, chain, symbol, pool_id, tvl_usd, apy, apy_mean_30d, apy_stability, il_risk, exposure, stablecoin, and a caveat string. **Example:** `GET https://meryol-agenticmarket-x402.hf.space/yields/best?chain=Ethereum&asset=USDC&min_tvl=500000&max_results=5&stable_only=true` --- ### `explain-chain-address` **Chain Address Explainer** — Returns on-chain context for a given address on a specified chain, including verification status, contract type, a plain-language summary, and any warnings. *Use when:* Use when an agent needs a quick explanation of an on-chain address — such as whether it is a verified contract, an EOA, or an unverified contract — along with any associated warnings and a human-readable summary. *Not for:* Do not use for fetching token prices, swap quotes, or live transaction data; use a dedicated price or transaction API instead. Not suitable for retrieving full contract ABI or source code. **Inputs:** - `chain` (string, required) — Blockchain identifier for the address to look up (e.g. 'base', 'ethereum'). - `address` (string, required) — On-chain address to explain (checksummed or lowercase hex). **Returns:** Returns a JSON object with chain, address, verified status, contract type, a summary array of plain-language insights, a warnings array, and a top_functions_24h array. **Example:** `GET https://meryol-agenticmarket-x402.hf.space/explain/base/0x402feee072d655b85e08f1751af9ddbcd249521f` ---