AUROSProtocol
AUROS

Documentation · Endpoints

POST /api/v1/watts/* (Premium)

AUROS Watts Reserve — booking engine des watts : profil → match → confirm (mint CFU) → settle (retire) → inventaire producteur → secondaire + RWA prep.

Boucle réservation

Premium (sauf /demo* rate-limité).

POST /api/v1/watts/reserve — intent `pending_confirm` + match_score déterministe (pas de mint).

GET /api/v1/watts/reserve/{id} — lire l'intent (owner key).

POST /api/v1/watts/reserve/{id}/confirm — mint CFU-E (firm) ou CFU-F (flex) avec attributes.reservation_id.

POST /api/v1/watts/reserve/{id}/settle — retire la CFU liée (livraison).

Champ optionnel `generation_source` : solar|wind|hydro|nuclear|battery|mixed|unknown (indicatif — pas Green Verified).

UI : /green/chargeflow/reserve · Low-carbon : /power · Docs : docs/WATTS-RESERVE.md.

OpenAPI : /auros-openapi.yaml.

curl -X POST https://getauros.com/api/v1/watts/reserve \
  -H "Authorization: Bearer auros_pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "window": { "start": "2026-07-20T18:00:00Z", "end": "2026-07-20T22:00:00Z" },
    "energy_kwh": 20,
    "zone": { "country": "FR", "zone_id": "FR-IDF" },
    "carbon_intensity_max_gco2_kwh": 50,
    "firmness": "firm",
    "generation_source": "nuclear"
  }'
curl -X POST https://getauros.com/api/v1/watts/reserve/{id}/confirm \
  -H "Authorization: Bearer auros_pk_live_xxx"
curl -X POST https://getauros.com/api/v1/watts/reserve/{id}/settle \
  -H "Authorization: Bearer auros_pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"delivery_ref":"sess_42","energy_kwh_delivered":19.4}'

Inventaire producteur

POST /api/v1/watts/offers — publier une fenêtre de capacité.

GET /api/v1/watts/offers — parcourir (status=open par défaut ; ?mine=1).

POST /api/v1/watts/offers/match — classer les offres vs un profil acheteur.

POST /api/v1/watts/offers/{id}/withdraw — retirer une offre.

UI : /green/chargeflow/inventory.

curl -X POST https://getauros.com/api/v1/watts/offers \
  -H "Authorization: Bearer auros_pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "window": { "start": "2026-07-20T18:00:00Z", "end": "2026-07-20T22:00:00Z" },
    "capacity_kw": 50,
    "zone": { "country": "FR" },
    "firmness": "flex",
    "generation_source": "nuclear",
    "label": "Flex soir"
  }'

Secondaire + RWA prep

POST /api/v1/watts/secondary — listing à prix indicatif (reservation_id confirmé/settled ou snapshot).

compare_ref_id → compare_url /compare?ids=… (prep RWA, pas une offre réglementée).

POST /api/v1/watts/secondary/{id}/interest — intérêt non liant.

POST /api/v1/watts/secondary/{id}/withdraw.

UI : /green/chargeflow/secondary.

curl -X POST https://getauros.com/api/v1/watts/secondary \
  -H "Authorization: Bearer auros_pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "reservation_id": "…uuid…",
    "indicative_price_eur": 1200,
    "compare_ref_id": "product_id",
    "label": "Bundle watts"
  }'

Garde-fous

Pas d'auto-mint / auto-retire / auto-reserve / auto-transfer.

Indicatif — pas GO/REC légal, pas PPA, pas marché réglementé, pas conseil d'investissement.

Nucléaire / low-carbon : verticale /power — ne pas confondre avec Green Verified.

Pages associées

← Retour à la documentation