--- title: "Datos y API · Frontera Signal" description: "Datos de negocio del Valle del Río Grande para agentes de IA: espera en los puentes, cruces fronterizos, el peso y el diésel, impuesto sobre ventas, ventas…" url: "https://fronterasignal.com/es/data/" lang: "es-MX" --- Datos hasta la semana 44 de 2026 Actualizados el 3 nov 2026 Datos y API # Datos de negocio del Valle, por consulta Los datos detrás de Frontera Signal, listos para software y agentes de IA. Un agente puede consultar la espera en los puentes, los cruces fronterizos, el peso, el diésel, el impuesto sobre ventas de cada ciudad, las ventas de bares y restaurantes, las agencias de salud en casa, los permisos, los proyectos comerciales, los precios de materiales y el inventario de vivienda del Valle del Río Grande, y paga por cada respuesta entre $0.01 y $0.25. Precio De $0.01 a $0.25 por consulta, pagados en USDC en la red Base Pago x402 v2, directo desde la billetera del agente. Sin clave de API ni cuenta. Cómo se paga Gratis Los errores (400) y las respuestas vacías (404) nunca se cobran. Una muestra real de cada endpoint y las últimas 4 semanas de cada serie son gratis. Para su agente [`/api/v1`](https://fronterasignal.com/api/v1) enumera cada endpoint con su precio, sus parámetros y su muestra gratis. Documentación [`/openapi.json`](https://fronterasignal.com/openapi.json) · [`/llms.txt`](https://fronterasignal.com/llms.txt) · [`/.well-known/x402`](https://fronterasignal.com/.well-known/x402) Datos hasta semana 44 de 2026, actualizados el 3 nov 2026 ## Qué puede preguntar 25 endpoints, cada uno con un ejemplo de pregunta que responde. Cada muestra gratis es una respuesta real con los datos actuales, para que revise el formato antes de pagar. 1. Panorama de construcción por ciudad “¿Hay sobreoferta de vivienda en McAllen y están subiendo los costos de construcción esta semana?” `GET /api/v1/snapshot?city=McAllen` semanal y mensual · hasta la semana 44 de 2026 $0.02 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/snapshot.json) 2. Proyectos comerciales nuevos “¿Qué proyectos comerciales se registraron en el condado de Hidalgo desde el 1 de septiembre, de quién son y de qué tamaño?” `GET /api/v1/projects?city=McAllen&limit=5` diaria · datos al 1 nov 2026 $0.03 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/projects.json) 3. Historial de una empresa “¿Cuántos proyectos ha registrado este desarrollador en el Valle desde 2024 y de qué tamaño fue el más grande?” `GET /api/v1/companies?name=independent+school+district` diaria · datos al 1 nov 2026 $0.02 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/companies.json) 4. Proyectos cerca de una dirección “¿Cuántos proyectos comerciales se registraron en un radio de dos millas de 1201 E Capote Central Ave, en Pharr, y cuánto valen?” `GET /api/v1/nearby?address=1201+E+Capote+Central+Ave&city=Pharr&radius_mi=2` diaria · datos al 1 nov 2026 $0.03 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/nearby.json) 5. Registro del predio de una dirección “¿Cuál es el número de predio, la superficie construida y el valor de mercado de 800 S 10th St, en McAllen?” `GET /api/v1/parcel?address=800+S+10th+St&city=McAllen` lectura en vivo en cada consulta · datos al 11 feb 2026 $0.04 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/parcel.json) 6. Costo registrado por pie cuadrado “¿Cuánto cuesta hoy el pie cuadrado de construcción comercial nueva en el condado de Hidalgo?” `GET /api/v1/cost-per-sqft?county=Hidalgo` diaria · datos al 1 nov 2026 $0.03 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/cost-per-sqft.json) 7. Precios de materiales en tienda “¿Cuánto cuesta esta semana un tablero OSB de 7/16 en McAllen?” `GET /api/v1/materials?item=osb` dos veces por semana · datos al 29 oct 2026 $0.01 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/materials.json) 8. Permisos de construcción por semana “¿Los permisos de vivienda unifamiliar en McAllen subieron o bajaron en los últimos dos meses?” `GET /api/v1/series/permits-weekly?from=2026-W44&to=2026-W44` semanal · hasta la semana 44 de 2026 $0.05 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/series-permits-weekly.json) 9. Permisos de vivienda por mes “¿Cuántas casas unifamiliares autorizó Brownsville cada mes de este año?” `GET /api/v1/series/permits-monthly?place=Brownsville&from=2026-01` mensual · datos al 31 ago 2026 $0.05 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/series-permits-monthly.json) 10. Precios de insumos por semana “¿La madera para estructura ha subido o bajado desde agosto?” `GET /api/v1/series/cost-basket-weekly?from=2026-W44&to=2026-W44` semanal y mensual · hasta la semana 44 de 2026 $0.05 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/series-cost-basket-weekly.json) 11. Inventario de vivienda por semana “¿La zona metropolitana de McAllen tiene más de seis meses de inventario de vivienda?” `GET /api/v1/series/absorption?from=2026-W44&to=2026-W44` mensual · hasta la semana 44 de 2026 $0.05 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/series-absorption.json) 12. Mano de obra y financiamiento “¿Cuánto se tarda hoy en construir una casa de 2,100 pies cuadrados en el Valle?” `GET /api/v1/series/labor-ranges?from=2026-W30&to=2026-W30` mensual · hasta la semana 30 de 2026 Última lectura disponible: 24 de julio de 2026. Aún no se ha publicado una lectura más reciente, por lo que estas son las cifras más recientes. $0.05 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/series-labor-ranges.json) 13. Historial de pronósticos “¿Cuántos pronósticos de Frontera Signal se han calificado como acierto (HIT)?” `GET /api/v1/series/calls?from=2026-W44&to=2026-W44` semanal · hasta la semana 44 de 2026 $0.05 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/series-calls.json) 14. Edición semanal en JSON “¿Qué cambió esta semana en la construcción del Valle?” `GET /api/v1/issue?week=2026-W37&lang=en` semanal · hasta la semana 44 de 2026 $0.25 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/issue.json) 15. Tiempos de espera en los puentes, ahora “¿Qué puente del Valle tiene ahora la menor espera para carga comercial?” `GET /api/v1/bridge-wait?mode=commercial` cada 15 minutos · datos al 26 oct 2026 $0.01 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/bridge-wait.json) 16. Espera en los puentes por hora de la semana “¿Cuánto suele tardar la fila comercial en Pharr un lunes a las 2 pm?” `GET /api/v1/bridge-hourly?crossing=pharr&mode=commercial` diaria · datos al 26 oct 2026 $0.03 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/bridge-hourly.json) 17. Cruces fronterizos por mes “¿Los cruces de camiones por Hidalgo y Pharr subieron contra el año pasado?” `GET /api/v1/crossings?port=hidalgo&measure=trucks` mensual · datos al 1 sep 2026 $0.03 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/crossings.json) 18. Tipo de cambio del peso “¿Cuántos pesos compra un dólar y cómo se ha movido este mes?” `GET /api/v1/peso` diaria · datos al 16 oct 2026 $0.01 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/peso.json) 19. Precio del diésel en la Costa del Golfo “¿Cuánto cuesta el diésel esta semana en la Costa del Golfo y cuánto costaba hace un año?” `GET /api/v1/diesel` semanal · datos al 19 oct 2026 $0.01 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/diesel.json) 20. Impuesto sobre ventas por ciudad y mes “¿El impuesto sobre ventas de McAllen subió contra hace un año?” `GET /api/v1/sales-tax?city=McAllen` mensual · datos al 1 oct 2026 $0.02 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/sales-tax.json) 21. Negocios nuevos “¿Cuántos restaurantes nuevos abrieron en McAllen en los últimos 90 días y cuáles son?” `GET /api/v1/new-outlets?city=McAllen&industry=restaurants&limit=10` semanal · datos al 24 oct 2026 $0.05 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/new-outlets.json) 22. Ventas de alcohol en bares y restaurantes “¿Qué bares de McAllen vendieron más alcohol el mes pasado?” `GET /api/v1/alcohol-sales?city=McAllen&limit=10` mensual · datos al 1 sep 2026 $0.05 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/alcohol-sales.json) 23. Agencias de salud en casa “¿Qué agencias de salud en casa de McAllen tienen 4 estrellas o más?” `GET /api/v1/home-health?city=McAllen&min_stars=4` trimestral · datos al 21 oct 2026 $0.03 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/home-health.json) 24. Panorama por industria “¿Qué cambió esta semana para la carga y las aduanas del Valle?” `GET /api/v1/industry?industry=freight` diaria · datos al n/d $0.02 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/industry.json) 25. Pregúntale al Valle “¿Cuánto cuesta un 2x4 en McAllen esta semana?” `GET /api/v1/ask?q=What+does+a+2x4+cost+in+McAllen+this+week%3F&lang=en` lectura en vivo en cada consulta · datos al n/d $0.25 por consulta [Muestra gratis](https://fronterasignal.com/data/v1/samples/ask.json) ## Cómo se paga 1. Haga un GET normal. Sin pago, la respuesta es `402 Payment Required`: el encabezado `PAYMENT-REQUIRED` trae las condiciones de pago x402, y el cuerpo JSON indica el precio, lo que devuelve la consulta y dónde están la muestra gratis y la documentación. 2. Un cliente x402 firma un pago en USDC en la red Base por ese monto exacto y repite la misma solicitud con el encabezado `PAYMENT-SIGNATURE`. La respuesta llega con el recibo en `PAYMENT-RESPONSE`. El facilitador paga la comisión de la red, así que la billetera solo necesita USDC. 3. Un error no le cuesta nada. Cada parámetro se revisa antes del pago: un parámetro desconocido o mal escrito devuelve un 400 gratis con la lista de valores permitidos, y una consulta válida sin resultados devuelve un 404 gratis. Primero vea el precio. Esta llamada es gratis. ``` curl -i 'https://fronterasignal.com/api/v1/snapshot?city=McAllen' ``` Qué trae el cuerpo del 402 ``` { "error": "payment_required", "price": "$0.02", "returns": "One Valley city's (or the whole Valley's) latest permits, monthly housing permits by structure type, sales tax receipts, housing supply, building-input and material prices, labor conditions, newest commercial projects and this morning's mortgage rate, 10-year yield and diesel price, every value dated.", "sample": "https://fronterasignal.com/data/v1/samples/snapshot.json", "docs": "https://fronterasignal.com/openapi.json", "how_to_pay": "x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE" } ``` Pague y lea la respuesta con Node 20 o posterior (guarde el código como pay.mjs) ``` // npm install @x402/fetch @x402/evm viem import { wrapFetchWithPaymentFromConfig } from '@x402/fetch'; import { ExactEvmScheme } from '@x402/evm'; import { privateKeyToAccount } from 'viem/accounts'; // Una billetera con un poco de USDC en Base. No ponga la clave en el código. const account = privateKeyToAccount(process.env.PRIVATE_KEY); const pay = wrapFetchWithPaymentFromConfig(fetch, { schemes: [{ network: 'eip155:8453', client: new ExactEvmScheme(account) }], }); const res = await pay('https://fronterasignal.com/api/v1/snapshot?city=McAllen'); console.log(res.status, await res.json()); ``` ## Cobertura | Datos | Qué y dónde | Historial | | --- | --- | --- | | Tiempos de espera en los puentes | Los 11 cruces fronterizos de los condados de Cameron, Hidalgo y Starr, leídos cada 15 minutos | en vivo | | Espera por hora de la semana | Los mismos 11 cruces, por carril y por hora | desde octubre de 2026 | | Cruces fronterizos por puerto | Camiones, vehículos particulares y peatones en los cinco puertos de entrada, cada mes | los últimos 26 meses | | Peso y diésel | Pesos por dólar cada día; diésel al menudeo en la Costa del Golfo cada semana | los últimos 12 meses y 60 semanas | | Impuesto sobre ventas por ciudad | 45 ciudades de los condados de Hidalgo, Cameron, Starr y Willacy, cada mes | el último mes y lo que va del año | | Ventas de bares y restaurantes | Ventas de alcohol de los reportes estatales del impuesto a bebidas mezcladas, en los cuatro condados | el reporte mensual más reciente | | Agencias de salud en casa | Agencias certificadas y sus calificaciones federales de calidad, en los cuatro condados | la calificación trimestral más reciente | | Negocios nuevos | Negocios nuevos con permiso de impuesto sobre ventas, por industria y ciudad, en los cuatro condados | los últimos 90 días | | Panorama por ciudad y permisos semanales | McAllen, Edinburg, Mission, Pharr, San Juan, Weslaco, Donna, Mercedes, Brownsville y Harlingen, en los condados de Hidalgo y Cameron, o el Valle completo | desde semana 30 de 2026 | | Proyectos comerciales, historial de empresas y costo por pie cuadrado | 1,511 registros ante el estado: Hidalgo 961, Cameron 518, Starr 22, Willacy 10 | desde 4 oct 2024 | | Precios de materiales en tienda | 18 artículos y 76 precios fechados de tiendas de cadena y un depósito de materiales local en Mission | desde 28 sep 2026 | | Inventario de vivienda | Zonas metropolitanas de McAllen y Brownsville, con datos de Redfin y Zillow | desde semana 30 de 2026 | | Precios de insumos | Madera, tablero OSB, tablaroca, varilla, cobre, diésel, el índice de precios al productor de la construcción y la tasa hipotecaria a 30 años de Freddie Mac | desde semana 30 de 2026 | | Mano de obra y financiamiento | Valle del Río Grande en conjunto, sin datos por empresa | desde semana 30 de 2026 | | Historial de pronósticos | 75 pronósticos con fecha, cada uno calificado como HIT (acierto), MISS (fallo), PUSH (empate) u OPEN (abierto) | desde semana 30 de 2026 | | Edición semanal | 7 ediciones en español e inglés | desde semana 37 de 2026 | | Proyectos cerca de una dirección | 999 de 1,511 registros (66.1%) están ubicados en el mapa, en los cuatro condados | desde 4 oct 2024 | | Registros de predios | Condado de Hidalgo, leídos en vivo del registro de predios del condado en cada consulta. Última actualización del condado: 11 feb 2026 | en vivo | | Permisos de vivienda por mes | 46 ciudades y áreas fuera de los límites municipales en los cuatro condados, por tipo de estructura, hasta agosto de 2026 | desde enero de 2024 | | Licencias de oficio en el historial de empresas | 1,178 licencias de negocios: contratistas de aire acondicionado, electricidad, anuncios luminosos, elevadores e instalación de aparatos. Datos al 19 sep 2026 | n/d | | Impuesto municipal sobre ventas (incluido en el panorama) | Brownsville, Donna, Edinburg, Harlingen, McAllen, Mercedes, Mission, Pharr, San Juan y Weslaco, cada mes | desde enero de 2024 | ## Vigencia de los datos Los datos llegan hasta la semana 44 de 2026 y se actualizaron el 3 nov 2026. Cada endpoint de la lista muestra su frecuencia y la fecha de sus datos más recientes. En una respuesta pagada, cada valor indica su antigüedad. Estas son dos filas reales de la muestra gratis de McAllen: ``` [ { "week_id": "2026-W44", "measure": "commercial_projects_registered_state", "count": 0, "status": "reported", "value_usd": null, "as_of": "2026-10-30", "age_days": 4, "cadence": "weekly", "stale": false, "source": "Frontera Signal" } ] ``` `as_of` Fecha de la lectura. `age_days` Días entre as\_of y la respuesta. `cadence` Cada cuánto publica la fuente: weekly (semanal) o monthly (mensual). `stale` true cuando una medida semanal tiene más de 14 días o una mensual más de 90. `status` reported (reportado); dark (la fuente no publicó nada esa semana); o no\_reading (no tenemos lectura). `value` Un rango se entrega como {low, high, unit}; approx: true indica una lectura redondeada. ## Límites - **Una fila dark (sin datos) también es una respuesta.** En la semana 44 de 2026, 4 de las 33 lecturas de permisos quedaron como dark porque la fuente no publicó nada. Usted recibe la fila marcada como dark, nunca un cero ni un estimado. Si todas las filas que pide son dark, la respuesta es un 404 gratis. - **Las fuentes mensuales dejan huecos.** 376 de las 465 filas semanales de inventario de vivienda están marcadas como no\_reading. Revise as\_of antes de comparar semanas. - **Los datos de mano de obra son escasos.** La lectura más reciente es de la semana 30 de 2026. - **El costo por pie cuadrado sale de estimados registrados.** Se calcula con los costos estimados que se registran ante el estado. Nada de esto es una cotización, una propuesta ni un avalúo. - **Permisos semanales en dos condados.** Los permisos semanales por ciudad cubren Hidalgo y Cameron. Los permisos de vivienda por mes cubren los cuatro condados. Los proyectos comerciales de Starr (22) y Willacy (10) sí aparecen en los registros. - **La ubicación es parcial.** Solo el 66.1% de los registros está ubicado en el mapa, porque las intersecciones y las direcciones sin número no se pueden ubicar. Tome el conteo de proyectos cercanos como un mínimo. - **Predios solo en Hidalgo, por ahora.** Una dirección de Cameron, Starr o Willacy recibe un 400 gratis. Hidalgo no tiene mapa digital de zonas de inundación, así que la respuesta devuelve `no_digital_firm` y nunca afirma que el predio esté fuera de una zona inundable. Los valores llevan la fecha en que el condado actualizó sus registros; el año fiscal no está confirmado. Antes de pagar, `/api/v1/parcel/match` verifica gratis si una dirección tiene predio. - **Los dueños particulares no aparecen.** El registro de un predio muestra al dueño solo cuando es una empresa, una iglesia, un distrito escolar, una dependencia de gobierno u otra organización similar. - **El historial de empresas solo trae licencias de oficio.** En Texas no hay licencia para contratistas generales ni para constructores de vivienda, y a los plomeros los licencia otra junta. - **Los totales del año pueden no cuadrar.** En algunos lugares, el total de permisos en lo que va del año incluye reportes tardíos y correcciones que no aparecen en las filas mensuales. La respuesta indica cuáles son esos lugares. - **v1 se mantiene compatible.** Desde el 3 oct 2026, los cambios a v1 son solo adiciones: puede haber campos y endpoints nuevos, pero ninguno se renombra ni se elimina. Un cambio incompatible se publicaría con una versión nueva. [`/api/v1/changelog.json`](https://fronterasignal.com/api/v1/changelog.json) ## Documentación La documentación técnica está en inglés. Las ediciones semanales se pueden pedir en español con `lang=es`. - [`/api/v1`](https://fronterasignal.com/api/v1): el catálogo. Cada endpoint con su precio, parámetros, frecuencia, cobertura y una consulta de ejemplo. - [`/openapi.json`](https://fronterasignal.com/openapi.json): OpenAPI 3.1 con esquemas de respuesta, ejemplos reales y todos los códigos de error. - [`/.well-known/x402`](https://fronterasignal.com/.well-known/x402): archivo de descubrimiento x402, para directorios y mercados de agentes. - [`/llms.txt`](https://fronterasignal.com/llms.txt): una guía en texto plano del sitio y la API, para modelos de lenguaje. - `/mcp`: servidor MCP gratis para clientes de agentes: lista los endpoints, entrega las muestras y arma la llamada pagada. No cobra ni paga nada. - `/a2a`: agente A2A gratis (A2A 1.0, JSON RPC): nombre un endpoint o una ciudad del Valle y le responde con la URL pagada y su precio. No cobra ni paga nada. - [`/data/v1/samples/index.json`](https://fronterasignal.com/data/v1/samples/index.json): todas las muestras gratis en una lista. - [`/api/v1/health`](https://fronterasignal.com/api/v1/health) y [`/api/v1/changelog.json`](https://fronterasignal.com/api/v1/changelog.json): estado del servicio y el registro de cambios de v1. Preguntas sobre la API: [hello@fronterasignal.com](mailto:hello@fronterasignal.com) ## Datos gratis Los datos semanales de cada edición, gratis en formato JSON. Cada fila lleva fecha. Los archivos gratis traen las últimas 4 semanas de cada serie; los endpoints de series de pago traen el historial completo. [`/data/v1/index.json`](https://fronterasignal.com/data/v1/index.json) - JSON · semana 44 de 2026 · 465 filas ### Absorción e inventario Meses de inventario, días en el mercado y casas en venta por zona metropolitana. [`/data/v1/absorption.json`](https://fronterasignal.com/data/v1/absorption.json) - JSON · semana 44 de 2026 · 106 filas ### Registro de pronósticos Cada pronóstico con fecha y cómo resultó: acierto, fallo, empate o todavía abierto. [`/data/v1/calls.json`](https://fronterasignal.com/data/v1/calls.json) - JSON · semana 44 de 2026 · 465 filas ### Canasta de materiales Precio y tendencia semanal de madera para estructura, OSB, tablaroca, cobre, diésel y tasas hipotecarias. [`/data/v1/cost-basket-weekly.json`](https://fronterasignal.com/data/v1/cost-basket-weekly.json) - JSON · semana 30 de 2026 · 45 filas ### Mano de obra y capacidad Tiempos de obra y operativos en las obras del Valle en conjunto, sin datos por empresa. [`/data/v1/labor-ranges.json`](https://fronterasignal.com/data/v1/labor-ranges.json) - JSON · semana 44 de 2026 · 240 filas ### Permisos por ciudad y semana Conteos de permisos por ciudad y tipo. La semana aparece sin datos cuando la ciudad no publica cifras. [`/data/v1/permits-weekly.json`](https://fronterasignal.com/data/v1/permits-weekly.json) [Términos](https://fronterasignal.com/es/terms/)