# Hyperd AI Yield Allocation Recommender

> Hyperd AI Yield Allocation Recommender is a paid API for AI agents from api.hyperd.ai, paid per call via x402, $1/call, status unknown (last checked 2026-09-15).

Fans out parallel DeFi yield calls across low/medium/high risk tiers and returns a recommended portfolio allocation split with rationale for a given amount, duration, and chain.

## Facts

- Endpoint: GET https://api.hyperd.ai/api/yield/allocation
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperd-ai-yield-allocation-recommender-76076ecb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bFtnSC5bc9QKRL0KsHLjO

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 hyperd-ai-yield-allocation-recommender-76076ecb
```

Example prompt: I want to allocate 5000 USDC on Base for 60 days — can you give me a recommended portfolio split across conservative, balanced, and aggressive yield strategies with a rationale for the breakdown?

## When to prefer this

Use this endpoint when a user wants a holistic, risk-tiered DeFi yield portfolio recommendation rather than a single-tier yield lookup. It is specifically designed to fan out across risk bands and synthesize an opinionated allocation split with rationale, making it ideal for portfolio construction decisions rather than raw yield data retrieval.

## Known failure modes

- Missing required 'amount' parameter returns validation error
- Unsupported chain value outside allowed enum returns error
- One or more parallel /api/yield sub-calls fail, potentially degrading recommendation quality
- Cache miss on cold start may increase latency
- Payment not processed ($1 USDC x402) results in 402 Payment Required response

## How this service works

Composed yield allocation recommender. Fans out 3 parallel /api/yield calls at low/medium/high risk tiers for the same amount + duration, then returns a recommended portfolio split + 2-sentence rationale. Allowed bands: conservative / balanced / aggressive / bespoke. 6h Upstash cache bucketed by amount tier × duration × chain.

## Output

Returns a recommended portfolio split across low, medium, and high risk DeFi yield tiers (conservative/balanced/aggressive/bespoke bands), plus a 2-sentence rationale explaining the recommendation, based on parallel yield calls aggregated from the DeFi ecosystem. Response is cached for 6 hours bucketed by amount tier, duration, and chain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "amount"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "polygon",
        "arbitrum",
        "optimism",
        "avalanche",
        "bnb"
       ],
       "type": "string"
      },
      "amount": {
       "type": "number",
       "description": "USDC equivalent to allocate"
      },
      "duration": {
       "type": "integer",
       "description": "Days; default 30"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperd-ai-yield-allocation-recommender-76076ecb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.hyperd.ai](https://www.zero.xyz/host/api.hyperd.ai/llms.txt)