Datos de negocio del Valle, por consulta

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=McAllensemanal y mensual · hasta la semana 44 de 2026
   $0.02por consultaMuestra gratis
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=5diaria · datos al 1 nov 2026
   $0.03por consultaMuestra gratis
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+districtdiaria · datos al 1 nov 2026
   $0.02por consultaMuestra gratis
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=2diaria · datos al 1 nov 2026
   $0.03por consultaMuestra gratis
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=McAllenlectura en vivo en cada consulta · datos al 11 feb 2026
   $0.04por consultaMuestra gratis
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=Hidalgodiaria · datos al 1 nov 2026
   $0.03por consultaMuestra gratis
7. Precios de materiales en tienda

   “¿Cuánto cuesta esta semana un tablero OSB de 7/16 en McAllen?”

   GET /api/v1/materials?item=osbdos veces por semana · datos al 29 oct 2026
   $0.01por consultaMuestra gratis
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-W44semanal · hasta la semana 44 de 2026
   $0.05por consultaMuestra gratis
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-01mensual · datos al 31 ago 2026
   $0.05por consultaMuestra gratis
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-W44semanal y mensual · hasta la semana 44 de 2026
    $0.05por consultaMuestra gratis
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-W44mensual · hasta la semana 44 de 2026
    $0.05por consultaMuestra gratis
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-W30mensual · 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.05por consultaMuestra gratis
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-W44semanal · hasta la semana 44 de 2026
    $0.05por consultaMuestra gratis
14. Edición semanal en JSON

    “¿Qué cambió esta semana en la construcción del Valle?”

    GET /api/v1/issue?week=2026-W37&lang=ensemanal · hasta la semana 44 de 2026
    $0.25por consultaMuestra gratis
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=commercialcada 15 minutos · datos al 26 oct 2026
    $0.01por consultaMuestra gratis
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=commercialdiaria · datos al 26 oct 2026
    $0.03por consultaMuestra gratis
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=trucksmensual · datos al 1 sep 2026
    $0.03por consultaMuestra gratis
18. Tipo de cambio del peso

    “¿Cuántos pesos compra un dólar y cómo se ha movido este mes?”

    GET /api/v1/pesodiaria · datos al 16 oct 2026
    $0.01por consultaMuestra gratis
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/dieselsemanal · datos al 19 oct 2026
    $0.01por consultaMuestra gratis
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=McAllenmensual · datos al 1 oct 2026
    $0.02por consultaMuestra gratis
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=10semanal · datos al 24 oct 2026
    $0.05por consultaMuestra gratis
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=10mensual · datos al 1 sep 2026
    $0.05por consultaMuestra gratis
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=4trimestral · datos al 21 oct 2026
    $0.03por consultaMuestra gratis
24. Panorama por industria

    “¿Qué cambió esta semana para la carga y las aduanas del Valle?”

    GET /api/v1/industry?industry=freightdiaria · datos al n/d
    $0.02por consultaMuestra gratis
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=enlectura en vivo en cada consulta · datos al n/d
    $0.25por consultaMuestra gratis

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

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

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: el catálogo. Cada endpoint con su precio, parámetros, frecuencia, cobertura y una consulta de ejemplo.
• /openapi.json: OpenAPI 3.1 con esquemas de respuesta, ejemplos reales y todos los códigos de error.
• /.well-known/x402: archivo de descubrimiento x402, para directorios y mercados de agentes.
• /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: todas las muestras gratis en una lista.
• /api/v1/health y /api/v1/changelog.json: estado del servicio y el registro de cambios de v1.

Preguntas sobre la API: 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

• 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

• 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

• 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

• 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

• 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

Términos