Acceso y claves

  1. 1Obtener acceso →

    Regístrate o acepta una invitación al espacio de trabajo. Tu nivel de acceso determina las tablas y el histórico.

  2. 2Crear una clave →

    Abre Cuenta → Claves API. La clave se muestra una sola vez; envíala como X-API-Key.

  3. 3Consultar tu nivel de acceso →

    GET /tier-info devuelve tus permisos y data_windows, basados en los datos reales.

  4. 4Conectar Claude →

    MCP utiliza OAuth: inicia sesión sin pegar una clave API.

Consultar tu ventana de datos

curl https://api.datons.com/esios/tier-info -H 'X-API-Key: YOUR_API_KEY'

API access

Query ESIOS market data programmatically from Python. Use the datons client or call the REST endpoints directly.

Quickstart

Video walkthrough

Install

pip install datons

Example

from datons import Client

client = Client(token="YOUR_API_KEY")

# Query preprocessed I90 market data → pandas DataFrame
df = client.esios.query(
    "SELECT unit, datetime, energy, price "
    "FROM esios.archives_i90 "
    "WHERE program = 'PDBF' AND toDate(datetime) >= '2025-01-01' "
    "LIMIT 100"
)
print(df.head())

Authentication

Request header

Include your API key in every request:

X-API-Key: your_key_here

Environment variable

Set DATONS_API_KEY and the client will pick it up automatically:

export DATONS_API_KEY=your_key_here

Base URL

https://api.datons.com/esios

Don't have an API key yet? Get your API key from your account dashboard.

Forzar una recarga de datos revisados

Úsalo solo cuando ESIOS haya revisado valores ya publicados y necesites volver a descargar un rango concreto. La frescura ordinaria es responsabilidad del pipeline; la recarga es una vía de recuperación puntual, no un mecanismo de actualización rutinario.

REST · POST /ingest/reingest

Planes compatibles
curl -X POST https://api.datons.com/esios/ingest/reingest \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "indicators": [600, 1293],
    "date_from": "2026-08-01",
    "date_to": "2026-08-03",
    "reason": "ESIOS revised already-published values"
  }'

MCP

request_reingest

Acepta los mismos indicadores, fechas y motivo. Úsalo desde Claude u otro cliente MCP cuando la revisión se detecte durante el análisis.

La solicitud es asíncrona

La API encola la recarga y devuelve un identificador, una ETA aproximada y una URL de estado. Consulta status_url hasta que cambie de pending a running y después a done o failed; no mantengas abierta la petición POST.

{
  "checkpoint_id": "2a6b6f08-...",
  "status": "pending",
  "eta_seconds": 42,
  "status_url": "/ingest/checkpoints/2a6b6f08-..."
}
Ver solicitudes y estado de los datos

Endpoint reference

Rate limits

All API requests are rate-limited by tier. See plans for tier comparison. All queries are read-only (SELECT only).

Response headers

Every response includes rate limit headers so you can track your usage:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 73
X-RateLimit-Reset: 1712448000
X-Tier: explorer