---
name: x402-trading.useotto.xyz
description: x402-trading.useotto.xyz provides read-only market data for two distinct DeFi contexts: yield market discovery across DeFi protocols and chains, and live Hyperliquid perpetual/stock market data. Both skills are informational only — no trade execution or vault interaction is supported.
host: x402-trading.useotto.xyz
---

# x402-trading.useotto.xyz

This host serves agents that need to survey DeFi opportunities before acting. It covers two separate data domains: yield markets (protocol APYs, liquidity, vault addresses across chains) and Hyperliquid perpetuals (current prices, leverage caps, available stock perps). It is a pre-trade and pre-deposit research layer, not an execution layer.

## When to use this host

Use this host when an agent needs to survey DeFi yield markets or check live Hyperliquid perpetual market conditions before making a decision. Do not use it for executing trades, submitting orders, depositing into vaults, or withdrawing funds — this host is strictly read-only. Do not use it for order book depth, historical OHLCV data, or real-time swap quotes; a dedicated DEX aggregator or exchange API would be more appropriate for those needs. For Hyperliquid specifically, this host only covers Base chain wallet contexts and does not support other chains.

## Capabilities

### Yield Market Discovery

Retrieves available yield-bearing opportunities across DeFi protocols and chains, including supply APY, liquidity depth, and vault addresses, enabling agents to compare and select markets before depositing.

- **`fetch-yield-markets`** — Returns a list of yield market opportunities across supported chains, including protocol, token, supply APY, total liquidity, and vault address for each market.

### Hyperliquid Market Feed

Fetches live Hyperliquid perpetual and stock market data including token prices and maximum leverage caps for a given wallet address on Base, supporting pre-trade evaluation.

- **`fetch-hyperliquid-market-data`** — Returns current Hyperliquid market data including top native perpetual tokens with prices and max leverage, plus available stock perpetuals, for a given wallet address on Base.

## Workflows

### Cross-Market Yield vs Leverage Opportunity Scan

*Use when an agent needs to compare passive yield opportunities against leveraged perpetual trading opportunities to inform a capital allocation decision.*

1. **`fetch-yield-markets`** — Retrieve current yield market APYs and liquidity across protocols to establish the passive return baseline.
2. **`fetch-hyperliquid-market-data`** — Retrieve live Hyperliquid perpetual prices and leverage caps to assess active trading opportunity upside relative to the yield baseline.

## Skill reference

### `fetch-yield-markets`

**Yield Markets** — Returns a list of yield market opportunities across supported chains, including protocol, token, supply APY, total liquidity, and vault address for each market.

*Use when:* Use when an agent needs to discover or compare yield-bearing opportunities across DeFi protocols and chains, such as finding the highest supply APY for a given token or listing all available markets on a specific chain.

*Not for:* Do not use for executing deposits or withdrawals into yield vaults; this endpoint is read-only and returns market data only. Not suitable for real-time price feeds or swap quotes.

**Returns:** Returns status='success' and a markets array with 100+ entries, each containing protocol, tokenSymbol, tokenAddress, supplyApy, totalLiquidityUsd, chainId, chainName, and vaultAddress across chains including Ethereum, Avalanche, Base, Arbitrum, and Polygon.

**Example:** `GET https://x402-trading.useotto.xyz/yield-markets`

---

### `fetch-hyperliquid-market-data`

**Hyperliquid Market Feed** — Returns current Hyperliquid market data including top native perpetual tokens with prices and max leverage, plus available stock perpetuals, for a given wallet address on Base.

*Use when:* Use when an agent needs live Hyperliquid market data such as current perpetual token prices, maximum leverage caps, and available stock perpetuals before placing or evaluating a trade.

*Not for:* Do not use for executing trades or submitting orders; this endpoint is read-only market data. Not suitable for order book depth or historical OHLCV data.

**Inputs:**

- `chain` (string, required) — Blockchain network identifier for the request context.
- `address` (string, required) — EVM wallet address used to scope or authenticate the market data request.

**Returns:** Returns status=success with market.nativePerps.topTokens (20 tokens with current prices and max leverage), totalAvailable=230 crypto perps, and stocks.available=77 stock perpetuals with sample tickers.

**Example:** `GET https://x402-trading.useotto.xyz/hyperliquid-market?chain=base&address=0x402Feee072D655B85e08f1751AF9ddbCd249521f`

---
