{"id":45035884,"url":"https://github.com/stakekit/yield-agent","last_synced_at":"2026-02-19T06:33:07.354Z","repository":{"id":337713663,"uuid":"1153034943","full_name":"stakekit/yield-agent","owner":"stakekit","description":"AI agent skill for on-chain yield discovery, transaction construction, and portfolio management via the Yield.xyz API.","archived":false,"fork":false,"pushed_at":"2026-02-10T22:40:38.000Z","size":84,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-11T01:26:31.263Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://agent.yield.xyz/","language":"Shell","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stakekit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-08T19:57:28.000Z","updated_at":"2026-02-10T22:40:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/stakekit/yield-agent","commit_stats":null,"previous_names":["stakekit/yield-agent"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/stakekit/yield-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stakekit%2Fyield-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stakekit%2Fyield-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stakekit%2Fyield-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stakekit%2Fyield-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stakekit","download_url":"https://codeload.github.com/stakekit/yield-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stakekit%2Fyield-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29604808,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T05:11:50.834Z","status":"ssl_error","status_checked_at":"2026-02-19T05:11:38.921Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-19T06:33:07.297Z","updated_at":"2026-02-19T06:33:07.344Z","avatar_url":"https://github.com/stakekit.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# YieldAgent by Yield.xyz\n\n[![ClawHub](https://img.shields.io/badge/ClawHub-yield--agent-red)](https://clawhub.ai/apurvmishra/yield-agent)\n\n**The yield layer for the agent era.**\n\n2,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.\n\nNon-custodial. Schema-driven. Agent-native.\n\n---\n\n### Core Capabilities\n\n| Capability | Description |\n|-----------|-------------|\n| **Discover** | Query yields across every protocol and chain |\n| **Enter** | Build unsigned transactions to deposit — your wallet signs |\n| **Track** | View balances, accrued interest, pending actions |\n| **Manage** | Claim rewards, restake, redelegate |\n| **Exit** | Withdraw in one command |\n\n---\n\n## Quick Start\n\n### Install\n\n```bash\nnpx clawhub@latest install yield-agent\n```\n\nOr manually:\n```bash\ngit clone https://github.com/stakekit/yield-agent.git ~/.openclaw/skills/yield-agent\nchmod +x ~/.openclaw/skills/yield-agent/scripts/*.sh\n```\n\n### Use\n\n```bash\n# Find yields\n./scripts/find-yields.sh base USDC\n\n# Inspect a yield's schema\n./scripts/get-yield-info.sh base-usdc-aave-v3-lending\n\n# Enter a position\n./scripts/enter-position.sh base-usdc-aave-v3-lending 0xYOUR_ADDRESS '{\"amount\":\"100\"}'\n\n# Check balances\n./scripts/check-portfolio.sh base-usdc-aave-v3-lending 0xYOUR_ADDRESS\n```\n\nA free shared API key is included in `skill.json`. For production, get your own from [dashboard.yield.xyz](https://dashboard.yield.xyz) or set `YIELDS_API_KEY` env var.\n\n---\n\n## Scripts\n\n| Script | Endpoint | Description |\n|--------|----------|-------------|\n| `find-yields.sh` | `GET /v1/yields` | Discover yields by network and token |\n| `get-yield-info.sh` | `GET /v1/yields/{id}` | Inspect yield schema, limits, tokens |\n| `list-validators.sh` | `GET /v1/yields/{id}/validators` | List validators for staking |\n| `enter-position.sh` | `POST /v1/actions/enter` | Enter a yield position |\n| `exit-position.sh` | `POST /v1/actions/exit` | Exit a yield position |\n| `manage-position.sh` | `POST /v1/actions/manage` | Claim, restake, redelegate |\n| `check-portfolio.sh` | `POST /v1/yields/{id}/balances` | Check balances and pending actions |\n\n---\n\n## Project Structure\n\n```\nyield-agent/\n├── SKILL.md                          # Main skill definition (agent reads this)\n├── skill.json                        # Manifest, API config, triggers\n├── scripts/                          # 7 bash scripts wrapping the API\n├── references/\n│   ├── openapi.yaml                  # OpenAPI spec (source of truth for types)\n│   ├── safety.md                     # Safety checks and guardrails\n│   ├── superskill.md                 # 40 advanced agent capabilities\n│   ├── chain-formats.md              # Unsigned tx formats per chain\n│   ├── wallet-integration.md         # Wallet setup and signing flow\n│   └── examples.md                   # Agent conversation patterns\n```\n\n---\n\n## Key Rules\n\n1. **Always fetch the yield schema before calling an action** — the API is self-documenting\n2. **Amounts are human-readable** — `\"100\"` = 100 USDC, `\"1\"` = 1 ETH\n3. **Always submit the tx hash after broadcasting** — `PUT /v1/transactions/{txId}/submit-hash`\n4. **Never modify `unsignedTransaction`** — sign exactly what the API returns\n5. **Execute transactions in `stepIndex` order** — wait for CONFIRMED between each\n\n---\n\n## Requirements\n\n- `curl` and `jq`\n- A wallet for signing (Crossmint, Portal, Turnkey, Privy, or any compatible wallet)\n\n---\n\n## Security\n\nYield.xyz is **SOC 2 compliant** ([trust.yield.xyz](https://trust.yield.xyz/)). A safe, controlled environment for AI agents to access on-chain yields.\n\n---\n\n## Links\n\n- [agent.yield.xyz](https://agent.yield.xyz)\n- [ClawHub](https://clawhub.ai/apurvmishra/yield-agent)\n- [GitHub](https://github.com/stakekit/yield-agent)\n- [API Docs](https://docs.yield.xyz)\n- [API Recipes](https://github.com/stakekit/api-recipes)\n- [Get API Key](https://dashboard.yield.xyz)\n- [Yield.xyz](https://yield.xyz)\n\n---\n\n## Important Notice \u0026 Risk Disclosure\n\nYieldAgent 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.\n\nAll 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.\n\nBy using YieldAgent, you acknowledge and accept these risks.\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstakekit%2Fyield-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstakekit%2Fyield-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstakekit%2Fyield-agent/lists"}