API Docs

Real-time DeFi yield data for AI agents. Pay once via MPP, get everything needed to find the best yield and deposit.

BASE URL — https://ambrosiafinance.xyz

Overview

AMBROSIA aggregates stablecoin yield data from Aave v3, Compound v3, Morpho, and Spark across Ethereum, Base, and Arbitrum. Data refreshes every 5 minutes from DeFiLlama.

Agent pays $0.0001 MPP  ->  Gets ranked yield data
Reads risk grade        ->  Picks best option
Gets deposit calldata   ->  Calls protocol directly
                            (we never touch your funds)

Quickstart

Install mppx
npm install mppx
Query best yield
import { Mppx } from 'mppx'
const mppx = new Mppx({ privateKey: process.env.PRIVATE_KEY })

// Get best yield right now
const data = await mppx.fetch('https://ambrosiafinance.xyz/api/yields/best')
const { best } = await data.json()

console.log(best.protocol)   // "Morpho"
console.log(best.apy_display) // "9.2%"
console.log(best.risk)        // "low"
console.log(best.network)     // "Base"

GET /api/yields

GET/api/yields
Returns all tracked stablecoin pools sorted by APY, with risk grades and deposit instructions.
Response
{
  "timestamp": "2026-03-26T12:00:00Z",
  "best_now": {
    "protocol": "morpho-blue",
    "pool": "USDC",
    "apy": 9.2,
    "apy_display": "9.2%",
    "asset": "USDC",
    "network": "Base",
    "risk": "low",
    "risk_emoji": "🟢",
    "risk_reason": "3+ years, $5B TVL, Spearbit + Trail of Bits audited",
    "tvl_usd": 5000000000,
    "tvl_display": "$5000M",
    "how_to_deposit": "Call deposit(amount, receiver) ...",
    "ref_note": "Referral included. Your APY unaffected."
  },
  "all_pools": [...],
  "count": 12,
  "ref_disclosure": "We include referral addresses...",
  "data_source": "DeFiLlama"
}

Filters

GET/api/yields?risk=low
Filter by risk level: low, medium, high. Combine with comma: ?risk=low,medium
GET/api/yields?asset=USDC
Filter by asset: USDC, USDT, DAI
GET/api/yields?network=base
Filter by network: Ethereum, Base, Arbitrum

Risk grades

🟢 LOW    — 3+ years, $1B+ TVL, top audits, never hacked
🟡 MEDIUM — 1-3 years, $100M+ TVL, audited, minor incidents
🔴 HIGH   — under 1 year, small TVL, limited audits (shown with warning)

Referral disclosure

Where supported, we include a referral address in deposit instructions. This earns AMBROSIA a small percentage of protocol revenue. Your APY is 100% unaffected — the referral fee is paid by the protocol from its own revenue, not deducted from your yield.