YieldAgent by Yield.xyz

The yield layer for the agent era.

2,988 yield opportunities. 75+ chains. One unified interface. Staking, lending, vaults, restaking, and liquidity pools — all via the Yield.xyz API. Secure, controlled access to on-chain yield for agents.

Non-custodial. Schema-driven. Agent-native.

---

Core Capabilities

Capability	Description
Discover	Query yields across every protocol and chain
Enter	Build unsigned transactions to deposit — your wallet signs
Track	View balances, accrued interest, pending actions
Manage	Claim rewards, restake, redelegate
Exit	Withdraw in one command

---

Quick Start

Install

npx clawhub@latest install yield-agent

Or manually:

git clone https://github.com/stakekit/yield-agent.git ~/.openclaw/skills/yield-agent
chmod +x ~/.openclaw/skills/yield-agent/scripts/*.sh

Use

# Find yields
./scripts/find-yields.sh base USDC

# Inspect a yield's schema
./scripts/get-yield-info.sh base-usdc-aave-v3-lending

# Enter a position
./scripts/enter-position.sh base-usdc-aave-v3-lending 0xYOUR_ADDRESS '{"amount":"100"}'

# Check balances
./scripts/check-portfolio.sh base-usdc-aave-v3-lending 0xYOUR_ADDRESS

A free shared API key is included in skill.json. For production, get your own from dashboard.yield.xyz or set YIELDS_API_KEY env var.

---

Scripts

Script	Endpoint	Description
find-yields.sh	GET /v1/yields	Discover yields by network and token
get-yield-info.sh	GET /v1/yields/{id}	Inspect yield schema, limits, tokens
list-validators.sh	GET /v1/yields/{id}/validators	List validators for staking
enter-position.sh	POST /v1/actions/enter	Enter a yield position
exit-position.sh	POST /v1/actions/exit	Exit a yield position
manage-position.sh	POST /v1/actions/manage	Claim, restake, redelegate
check-portfolio.sh	POST /v1/yields/{id}/balances	Check balances and pending actions

---

Project Structure

yield-agent/
├── SKILL.md                          # Main skill definition (agent reads this)
├── skill.json                        # Manifest, API config, triggers
├── scripts/                          # 7 bash scripts wrapping the API
├── references/
│   ├── openapi.yaml                  # OpenAPI spec (source of truth for types)
│   ├── safety.md                     # Safety checks and guardrails
│   ├── superskill.md                 # 40 advanced agent capabilities
│   ├── chain-formats.md              # Unsigned tx formats per chain
│   ├── wallet-integration.md         # Wallet setup and signing flow
│   └── examples.md                   # Agent conversation patterns

---

Key Rules

1. Always fetch the yield schema before calling an action — the API is self-documenting
2. Amounts are human-readable — "100" = 100 USDC, "1" = 1 ETH
3. Always submit the tx hash after broadcasting — PUT /v1/transactions/{txId}/submit-hash
4. Never modify unsignedTransaction — sign exactly what the API returns
5. Execute transactions in stepIndex order — wait for CONFIRMED between each

---

Requirements

• curl and jq
• A wallet for signing (Crossmint, Portal, Turnkey, Privy, or any compatible wallet)

---

Security

Yield.xyz is SOC 2 compliant (trust.yield.xyz). A safe, controlled environment for AI agents to access on-chain yields.

---

Links

• agent.yield.xyz
• ClawHub
• GitHub
• API Docs
• API Recipes
• Get API Key
• Yield.xyz

---

Important Notice & Risk Disclosure

YieldAgent is a software tool designed to help users discover yield opportunities and construct transactions using the Yield.xyz infrastructure. It is not a financial advisor, broker, dealer, or fiduciary. Yield.xyz does not provide financial, investment, tax, accounting, or legal advice. Nothing in this repository, within the YieldAgent interface, or in any related materials constitutes a recommendation, solicitation, endorsement, or offer to buy, sell, hold, or otherwise transact in any digital asset or to pursue any particular investment strategy.

All actions taken through YieldAgent are initiated and executed at your sole discretion. You are fully responsible for evaluating and understanding the risks involved, including but not limited to smart contract vulnerabilities, protocol failures, counterparty exposure, market volatility, liquidity constraints, loss of private keys, technical errors, and changing regulatory requirements. Digital assets and decentralized finance involve substantial risk, including the potential for total loss of funds. Only use funds you can afford to lose. You should conduct your own research and consult qualified professional advisors before making financial decisions.

By using YieldAgent, you acknowledge and accept these risks.

License

Apache 2.0