API REST

Documentation API

Huit endpoints REST donnent accès aux données du marché électrique français : prix spot day-ahead (ENTSO-E), endpoints unitaires RTE et deux endpoints agrégés pour la capacité et l’énergie d’équilibrage. L’authentification se fait par session dashboard ou par Bearer token généré depuis le dashboard.

Endpoints disponibles

Les endpoints ci-dessous couvrent le flux day-ahead et les deux nouvelles routes agrégées. Les endpoints unitaires restent disponibles en parallèle : GET /api/fcr-capacity, GET /api/afrr-capacity, GET /api/afrr-energy, GET /api/mfrr-capacity, GET /api/mfrr-energy.

Base URL	https://co-c8jb.nanocorp.app
Authentification	Cookie dashboard ou Authorization: Bearer <token>
Format de réponse	Objet JSON

GET/api/day-ahead-prices

Retourne les prix quart-horaires day-ahead pour la France (96 intervalles par jour) issus de l'ENTSO-E Transparency Platform. Aucun paramètre de requête.

URL	https://co-c8jb.nanocorp.app/api/day-ahead-prices
Authentification	Cookie dashboard actif ou Authorization: Bearer <token>
Query string	Aucun
Format de réponse	Objet JSON

Champs de réponse

Champ	Type	Description
rows	array	Liste des intervalles quart-horaires avec `hour_start_utc`, `hour_end_utc` et `price_eur_mwh`.
latestDate	string \| null	Dernière date de livraison disponible au format `YYYY-MM-DD`.
earliestDate	string \| null	Première date disponible dans la fenêtre renvoyée.

Exemple de requête

curl \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://co-c8jb.nanocorp.app/api/day-ahead-prices

Exemple de réponse

{
  "rows": [
    {
      "hour_start_utc": "2026-04-16T22:00:00.000Z",
      "hour_end_utc": "2026-04-16T22:15:00.000Z",
      "price_eur_mwh": 128.48
    },
    {
      "hour_start_utc": "2026-04-16T22:15:00.000Z",
      "hour_end_utc": "2026-04-16T22:30:00.000Z",
      "price_eur_mwh": 123.41
    }
  ],
  "latestDate": "2026-04-17",
  "earliestDate": "2026-03-20"
}

GET/api/balancing-capacity

Agrège les payloads de capacité FCR, aFRR et mFRR dans une seule réponse JSON. Les sous-objets `fcr`, `afrr` et `mfrr` reprennent le format des endpoints unitaires correspondants.

URL	https://co-c8jb.nanocorp.app/api/balancing-capacity
Authentification	Cookie dashboard actif ou Authorization: Bearer <token>
Query string	Aucun
Notes	401 si aucun abonnement actif

Champs de réponse

Champ	Type	Description
latestFetchedAtUtc	string \| null	Horodatage UTC le plus récent parmi les flux FCR, aFRR capacité et mFRR capacité.
fcr	object	Même payload que `GET /api/fcr-capacity`.
afrr	object	Même payload que `GET /api/afrr-capacity`.
mfrr	object	Même payload que `GET /api/mfrr-capacity`.

Exemple de requête

curl \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://co-c8jb.nanocorp.app/api/balancing-capacity

Exemple de réponse

{
  "latestFetchedAtUtc": "2026-05-23T14:35:24.755Z",
  "fcr": {
    "rows": [
      {
        "period_start_utc": "2026-05-23T22:00:00.000Z",
        "period_end_utc": "2026-05-23T23:00:00.000Z",
        "volume_mw": 582,
        "contracted_volume_mw": 576,
        "offered_volume_mw": 590,
        "price": 18.4,
        "direction": "SYMMETRIC",
        "product_type": "FCR",
        "time_horizon": "DAILY"
      }
    ],
    "latestFetchedAtUtc": "2026-05-23T14:35:24.755Z"
  },
  "afrr": {
    "rows": [
      {
        "period_start_utc": "2026-05-23T22:00:00.000Z",
        "period_end_utc": "2026-05-23T23:00:00.000Z",
        "direction": "UPWARD",
        "price": 12.7,
        "product_type": "aFRR",
        "offered_volume_mw": 430,
        "contracted_volume_mw": 418,
        "time_horizon": "DAILY"
      }
    ],
    "latestFetchedAtUtc": "2026-05-23T14:35:24.755Z"
  },
  "mfrr": {
    "rows": [
      {
        "period_start_utc": "2026-05-23T22:00:00.000Z",
        "period_end_utc": "2026-05-23T23:00:00.000Z",
        "direction": "DOWNWARD",
        "price": 9.8,
        "product_type": "mFRR",
        "offered_volume_mw": 310,
        "contracted_volume_mw": 300,
        "time_horizon": "DAILY"
      }
    ],
    "latestFetchedAtUtc": "2026-05-23T14:35:24.755Z"
  }
}

GET/api/balancing-energy

Agrège les payloads d'énergie aFRR et mFRR dans une seule réponse JSON. Le sous-objet `afrr` expose les séries 4 secondes agrégées en buckets 5 minutes pour le chart, et `mfrr` expose les intervalles 15 minutes et les dernières lignes UP/DOWN.

