POST /api/v1/compare (+ public GET /api/compare)

Public (gratuit, quota IP)

**GET /api/compare** — screener (filtres `risk_tier`, `source`, `jurisdiction`, `yield_min`, `max_ticket_usd`, `green_only`, `limit`).

**GET /api/compare?mode=shortlist&ids=…** ou **POST /api/compare** `{ product_ids }` — snapshot shortlist avec `as_of`, `source_type`, `entity_key`, citations, `drift` (slug_missing / stale_cache).

**GET /api/compare/eligibility?ids=…** — composite indicatif (MiCA-oriented × juridiction × green/CSRD hints). Pas un avis juridique ; APY jamais inventé.

**POST /api/compare/verify** — vérifie `content_hash` + `signature` (HMAC `auros-compare:v1:`).

Signature HMAC si `ATTEST_SIGNING_KEY` est défini ; sinon hash seul. Premium : POST /api/v1/compare (Bearer + quota mensuel).

curl "https://getauros.com/api/compare?risk_tier=core&source=live&limit=10"
curl "https://getauros.com/api/compare?mode=shortlist&ids=maple-mcusdc,backed-bib01"
curl -X POST https://getauros.com/api/compare/eligibility -H "Content-Type: application/json" \
  -d '{"product_ids":["maple-mcusdc","spiko-eutbl"]}'

Modes de requête (Premium)

**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": "..." }
}

• Comparateur RWA AUROS

SDK

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