# tokenguard API – DeFi Yield Finder

> tokenguard API – DeFi Yield Finder is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns DeFi yield opportunities filtered by asset, chain, TVL, and stablecoin status, sourced from DefiLlama

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/yields
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-api-defi-yield-finder-3aa0afd1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bJI7jQ6fD_j6K-Rrscu_-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tokenguard-api-defi-yield-finder-3aa0afd1 -d '<json body>'
```

Example prompt: Find me the best stablecoin yield opportunities for USDC on Ethereum — only pools with at least $1M TVL, stablecoins only — and sort them by APY.

## When to prefer this

Use this endpoint when you need real-time DeFi yield data filtered by specific assets, chains, and TVL thresholds. Prefer this over generic crypto price APIs when the user wants to find the best place to deploy stablecoins for yield. Ideal when comparing across multiple DeFi protocols (Aave, Curve, Balancer, etc.) simultaneously.

## Known failure modes

- No pools match the filters (returns empty yields array with count 0)
- Invalid chain name results in no results or 400 error
- min_tvl filter too high returns empty result set
- Service temporarily unavailable on Hugging Face Space (503)
- Payment failure via x402 micropayment protocol blocks request

## How this service works

Best DeFi yields (stablecoin/any), filterable by chain/asset/min-TVL. APY, base/reward split, IL risk.

## Output

A JSON object containing a count of matching pools and an array of yield opportunities, each with APY (total, base, and reward components), chain, pool symbol, project name, TVL in USD, IL risk rating, and pool ID. Data sourced from DefiLlama.

## Example request

```json
{
 "input": {
  "body": {
   "asset": "USDC",
   "chain": "ethereum",
   "min_tvl": 1000000,
   "stablecoin_only": true
  },
  "type": "http",
  "method": "POST",
  "bodyType": "json"
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "asset": {
   "type": "string",
   "description": "Asset symbol filter (optional)"
  },
  "chain": {
   "type": "string",
   "description": "Chain filter (optional)"
  },
  "min_tvl": {
   "type": "number",
   "description": "Min pool TVL USD (default 1e6)"
  },
  "stablecoin_only": {
   "type": "boolean",
   "description": "Only stablecoin pools (default true)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 15,
  "yields": [
   {
    "apy": 7.2,
    "chain": "Base",
    "symbol": "USDC",
    "project": "aave-v3",
    "tvl_usd": 50000000
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-api-defi-yield-finder-3aa0afd1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)