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`). Chaque produit expose `entity_key`, `entity_id` (`ent:{issuer}:{product}`), `issuer_key`, `parent_issuer`.

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

**GET /api/compare/eligibility?ids=…** — composite indicatif (MiCA-oriented × juridiction × green). Quand un profil Green carbone existe : `green.cqs_data_available=true` + scores CQS / hints CSRD (indicatif, fail soft sinon).

**GET /api/compare/report/pdf?compare=id1,id2** — PDF shortlist attesté HMAC (`auros.compare.report.pdf.v1`) ; disclaimer indicatif ; 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).

Alertes shortlist : inscription `POST /api/compare-alerts-waitlist` ; moves live event `compare.alerts.apy_move` schema `auros.compare.alerts.move.v1` (best-effort webhook HTTPS et/ou email).

**Embed white-label** — iframe `/embed/compare?ids=…&theme=dark|light&partner=Label` (CSP `frame-ancestors *`) ou script `auros-compare.js`. APY indicatif, jamais inventé ; `partner` = libellé d’affichage seulement (pas de claim partenariat).

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 "https://getauros.com/api/compare/eligibility?ids=toucan-bct-nct,maple-mcusdc"
curl "https://getauros.com/api/compare/report/pdf?compare=maple-mcusdc,backed-bib01&locale=en" -o report.pdf
curl -X POST https://getauros.com/api/compare/eligibility -H "Content-Type: application/json" \
  -d '{"product_ids":["maple-mcusdc","spiko-eutbl"]}'

Embed iframe / script

Intégrez une shortlist (max 4 IDs) ou un échantillon screener live. Thème `dark` (défaut) / `light`. Paramètre optionnel `partner` pour un libellé desk — pas une preuve de partenariat commercial.

<iframe src="https://getauros.com/embed/compare?ids=maple-mcusdc,backed-bib01&theme=dark" width="360" height="320" loading="lazy" style="border:0;border-radius:12px"></iframe>

<script src="https://getauros.com/auros-compare.js" data-ids="maple-mcusdc,backed-bib01" data-theme="dark" async></script>

Payload alertes APY/TVL (webhook)

Quand un watcher a un mouvement significatif (APY ≥ 0,25 pp ou TVL ≥ 5 % et ≥ 100k USD), POST HTTPS best-effort :

{
  "event": "compare.alerts.apy_move",
  "schema": "auros.compare.alerts.move.v1",
  "delivery": "best_effort",
  "as_of": "2026-07-24T00:00:00.000Z",
  "watcher_product_ids": ["maple-mcusdc"],
  "moves": [{
    "product_id": "maple-mcusdc",
    "entity_id": "ent:maple:mcusdc",
    "field": "apy",
    "previous": 8.1,
    "current": 8.5,
    "delta": 0.4,
    "source_type": "live",
    "note": "indicative_never_invented"
  }],
  "idempotency_key": "…",
  "policy": { "never_invent_apy": true, "indicative_only": true }
}

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"],
});