AUROS Protocol

Documentation · Endpoints

POST /api/v1/compare

Comparaison side-by-side de 2–4 produits RWA — par IDs explicites ou filtres (category, yield, risk tier, jurisdiction).

Modes de requête

**Par IDs** — `product_ids` (2–4 IDs du catalogue, ordre conservé).

**Par filtres** — omettez `product_ids` et passez `category`, `yield_min`, `risk_tier`, `jurisdiction`, `limit` (2–4, défaut 4). Les produits sont triés par APY décroissant.

cURL (par IDs)

curl -X POST https://getauros.com/api/v1/compare \
  -H "Authorization: Bearer auros_pk_test_demo" \
  -H "Content-Type: application/json" \
  -d '{"product_ids":["maple-usdc","realt-portfolio","backed-bib01"]}'

cURL (par filtres)

curl -X POST https://getauros.com/api/v1/compare \
  -H "Authorization: Bearer auros_pk_test_demo" \
  -H "Content-Type: application/json" \
  -d '{"category":"bonds","yield_min":4,"risk_tier":"core","limit":3}'

Réponse (extrait)

Les champs `comparison.highlights` reprennent la logique du panneau /compare (`best` / `worst` par métrique).

{
  "mode": "product_ids",
  "products": [{
    "id": "maple-usdc",
    "name": "Maple USDC Pool",
    "platform": "Maple",
    "category": "private_credit",
    "asset_class": "private_credit",
    "sub_category": "prime",
    "risk_tier": "core",
    "apy": 8.2,
    "tvl_usd": 45000000,
    "jurisdiction": "Cayman Islands",
    "liquidity_days": 7,
    "fees": "1%",
    "accredited_only": false,
    "live": true
  }],
  "comparison": {
    "product_count": 3,
    "share_url": "https://getauros.com/compare?compare=maple-usdc,realt-portfolio,backed-bib01",
    "highlights": { "apy": ["best", null, "worst"], "tvl_usd": [null, null, null] }
  },
  "fetched_at": "2026-06-11T10:00:00.000Z",
  "meta": { "version": "1.0", "computed_at": "..." }
}

SDK

const result = await client.compare({
  product_ids: ["maple-usdc", "realt-portfolio"],
});

Pages associées

← Retour à la documentation