AUROS Protocol

Documentation · Endpoints

Watt Score — Green API

Score indicatif 0–100 pour actifs énergétiques — lecture publique gratuite par id, batch premium jusqu'à 50 items.

GET public (gratuit)

Une référence comparateur Green énergie (`sunexchange`, `energy-web`…) — pas d'authentification.

Usage presse, due diligence rapide, intégration widget.

curl https://getauros.com/api/green/watt/sunexchange

POST batch (clé premium)

Jusqu'à **50 actifs énergétiques** par appel — portfolio solaire, REC, PPA.

`id` = référence comparateur AUROS, ou `text` = description libre (min 10 caractères, mots-clés solar/wind/PPA/REC…).

**Tier premium** : clé `auros_pk_live_*` ou plan Monitor — les clés test gratuites reçoivent 403.

Compte au quota mensuel Protocol — licence volume : /partners.

curl -X POST https://getauros.com/api/v1/green/watt/batch \
  -H "Authorization: Bearer auros_pk_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"id":"sunexchange"},{"text":"Solar farm 12 MW PPA signed production MWh France"}]}'

Réponse batch (extrait)

Le Watt Score est un signal valeur énergétique AUROS — pas un audit de production. Voir aussi /data/green-index et /data/uhi-index.

{
  "total": 2,
  "succeeded": 2,
  "items": [
    {
      "index": 0,
      "ok": true,
      "id": "sunexchange",
      "watt_score": { "rating": 72, "tier": "mid", "lifetime_gwh": 1.8, "energy_value_eur": 270000 }
    }
  ]
}

SDK

Python : `client.green_watt_score("sunexchange")`, `client.green_watt_batch(items=[...])`.

const watt = await client.greenWattScore("sunexchange");
const batch = await client.greenWattBatch({
  items: [{ id: "sunexchange" }, { text: "Solar 12 MW PPA production MWh" }],
});

← Retour à la documentation