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.
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.tipo | Qué ha ocurrido |
|---|---|
sin_pujas a oculta | Ha llegado la primera puja |
cualquiera a cancelada | La autoridad gestora la ha cancelado o suspendido |
oculta a puja_maxima_final | Ha 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.tipode 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
idguarda 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.