URL	https://co-c8jb.nanocorp.app/api/balancing-energy
Authentification	Cookie dashboard actif ou Authorization: Bearer <token>
Query string	Aucun
Notes	401 si aucun abonnement actif

Champs de réponse

Champ	Type	Description
latestFetchedAtUtc	string \| null	Horodatage UTC le plus récent parmi les flux aFRR énergie et mFRR énergie.
afrr	object	Même payload que `GET /api/afrr-energy`.
mfrr	object	Même payload que `GET /api/mfrr-energy`.

Exemple de requête

curl \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://co-c8jb.nanocorp.app/api/balancing-energy

Exemple de réponse

{
  "latestFetchedAtUtc": "2026-05-23T23:20:06.497Z",
  "afrr": {
    "latestDeliveryDateParis": "2026-05-23",
    "latestFetchedAtUtc": "2026-05-23T23:10:28.164Z",
    "latestPeriodStartUtc": "2026-05-23T21:59:56.000Z",
    "latestPeriodEndUtc": "2026-05-23T22:00:00.000Z",
    "resolutionSeconds": 4,
    "rowCount": 21600,
    "averageUpwardPrice": 74.2,
    "averageDownwardPrice": -8.6,
    "latestRow": {
      "period_start_utc": "2026-05-23T21:59:56.000Z",
      "period_end_utc": "2026-05-23T22:00:00.000Z",
      "upward_price_eur_mwh": 83.4,
      "downward_price_eur_mwh": -11.2,
      "pdemand_mw": 2150,
      "afrr_for_france_mw": 96,
      "afrr_in_france_mw": 84,
      "picasso_connection": true,
      "prorata_mode": false
    },
    "recentRows": [
      {
        "period_start_utc": "2026-05-23T21:59:56.000Z",
        "period_end_utc": "2026-05-23T22:00:00.000Z",
        "upward_price_eur_mwh": 83.4,
        "downward_price_eur_mwh": -11.2,
        "pdemand_mw": 2150,
        "afrr_for_france_mw": 96,
        "afrr_in_france_mw": 84,
        "picasso_connection": true,
        "prorata_mode": false
      }
    ],
    "chartRows": [
      {
        "bucket_start_utc": "2026-05-23T21:55:00.000Z",
        "bucket_end_utc": "2026-05-23T22:00:00.000Z",
        "upward_price_eur_mwh": 79.8,
        "downward_price_eur_mwh": -9.4
      }
    ]
  },
  "mfrr": {
    "latestDeliveryDateParis": "2026-05-23",
    "latestFetchedAtUtc": "2026-05-23T23:20:06.497Z",
    "latestPeriodStartUtc": "2026-05-23T21:45:00.000Z",
    "latestPeriodEndUtc": "2026-05-23T22:00:00.000Z",
    "resolutionSeconds": 900,
    "rowCount": 192,
    "averageUpwardPrice": 118.1,
    "averageDownwardPrice": 0,
    "latestUpwardRow": {
      "period_start_utc": "2026-05-23T21:45:00.000Z",
      "period_end_utc": "2026-05-23T22:00:00.000Z",
      "direction": "UPWARD",
      "clearing_price_eur_mwh": 126.5,
      "settlement_price_current_eur_mwh": 126.5,
      "settlement_price_previous_eur_mwh": 121.3,
      "total_requested_volume_sa_mw": 45,
      "total_requested_volume_da_mw": 0,
      "total_satisfied_need_sa_mw": 42,
      "total_satisfied_need_da_mw": 0,
      "total_activated_volume_sa_mw": 42,
      "total_activated_volume_da_mw": 0,
      "total_volume_submitted_offers_mw": 310,
      "total_volume_filtered_offers_mw": 265
    },
    "latestDownwardRow": {
      "period_start_utc": "2026-05-23T21:45:00.000Z",
      "period_end_utc": "2026-05-23T22:00:00.000Z",
      "direction": "DOWNWARD",
      "clearing_price_eur_mwh": 0,
      "settlement_price_current_eur_mwh": 0,
      "settlement_price_previous_eur_mwh": 0,
      "total_requested_volume_sa_mw": 0,
      "total_requested_volume_da_mw": 0,
      "total_satisfied_need_sa_mw": 0,
      "total_satisfied_need_da_mw": 0,
      "total_activated_volume_sa_mw": 0,
      "total_activated_volume_da_mw": 0,
      "total_volume_submitted_offers_mw": 180,
      "total_volume_filtered_offers_mw": 180
    },
    "recentRows": [
      {
        "period_start_utc": "2026-05-23T21:45:00.000Z",
        "period_end_utc": "2026-05-23T22:00:00.000Z",
        "upward_price_eur_mwh": 126.5,
        "downward_price_eur_mwh": 0
      }
    ],
    "chartRows": [
      {
        "period_start_utc": "2026-05-23T21:45:00.000Z",
        "period_end_utc": "2026-05-23T22:00:00.000Z",
        "upward_price_eur_mwh": 126.5,
        "downward_price_eur_mwh": 0
      }
    ]
  }
}

Accès et tarifs

Générez vos tokens depuis l’onglet API du dashboard. Pour un usage en production avec garanties de service, consultez les offres dashboard.

Voir les offres

Contact

Pour toute question sur l'intégration ou les données, contactez-nous à co-c8jb@nanocorp.app