--- name: meryol-agenticmarket-x402.hf.space description: meryol-agenticmarket-x402.hf.space provides on-chain infrastructure intelligence for EVM-compatible blockchains, covering gas pricing, token price aggregation, ENS resolution, chain health monitoring, wallet profiling, DeFi yield discovery, and address classification. All endpoints return single-shot snapshots rather than streaming or historical data. The host is oriented toward pre-transaction due diligence and context gathering rather than trade execution. host: meryol-agenticmarket-x402.hf.space --- # meryol-agenticmarket-x402.hf.space This host serves agents that need to gather factual on-chain context before taking action — verifying chain liveness, estimating transaction costs, resolving identities, profiling wallets, or identifying yield opportunities. It aggregates data from multiple public sources (CoinGecko, DexScreener, GeckoTerminal, ENS, RPC nodes) and surfaces it through a uniform API. It does not execute transactions, stream live data, or provide order book depth. ## When to use this host Use this host when an agent needs pre-action on-chain context: chain liveness checks, current gas cost estimates, aggregated token prices with spread diagnostics, ENS resolution, address classification, wallet age profiling, or DeFi yield discovery. It is not suitable for: executing or broadcasting transactions, streaming or historical price/gas data, fetching full token balances or holdings, retrieving contract ABIs or source code, cross-chain bridge status, or bulk/batch operations across many addresses simultaneously. For swap quotes or order book data, use a dedicated DEX aggregator API. For historical OHLCV or gas trends, use a time-series data provider. For live balance lookups, use a chain-native balance API. ## Capabilities ### Chain Readiness Establishes whether a target blockchain is healthy and what current transaction costs look like before any on-chain action is taken. - **`fetch-chain-health`** — Returns a health snapshot for a specified blockchain network, including block lag, head age, per-RPC latency, and an aggregate health score out of 100. - **`fetch-gas-now`** — Returns the current gas price snapshot for a specified blockchain network, including base fee, priority fee percentiles, ETH/USD price, and estimated USD costs for common transaction types. ### Token Pricing Retrieves a cross-source aggregated USD price for a token on a given chain, including spread diagnostics to detect pricing discrepancies across CoinGecko, DexScreener, and GeckoTerminal. - **`fetch-cross-chain-token-price`** — Returns a token's median USD price aggregated from CoinGecko, DexScreener, and GeckoTerminal for a specified chain and token address, along with per-source prices and spread in basis points. ### Identity and Address Resolution Resolves human-readable ENS names to Ethereum addresses and classifies arbitrary on-chain addresses as EOAs, verified contracts, or unverified contracts with associated warnings. - **`resolve-ens-name-or-address`** — Resolves an ENS name or Ethereum address to its associated ENS details including address, avatar URL, and primary name verification status. - **`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. ### Wallet Profiling Characterizes a wallet's on-chain history by surfacing its first-seen timestamp, transaction count, age in days, and a freshness score across supported chains. - **`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. ### DeFi Yield Discovery Identifies and ranks DeFi yield pools by APY, TVL, IL risk, and stability across chains and assets, supporting stablecoin-only filtering and minimum TVL thresholds. - **`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 ### Pre-Transaction Chain Check *Use when an agent needs to confirm a chain is live and estimate the USD cost of a transaction before submitting it.* 1. **`fetch-chain-health`** — Verify the target chain has healthy RPC nodes and acceptable block lag before proceeding. 2. **`fetch-gas-now`** — Retrieve current base fee, priority fee percentiles, and estimated USD transaction costs on the confirmed-healthy chain. ### Unknown Address Due Diligence *Use when an agent needs to fully characterize an unfamiliar address — resolving its ENS identity if any, classifying its contract type, and assessing wallet age and activity.* 1. **`resolve-ens-name-or-address`** — Attempt to resolve the address to an ENS name and retrieve avatar and primary-name verification status. 2. **`explain-chain-address`** — Classify the address as EOA, verified contract, or unverified contract and surface any associated warnings. 3. **`fetch-wallet-age`** — Retrieve first-seen timestamp, transaction count, and freshness score to assess wallet maturity and activity level. ### Yield Opportunity Evaluation *Use when an agent needs to identify a yield pool and verify the target chain is operational before recommending a deposit.* 1. **`fetch-chain-health`** — Confirm the target chain's RPC nodes are healthy before relying on any on-chain yield data. 2. **`fetch-best-yield-opportunities`** — Retrieve ranked yield pools filtered by chain, asset, TVL floor, and stablecoin preference. 3. **`fetch-cross-chain-token-price`** — Validate the current USD price of the deposit asset to contextualize APY and TVL figures in dollar terms. ## Skill reference ### `fetch-gas-now` **GasNow Chain Quotes** — Returns the current gas price snapshot for a specified blockchain network, including base fee, priority fee percentiles, ETH/USD price, and estimated USD costs for common transaction types. *Use when:* Use when an agent needs real-time gas price data for a specific chain before estimating transaction costs, setting gas limits, or deciding whether to execute a transfer, ERC-20 transfer, or swap. *Not for:* Do not use for historical gas price data or gas price forecasting; this is a single-shot current snapshot only. **Inputs:** - `chain` (string, required) — The blockchain network identifier to query gas prices for, provided as a path parameter. **Returns:** Returns a JSON object with chain name, base_fee_gwei, p50/p90 priority fees in Gwei, ETH/USD price, and USD cost estimates for transfer, ERC-20 transfer, and swap transaction types. **Example:** `GET https://meryol-agenticmarket-x402.hf.space/gas/now/base` --- ### `fetch-cross-chain-token-price` **Cross-Chain Token Price** — Returns a token's median USD price aggregated from CoinGecko, DexScreener, and GeckoTerminal for a specified chain and token address, along with per-source prices and spread in basis points. *Use when:* Use when an agent needs a cross-source USD price for a token on a specific chain, including spread diagnostics and per-source price breakdown to detect price discrepancies or confirm consensus pricing. *Not for:* Do not use for real-time streaming price feeds or order book data; this is a single-shot aggregated price snapshot. Not suitable for chains or tokens not supported by the underlying price sources. **Inputs:** - `chain` (string, required) — The blockchain network identifier to query the token price on (e.g., 'base'). - `token` (string, required) — The token contract address on the specified chain to retrieve the price for. **Returns:** Returns the requested token address, resolved chain, median_price_usd, spread_bps, a sources array with per-source USD prices from CoinGecko, DexScreener, and GeckoTerminal, and a notes array flagging anomalies like wide spread. **Example:** `GET https://meryol-agenticmarket-x402.hf.space/price/cross/base/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` --- ### `resolve-ens-name-or-address` **ENS Lookup** — Resolves an ENS name or Ethereum address to its associated ENS details including address, avatar URL, and primary name verification status. *Use when:* Use when an agent needs to look up ENS metadata for a given ENS name (e.g. vitalik.eth) or an Ethereum address, such as to resolve a human-readable name to an address or verify ENS registration. *Not for:* Do not use for real-time ENS event monitoring or bulk batch resolution of many names; this is a single-shot lookup per name or address. **Inputs:** - `name_or_addr` (string, required) — An ENS name (e.g. vitalik.eth) or an Ethereum address to resolve. Passed as a URL path parameter. **Returns:** Returns a structured ENS record with input echo, kind classification, normalized name, address (or null), avatar_url (or null), primary_name_verified status, and a notes array indicating resolution outcome. **Example:** `GET https://meryol-agenticmarket-x402.hf.space/ens/vitalik.eth` --- ### `fetch-chain-health` **Chain Health Check** — Returns a health snapshot for a specified blockchain network, including block lag, head age, per-RPC latency, and an aggregate health score out of 100. *Use when:* Use when an agent needs to verify the liveness and RPC reliability of a blockchain network before submitting transactions or querying on-chain data, or when diagnosing degraded chain connectivity. *Not for:* Do not use for cross-chain bridge status or token price feeds; this endpoint only reports RPC node health for a single chain. **Inputs:** - `chain` (string, required) — The blockchain network identifier to check, supplied as a path parameter (e.g. 'base'). **Returns:** Returns a health object for the requested chain with median block number, max lag, head age in seconds, healthy/total RPC counts, a 0-100 score, per-RPC latency and error details, and a notes array. **Example:** `GET https://meryol-agenticmarket-x402.hf.space/chain/health/base` --- ### `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` ---