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
  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

    HTTP headers
    X-API-Key: jol_live_…
    Authorization: Bearer jol_live_…
    Crear una clave ¿Aún no tienes workspace? Solicitar acceso
  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

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

    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")
    print(df)
  4. 04

    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"}'
    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