Saltar al contenido
Servicio independiente · No es un sitio oficial del BOEDatos a 22 de noviembre de 2026, 05:10 UTC
Subastas BOEAPI

Cómo enterarte de la primera puja de una subasta sin mirar el portal

Un script de treinta líneas que consulta el histórico de cambios y avisa cuando una subasta recibe su primera puja, se cancela o se cierra.

· 2 min de lectura

El portal no avisa de nada. Si sigues diez subastas y quieres saber cuándo alguna recibe su primera puja, la única forma es entrar a las diez fichas, una por una, varias veces al día.

Con la API basta una petición. Este tutorial monta un aviso que detecta tres momentos: la primera puja, la cancelación y el cierre.

Qué señal buscar

Mientras una subasta está abierta, el portal no publica importes: solo dice si hay puja. En la API eso se traduce en el campo bids.tipo, que pasa por estos estados:

Cambio en bids.tipoQué ha ocurrido
sin_pujas a ocultaHa llegado la primera puja
cualquiera a canceladaLa autoridad gestora la ha cancelado o suspendido
oculta a puja_maxima_finalHa concluido con puja; el importe ya es público

En las subastas por lotes, la señal equivalente es un cambio en bids.lote.N, que pasa de «Sin puja» a «Con puja».

El script

Necesitas la URL base y el token, que aquí se leen de las variables de entorno BASE y TOKEN, y un fichero donde guardar hasta dónde has leído.

import json
import os
import pathlib
import requests

BASE = os.environ["BASE"]
CABECERAS = {"Authorization": os.environ["TOKEN"], "Accept": "application/json"}
ESTADO = pathlib.Path("ultimo_cambio.json")
SEGUIDAS = ["SUB-JA-2026-000001", "SUB-AT-2026-00R0000000002"]

AVISOS = {
    "oculta": "ha recibido su primera puja",
    "cancelada": "ha sido cancelada o suspendida",
    "puja_maxima_final": "ha concluido con puja",
}

def cambios(desde_id):
    params = {"fields": "bids.tipo", "order": "desc", "limit": 500,
              "auction_numbers": ",".join(SEGUIDAS)}
    while True:
        r = requests.get(f"{BASE}/api/changes", headers=CABECERAS, params=params, timeout=30)
        r.raise_for_status()
        pagina = r.json()
        for c in pagina["changes"]:
            if c["id"] <= desde_id:
                return
            yield c
        if not pagina["has_more"]:
            return
        params["before_id"] = pagina["before_id_next"]

ultimo = json.loads(ESTADO.read_text())["id"] if ESTADO.exists() else 0
nuevos = list(cambios(ultimo))

for c in reversed(nuevos):
    aviso = AVISOS.get(c["new_value"])
    if aviso:
        print(f'{c["changed_at"]}  {c["auction_number"]} {aviso}')

if nuevos:
    ESTADO.write_text(json.dumps({"id": nuevos[0]["id"]}))

Cómo funciona

  • Pide los cambios de bids.tipo de las subastas que sigues, del más reciente al más antiguo.
  • Se detiene al llegar al último cambio que ya había procesado, cuyo id guarda en un fichero.
  • Traduce el valor nuevo a un mensaje y lo imprime en orden cronológico.

El parámetro auction_numbers admite hasta 50 identificadores. Si sigues más, reparte la lista en varias peticiones. Si lo quitas, recibes los cambios de todas las subastas abiertas, que es lo que interesa para vigilar una zona o un tipo de bien en vez de unas subastas concretas.

Cada cuánto ejecutarlo

El estado de las pujas de cada subasta abierta se comprueba aproximadamente una vez por hora. Ejecutar el script cada quince minutos es más que suficiente; hacerlo cada minuto no te dará avisos antes.

Con cron:

*/15 * * * * cd /ruta/al/script && BASE=… TOKEN=… python3 avisos.py >> avisos.log

Sustituye el print por lo que uses para avisarte: un correo, un mensaje a un canal, una notificación al móvil.

Añadir las prórrogas

Para enterarte también de cuándo se desplaza la hora de cierre, añade fecha_conclusion a fields y trata ese campo aparte: ahí el valor nuevo no es un estado, sino la nueva fecha. Si llega vacío, la subasta ha perdido su fecha, que es lo que ocurre cuando se cancela. El contexto está en por qué una subasta no termina a la hora que dice.

Lo que no puede avisarte

El importe de la puja mientras la subasta sigue abierta. No es público, y la API no lo tiene. Sabrás que hay puja; cuánto, solo al final.

La referencia completa de parámetros está en la documentación, y si empiezas de cero conviene leer antes los primeros pasos.

Configurar cookies

Elige qué categorías permites. Puedes cambiar de opinión cuando quieras desde el enlace «Configurar cookies» del pie de página. Detalle de cada cookie en la política de cookies.