YieldCircle Intelligence & DeFi Execution Skill (v3.0.0)

Capabilities & Context

YieldCircle is an institutional-grade intelligence, DeFi execution, and infrastructure layer for AI Agents. It provides quantitative alpha from 10 years of financial history, autonomous DeFi execution across 15+ chains via Enso Finance, cross-chain bridging via Across Protocol, and secure Privy TEE-signed wallets — all through a single API.

1. DeFi Super-Aggregator (Enso Finance)

Execute swaps, cross-chain transfers, yield entries, and multi-step bundles across 200+ DEXs and 180+ protocols.

• Token Swap: POST /api/defi/swap — Aggregated swap on any supported chain
• Cross-Chain: POST /api/defi/cross-chain — Swap + bridge atomically (Stargate, LayerZero)
• Yield: POST /api/defi/yield — Enter/exit yield positions (Aave, Compound, etc.)
• Bundle: POST /api/defi/bundle — Multi-step DeFi workflows in one tx
• Balances: GET /api/defi/balances — Portfolio across all protocols
• Supported: GET /api/defi/supported — Chains, tokens, capabilities

# Cross-chain swap: USDC on Base → POL on Polygon (LIVE ✓)
curl -X POST https://api.yieldcircle.app/api/defi/swap \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": 2,
    "chain_id": 8453,
    "token_in": "USDC",
    "token_out": "ETH",
    "amount": "1000000",
    "slippage": 50,
    "receiver": "0xYourAddress",
    "dry_run": true
  }'

2. Cross-Chain Bridge (Across Protocol)

Solverless bridging with sub-minute settlement on 7+ chains.

• Quote: GET /api/bridge/quote?from=Base&to=Arbitrum&amount=1
• Execute: POST /api/bridge/execute — Sign and bridge via Privy wallet
• Status: GET /api/bridge/status/:txHash — Track deposit fulfillment
• Limits: GET /api/bridge/limits — Route liquidity per pair

3. Alpha Correlation Engine (PREMIUM)

Quantify the historical impact of news on any asset.

• Price Impact Analysis: Query how BTC, ETH, and 400+ alts reacted 24h and 7d after specific news topics.
• Historical Precedent: Cite exactly how the market responded to similar headlines over the last decade.

curl -H "X-API-Key: $NEWSRIVER_API_KEY" \
  "https://api.yieldcircle.app/api/v1/analysis/correlation?topic=ETF&symbol=BTC-USD"

4. "On This Day" Historical Memories

• Price + Headline Matching: Access curated daily memories across 10 years.
• Milestone Detection: All-Time Highs, crashes, and major policy shifts.

5. AskRiver AI Chat (PREMIUM)

Natural-language intelligence queries powered by Gemini. Searches 288K+ articles from 277 sources across 137 countries.

curl -X POST "https://api.yieldcircle.app/api/v1/askriver" \
  -H "X-API-Key: $NEWSRIVER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "What is the latest crypto market sentiment?"}'

6. Execution Proxies

• Send Email ($0.05): POST /api/v1/proxy/email
• Send SMS ($0.25): POST /api/v1/proxy/sms
• Web Scraper ($0.10): POST /api/v1/proxy/scrape

7. Agent Wallets (Privy TEE)

Agents have dedicated wallets signed inside Trusted Execution Environments. Private keys never leave the enclave.

• Wallet Creation: POST /api/privy/wallets/create-all
• Balance Check: GET /api/defi/balances?agent_id=2&chain_id=8453

Authentication

• x402 Micropayments (Autonomous): USDC on Base. Include X-PAYMENT header.
• API Key: Include X-API-Key header for subscription access.
• All actions logged to D1 database for auditability.

Error Handling & Support

If the API returns 402 Payment Required, manage access at agent.yieldcircle.app/#pricing. For support, contact support@agent.yieldcircle.app.