Joltio Data / API

Conecta con Joltio Data

Una clave por persona te da todo el catálogo desde Python, HTTP o tu pipeline. Claude se conecta con tu cuenta de Joltio, sin clave.

API de datos
api.joltio.app/data
Servidor MCP
api.joltio.app/mcp
Autenticación
X-API-Key o Bearer

OpenAPI 3.1 · /data/openapi.json

  1. 01

    Obtén una clave de API

    Crea una clave en el panel, en Data, Claves de API. Empiezan por jol_live_ y solo se muestran una vez: guárdalas en tu gestor de secretos, nunca en el código.

    Envíala en cada petición con cualquiera de estas cabeceras

    Cabeceras HTTP
    X-API-Key: jol_live_…
    Authorization: Bearer jol_live_…
    Empezar gratis ¿Aún no tienes workspace? Empezar gratis
  2. 02

    Conecta Claude

    Añade Joltio como conector personalizado. Claude te identifica con tu cuenta de Joltio por OAuth, así que no hay clave que pegar.

    En Claude, abre Ajustes, Conectores, Añadir conector personalizado, y pega esta URL

    URL de MCP
    https://api.joltio.app/mcp
  3. 03

    Conecta ChatGPT

    Añade Joltio como app MCP personalizada. ChatGPT te identifica con tu cuenta de Joltio por OAuth, así que no hay clave que pegar. Las apps MCP personalizadas requieren el modo desarrollador y están disponibles en ChatGPT Business, Enterprise y Edu (web).

    1. Activa el modo desarrollador: Ajustes, Apps, Ajustes avanzados, Modo desarrollador (en Business lo hace un administrador del workspace en Ajustes del workspace, Apps, Crear).
    2. Abre Ajustes, Apps, Crear, y pega esta URL del servidor MCP. Elige OAuth como autenticación.
    URL de MCP
    https://api.joltio.app/mcp
    1. Pulsa Scan Tools, entra con tu cuenta de Joltio cuando te lo pida, espera al análisis y pulsa Crear.
    2. En un chat nuevo, elige la app en el menú de herramientas y pregunta por el mercado eléctrico.
  4. 04

    Úsalo desde cualquier chat o agente

    Con Claude o ChatGPT conectado no necesitas escribir código ni instalar un plugin. El conector ofrece las skills de Joltio que permite tu workspace mediante skills_get y recursos MCP. El asistente las carga cuando las necesita y consulta tu plan con data_status antes de consultar datos.

    Cosas que puedes pedirle

    • ¿Qué tablas y rangos de fechas incluye mi plan?
    • Lee la guía de Joltio Data y explícame cómo obtener los precios horarios de OMIE.
    • Muéstrame el precio del mercado diario de ayer por hora y haz un gráfico.

    ¿Un chat sin conector, o un agente de código? Compárteles esta dirección para que lean la documentación:

    llms.txt
    https://joltio.app/llms.txt

    El mismo archivo indica la dirección del MCP y cómo autenticarse, así que un agente puede configurarse a partir de él.

    Instalación local opcional para Claude Code, Codex y Cursor: Joltio skills. Claude Code instala las skills y el conector MCP juntos; Codex y Cursor los configuran por separado. El conector por sí solo ya ofrece las skills. github.com/datons/joltio-skills

  5. 05

    Terminal

    Instala el comando Joltio e inicia sesión en el navegador. La sesión se renueva mientras lo usas.

    Terminal
    uv tool install joltio
    joltio login
    joltio data query "SELECT max(datetime) FROM omie.prices"
  6. 06

    Python con inicio de sesión

    Instala el mismo paquete en tu entorno Python, inicia sesión una vez y usa Client() sin copiar una clave. Para CI o cuadernos compartidos, usa una clave de API.

    Python con inicio de sesión
    pip install joltio
    joltio login
    python -c "from joltio import Client; print(Client().data.query('SELECT max(datetime) FROM omie.prices'))"
  7. 07

    MCP local para Claude Code

    El MCP alojado no requiere instalación. Para ejecutarlo en local, instala el extra MCP y registra el comando.

    MCP local para Claude Code
    uv tool install "joltio[mcp]"
    joltio login
    claude mcp add joltio -- joltio mcp
  8. 08

    Consulta desde Python

    El cliente joltio lee JOLTIO_API_KEY y devuelve DataFrames de polars.

    Instalar
    pip install joltio        # or: uv add joltio
    Python · Ejemplo
    from joltio import Client
    
    j = Client()  # reads JOLTIO_API_KEY
    df = j.data.query("SELECT max(datetime) FROM omie.prices WHERE datetime >= today() - 7")
    print(df)
  9. 09

    Python en VS Code

    Genera tu clave, descarga la carpeta y ábrela en VS Code. Tu clave va en .env, nunca dentro del cuaderno.

    Descargar la carpeta (zip) Cuaderno de 15 celdas · incluye .env, .env.example, AGENTS.md para tu asistente de IA y README

    Cómo debe quedar la carpeta

    Descomprímela y abre la carpeta en VS Code. Mantén los ficheros juntos: el cuaderno busca .env en la carpeta desde la que se ejecuta.

    • joltio-quickstart/
    • joltio-quickstart.ipynbEl cuaderno. Ábrelo en VS Code y elige tu entorno de Python como kernel.
    • investiga-una-unidad.ipynbSegundo cuaderno: una unidad de programación (CTGN1, Cartagena) del mercado diario a su programa final, con gráficos interactivos y un treemap.
    • .envTu configuración privada, vacía a propósito. Pega aquí tu clave de API. No la compartas ni la subas a un repositorio.
    • .env.exampleLa misma plantilla sin la clave. Se puede compartir; si pierdes .env, copia esta y vuelve a rellenarla.
    • AGENTS.mdInstrucciones para los asistentes de IA que trabajan en esta carpeta.
    • CLAUDE.mdDirige Claude Code a AGENTS.md.
    • README.mdInstrucciones de instalación del cuaderno y su configuración local.

    Los ficheros que empiezan por punto están ocultos por defecto en Finder y el Explorador; VS Code los muestra.

    Instala el cliente en el entorno de Python que usa VS Code
    pip install joltio python-dotenv ipykernel matplotlib plotly nbformat
    Terminal
    joltio data quickstart joltio-quickstart
    Pega tu clave en .env
    JOLTIO_API_KEY=jol_live_…

    El zip ya trae .env, vacío a propósito: pon la clave justo después de JOLTIO_API_KEY= y guarda.

    Abre el cuaderno, elige ese entorno como kernel y ejecuta la primera celda.

    Redes corporativas

    Si tu empresa inspecciona el tráfico HTTPS, Python no reconoce su certificado y la primera consulta falla con un error de certificado SSL. Pide a TI el certificado raíz en formato PEM y apúntalo en el mismo .env: SSL_CERT_FILE es el que lee el cliente joltio y REQUESTS_CA_BUNDLE cubre pip y las librerías basadas en requests.

    Líneas para añadir a .env
    SSL_CERT_FILE=C:\certs\company-root-ca.pem
    REQUESTS_CA_BUNDLE=C:\certs\company-root-ca.pem
  10. 10

    Llama a la API HTTP

    Sirve cualquier lenguaje: envía SQL a /data/query o consulta la cobertura y la frescura, que no requiere clave.

    Consulta SQL
    curl https://api.joltio.app/data/query \
      -H "X-API-Key: $JOLTIO_API_KEY" \
      -H "User-Agent: my-app/1.0" \
      -H "Content-Type: application/json" \
      -d '{"sql": "SELECT max(datetime) FROM omie.prices WHERE datetime >= today() - 7"}'
    Cobertura (pública)
    curl "https://api.joltio.app/data/coverage?table=omie.prices" \
      -H "User-Agent: my-app/1.0"

    Envía siempre un User-Agent identificativo. Las peticiones con el agente por defecto de algunas librerías se rechazan con 403.

Incluido

Plan

Data viene incluido con cualquier producto Joltio: ventana de histórico corta y cuota mensual pequeña. Amplía tu plan para más histórico, I90 en bruto y más créditos.

Consulta tu plan y tus límites con GET https://api.joltio.app/data/tier-info Ampliar