{"openapi":"3.1.0","info":{"title":"Frontera Signal API","version":"1.3.0","description":"Construction data for the Rio Grande Valley, Texas, paid per call: weekly permits, building-input prices, housing supply and labor for Hidalgo and Cameron counties; commercial projects, projects near an address, company track records with trade licenses, monthly housing permits and filed cost per square foot for Hidalgo, Cameron, Starr and Willacy; Hidalgo County parcel records; shelf prices for common building materials. Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/","termsOfService":"https://fronterasignal.com/terms/","contact":{"name":"Frontera Signal","email":"hello@fronterasignal.com","url":"https://fronterasignal.com/contact/"},"license":{"name":"Frontera Signal terms of use","url":"https://fronterasignal.com/terms/"},"x-guidance":"Frontera Signal sells Rio Grande Valley (South Texas) construction data per call over x402: USDC on Base, no account, no API key.\n1. Read the free catalog first: GET https://fronterasignal.com/api/v1 lists every paid endpoint, its price, what it returns, its parameters and a free sample.\n2. Free samples: https://fronterasignal.com/data/v1/samples/<endpoint>.json is one real answer per paid endpoint. https://fronterasignal.com/data/v1/index.json carries the latest 4 weeks of each weekly series.\n3. Call a paid endpoint without payment: it answers 402 with a JSON body (price, returns, sample, docs, how_to_pay) and a PAYMENT-REQUIRED header (base64 JSON, x402 v2). Sign and retry with a PAYMENT-SIGNATURE header; a 200 carries PAYMENT-RESPONSE with the settlement.\n4. Bad or unknown parameters get a free 400 and a valid query with nothing to return gets a free 404, before any payment, as {ok, error, message, docs, allowed}. allowed lists every parameter and its valid values. A payment is never settled on a 4xx or 5xx. nearby and parcel look the address up after the payment is verified, so an address they cannot place is a 404 that is not settled; GET /api/v1/parcel/match checks a parcel address for free first.\nWhich endpoint: one city or the whole Valley this week -> /api/v1/snapshot. New commercial projects with owner, cost and dates -> /api/v1/projects. Projects within a radius of an address -> /api/v1/nearby. A company track record and its trade licenses -> /api/v1/companies. The Hidalgo County parcel record for an address -> /api/v1/parcel. Filed cost per square foot by county and type of work -> /api/v1/cost-per-sqft. Shelf prices for building materials -> /api/v1/materials. Monthly housing permits by structure type -> /api/v1/series/permits-monthly. Weekly history of permits, input prices, housing supply, labor or forecast grades -> /api/v1/series/<name>. The written weekly issue -> /api/v1/issue.\nEvery value carries as_of, age_days, cadence and stale. dark and no_reading rows say a week has no reading; nothing is filled with guesses.\nMCP clients: https://fronterasignal.com/mcp (Streamable HTTP) serves the catalog, the free samples, the paid URL and price for your parameters and the free series as free, read-only tools.","x-mcp":{"url":"https://fronterasignal.com/mcp","transport":"streamable-http","price":"free","tools":["list_endpoints","get_sample","how_to_pay","get_free_series"],"about":"Free and read-only: the paid endpoints and prices, a real sample per endpoint, the exact paid URL for your parameters and the free latest-4-weeks series. Payment stays on the HTTP API."}},"servers":[{"url":"https://fronterasignal.com"}],"paths":{"/api/v1":{"get":{"operationId":"catalog","summary":"Free catalog: every paid endpoint, its price, parameters and free sample.","security":[],"responses":{"200":{"description":"Catalog.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/health":{"get":{"operationId":"health","summary":"Free health check. Never asks for payment.","security":[],"responses":{"200":{"description":"Up, with the newest week of data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"},"example":{"ok":true,"version":"1.3.0","data_through_week":"2026-W41","generated_at":"2026-10-11T13:00:53.197Z"}}}}}}},"/api/v1/changelog.json":{"get":{"operationId":"changelog","summary":"Free changelog of the v1 API.","security":[],"responses":{"200":{"description":"Changes, newest first.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/parcel/match":{"get":{"operationId":"parcel_match","summary":"Parcel match check","description":"Use before /api/v1/parcel so you only pay for addresses that match. Same parameters, same matching, no charge. Whether /api/v1/parcel finds one parcel for the address: match count, parcel id and situs. A miss is a 404 with no_match or ambiguous. Free, 20 lookups a minute per IP address.","security":[],"parameters":[{"name":"address","in":"query","required":true,"description":"Street address with house number, e.g. 800 S 10th St. A suite or unit is ignored.","schema":{"type":"string","minLength":5,"maxLength":120,"example":"800 S 10th St"}},{"name":"city","in":"query","required":true,"description":"A Hidalgo County city or town on the address, e.g. McAllen, Edinburg, Mission, Pharr, Weslaco. Other counties get a free 400.","schema":{"type":"string","enum":["Alamo","Alton","Donna","Edcouch","Edinburg","Elsa","Granjeno","Hargill","Hidalgo","La Joya","La Villa","Linn","McAllen","McCook","Mercedes","Mission","Monte Alto","Palmhurst","Palmview","Penitas","Pharr","Progreso","Progreso Lakes","San Carlos","San Juan","Sullivan City","Weslaco"],"example":"McAllen"}}],"responses":{"200":{"description":"One parcel (or several units of one address) matches.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"matched":{"type":"boolean"},"match_count":{"type":"integer"},"parcel_id":{"type":"string"},"parcel_ids":{"type":"array","items":{"type":"string"}},"situs":{"type":"string"},"matched_by":{"type":"string","enum":["situs_address","street_point_60m"]},"paid":{"type":"object"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many free checks from one IP address. Retry after the Retry-After header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/snapshot":{"get":{"operationId":"snapshot","summary":"City construction snapshot","description":"Use to size up the construction market in one Rio Grande Valley city (McAllen, Edinburg, Mission, Pharr, San Juan, Weslaco, Donna, Mercedes, Brownsville, Harlingen) or the whole Valley before you lend, build, buy or sell there: permits, housing units by type, sales-tax trend, months of supply, home values, input and material prices, mortgage rate, labor. Every value is dated. Example: \"Is McAllen's housing market oversupplied and are building costs rising this week?\"\n\nReturns: 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.\n\nFree sample (a real answer to /api/v1/snapshot?city=McAllen): https://fronterasignal.com/data/v1/samples/snapshot.json\n\nGET /api answers exactly like this endpoint: same parameters, same price, same answer.","externalDocs":{"description":"Free sample: a real answer to /api/v1/snapshot?city=McAllen","url":"https://fronterasignal.com/data/v1/samples/snapshot.json"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"security":[],"parameters":[{"name":"city","in":"query","required":false,"description":"A Valley city. Omit for the whole Valley.","schema":{"type":"string","enum":["McAllen","Edinburg","Mission","Pharr","San Juan","Weslaco","Donna","Mercedes","Brownsville","Harlingen"],"example":"McAllen"}}],"responses":{"200":{"description":"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.","content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string"},"place":{"type":"object","properties":{"city":{"type":"string"},"county":{"type":"string"},"metro":{"type":"string"},"region":{"type":"string"}},"required":[]},"data_through_week":{"type":"string"},"generated_at":{"type":"string"},"permits":{"type":"object","properties":{"latest_week":{"type":"string"},"latest":{"type":"array","items":{"type":"object","properties":{"week_id":{"type":"string"},"measure":{"type":"string"},"count":{"type":["integer","null"]},"status":{"type":"string"},"value_usd":{"type":["integer","null"]},"as_of":{"type":"string"},"age_days":{"type":"integer"},"cadence":{"type":"string"},"stale":{"type":"boolean"},"source":{"type":"string"},"city":{"type":"string"}},"required":["week_id","measure","count","status","value_usd","as_of","age_days","cadence","stale","source"]}},"history":{"type":"array","items":{"type":"object","properties":{"week_id":{"type":"string"},"measure":{"type":"string"},"count":{"type":["integer","null"]},"status":{"type":"string"},"value_usd":{"type":["integer","null"]},"as_of":{"type":"string"},"age_days":{"type":["integer","null"]},"cadence":{"type":"string"},"stale":{"type":"boolean"},"source":{"type":"string"},"backfill":{"type":"boolean"},"city":{"type":"string"}},"required":["week_id","measure","count","status","value_usd","as_of","age_days","cadence","stale","source"]}},"note":{"type":"string"}},"required":["latest_week","latest","history","note"]},"housing_supply":{"type":"array","items":{"type":"object","properties":{"geo":{"type":"string"},"measure":{"type":"string"},"value":{"anyOf":[{"type":"object","properties":{"low":{"type":"integer"},"high":{"type":"integer"},"unit":{"type":"string"}},"required":["low","high","unit"]},{"type":"number"}]},"unit":{"type":["string","null"]},"value_type":{"type":"string"},"value_text":{"type":"string"},"as_of":{"type":"string"},"age_days":{"type":"integer"},"cadence":{"type":"string"},"stale":{"type":"boolean"},"source":{"type":"string"}},"required":["geo","measure","value","unit","value_type","as_of","age_days","cadence","stale","source"]}},"construction_costs":{"type":"array","items":{"type":"object","properties":{"measure":{"type":"string"},"direction":{"type":["string","null"]},"direction_detail":{"type":"string"},"value":{"type":["number","null","string"]},"unit":{"type":["string","null"]},"value_type":{"type":["string","null"]},"approx":{"type":"boolean"},"value_text":{"type":"string"},"as_of":{"type":"string"},"age_days":{"type":"integer"},"cadence":{"type":"string"},"stale":{"type":"boolean"},"source":{"type":"string"}},"required":["measure","direction","value","unit","value_type","as_of","age_days","cadence","stale","source"]}},"labor":{"type":"array","items":{"type":"object","properties":{"measure":{"type":"string"},"value":{"anyOf":[{"type":"object","properties":{"low":{"type":"integer"},"high":{"type":"integer"},"unit":{"type":"string"}},"required":["low","high","unit"]},{"type":["string","integer"]}]},"unit":{"type":["string","null"]},"value_type":{"type":"string"},"value_text":{"type":"string"},"as_of":{"type":"string"},"age_days":{"type":"integer"},"cadence":{"type":"string"},"stale":{"type":"boolean"},"source":{"type":"string"}},"required":["measure","value","unit","value_type","as_of","age_days","cadence","stale","source"]}},"housing_permits_monthly":{"type":"object","properties":{"source":{"type":"string"},"latest":{"type":"array","items":{"type":"object","properties":{"place":{"type":"string"},"county":{"type":"string"},"month":{"type":"string"},"units_total":{"type":"integer"},"buildings_total":{"type":"integer"},"valuation_usd":{"type":"integer"},"single_family_units":{"type":"integer"},"two_unit_units":{"type":"integer"},"three_four_unit_units":{"type":"integer"},"five_plus_unit_units":{"type":"integer"},"single_family_buildings":{"type":"integer"},"two_unit_buildings":{"type":"integer"},"three_four_unit_buildings":{"type":"integer"},"five_plus_unit_buildings":{"type":"integer"},"status":{"type":"string"},"as_of":{"type":"string"},"age_days":{"type":"integer"},"cadence":{"type":"string"},"stale":{"type":"boolean"},"source":{"type":"string"},"places_reporting":{"type":"integer"}},"required":["county","month","units_total","buildings_total","valuation_usd","single_family_units","two_unit_units","three_four_unit_units","five_plus_unit_units","single_family_buildings","two_unit_buildings","three_four_unit_buildings","five_plus_unit_buildings","status","as_of","age_days","cadence","stale","source"]}},"note":{"type":"string"}},"required":["source","latest"]},"sales_tax":{"type":"object","properties":{"source":{"type":"string"},"latest":{"type":"array","items":{"type":"object","properties":{"city":{"type":"string"},"county":{"type":"string"},"month":{"type":"string"},"net_payment_usd":{"type":"number"},"prior_year_payment_usd":{"type":"number"},"yoy_pct":{"type":"number"},"payments_to_date_usd":{"type":"number"},"to_date_yoy_pct":{"type":"number"},"as_of":{"type":"string"},"age_days":{"type":"integer"},"cadence":{"type":"string"},"stale":{"type":"boolean"},"source":{"type":"string"}},"required":["city","county","month","net_payment_usd","prior_year_payment_usd","yoy_pct","payments_to_date_usd","to_date_yoy_pct","as_of","age_days","cadence","stale","source"]}},"note":{"type":"string"}},"required":["source","latest","note"]},"material_prices":{"type":"object","properties":{"source":{"type":"string"},"latest":{"type":"array","items":{"type":"object","properties":{"item_key":{"type":"string"},"item":{"type":"string"},"low_usd":{"type":"number"},"high_usd":{"type":"number"},"unit":{"type":"string"},"stores":{"type":"integer"},"as_of":{"type":"string"},"age_days":{"type":"integer"},"cadence":{"type":"string"},"stale":{"type":"boolean"},"source":{"type":"string"}},"required":["item_key","item","low_usd","high_usd","unit","stores","as_of","age_days","cadence","stale","source"]}},"note":{"type":"string"}},"required":["source","latest","note"]},"new_commercial_projects":{"type":"object","properties":{"source":{"type":"string"},"as_of":{"type":"string"},"cadence":{"type":"string"},"matched":{"type":"integer"},"latest":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"facility":{"type":"string"},"address":{"type":"string"},"city":{"type":"string"},"county":{"type":"string"},"zip":{"type":"string"},"owner":{"type":"string"},"design_firm":{"type":["null","string"]},"estimated_cost_usd":{"type":"integer"},"square_feet":{"type":"integer"},"estimated_start":{"type":"string"},"estimated_end":{"type":"string"},"status":{"type":"string"},"type_of_work":{"type":"string"},"scope_of_work":{"type":"string"},"funding":{"type":"string"},"registered":{"type":"string"},"source":{"type":"string"}},"required":["id","name","facility","address","city","county","zip","owner","design_firm","estimated_cost_usd","square_feet","estimated_start","estimated_end","status","type_of_work","scope_of_work","funding","registered","source"]}}},"required":["source","as_of","cadence","matched","latest"]},"latest_issue":{"type":"object","properties":{"week_id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"}},"required":["week_id","title","url"]},"disclaimer":{"type":"string"}},"required":["publisher","place","data_through_week","generated_at","permits","housing_supply","construction_costs","labor","housing_permits_monthly","sales_tax","material_prices","new_commercial_projects","latest_issue","disclaimer"]},"example":{"publisher":"Frontera Signal","place":{"city":"McAllen","county":"Hidalgo County, Texas","metro":"McAllen-Edinburg-Mission"},"data_through_week":"2026-W41","generated_at":"2026-10-11T13:00:53.197Z","permits":{"latest_week":"2026-W41","latest":[{"week_id":"2026-W41","measure":"commercial_projects_registered_state","count":4,"status":"reported","value_usd":4356932,"as_of":"2026-10-09","age_days":2,"cadence":"weekly","stale":false,"source":"Frontera Signal"},{"week_id":"2026-W41","measure":"housing_units_authorized_metro","count":431,"status":"reported","value_usd":null,"as_of":"2026-08","age_days":41,"cadence":"monthly","stale":false,"source":"Frontera Signal"}],"history":[{"week_id":"2026-W40","measure":"commercial_projects_registered_state","count":1,"status":"reported","value_usd":300000,"as_of":"2026-09-28","age_days":13,"cadence":"weekly","stale":false,"source":"Frontera Signal"},{"week_id":"2026-W40","measure":"housing_units_authorized_metro","count":431,"status":"reported","value_usd":null,"as_of":"2026-08","age_days":41,"cadence":"monthly","stale":false,"source":"Frontera Signal"},{"week_id":"2026-W39","measure":"commercial_projects_registered_state","count":3,"status":"reported","value_usd":null,"as_of":"2026-09-25","age_days":16,"cadence":"weekly","stale":true,"source":"Frontera Signal"}],"note":"Reported rows first. dark = the city published nothing that week; no_reading = we have no reading for that city that week. Counts are what each city or the state made public; not every city reports every class."},"housing_supply":[{"geo":"McAllen","measure":"entry_price_per_sqft","value":{"low":186,"high":190,"unit":"USD/sqft"},"unit":"USD/sqft","value_type":"range","value_text":"186-190","as_of":"2026-07","age_days":72,"cadence":"monthly","stale":false,"source":"Frontera Signal"},{"geo":"McAllen-Edinburg-Mission","measure":"active_listings","value":3200,"unit":null,"value_type":"number","as_of":"2026-07-31","age_days":72,"cadence":"monthly","stale":false,"source":"Frontera Signal"},{"geo":"McAllen-Edinburg-Mission","measure":"closed_sales","value":405,"unit":null,"value_type":"number","as_of":"2026-07-31","age_days":72,"cadence":"monthly","stale":false,"source":"Frontera Signal"}],"construction_costs":[{"measure":"framing_lumber","direction":"up","direction_detail":"up_futures","value":578.5,"unit":"USD/MBF","value_type":"number","approx":true,"value_text":"~578.50","as_of":"2026-09-11","age_days":30,"cadence":"weekly","stale":true,"source":"Frontera Signal"},{"measure":"osb_7_16_sheet","direction":"flat","value":13.48,"unit":"USD/sheet","value_type":"number","as_of":"2026-09-24","age_days":17,"cadence":"weekly","stale":true,"source":"Frontera Signal"},{"measure":"mortgage_rate_30y_fixed","direction":"up","value":7.4,"unit":"pct","value_type":"number","as_of":"2026-10-08","age_days":3,"cadence":"weekly","stale":false,"source":"Freddie Mac"}],"labor":[{"measure":"build_time_2100sf","value":{"low":9,"high":11,"unit":"months"},"unit":"months","value_type":"range","value_text":"9-11 months","as_of":"2026-07","age_days":72,"cadence":"monthly","stale":false,"source":"Frontera Signal"},{"measure":"enforcement_climate","value":"elevated","unit":null,"value_type":"category","as_of":"2026-07-24","age_days":79,"cadence":"monthly","stale":false,"source":"Frontera Signal"},{"measure":"construction_loans_rgv","value":-30,"unit":"pct vs 2025","value_type":"number","value_text":"-30pct vs 2025","as_of":"2026-01","age_days":253,"cadence":"monthly","stale":true,"source":"Frontera Signal"}],"housing_permits_monthly":{"source":"public permit statistics","latest":[{"place":"McAllen","county":"Hidalgo","month":"2026-08","units_total":66,"buildings_total":54,"valuation_usd":11374705,"single_family_units":42,"two_unit_units":24,"three_four_unit_units":0,"five_plus_unit_units":0,"single_family_buildings":42,"two_unit_buildings":12,"three_four_unit_buildings":0,"five_plus_unit_buildings":0,"status":"reported","as_of":"2026-08-31","age_days":41,"cadence":"monthly","stale":false,"source":"public permit statistics"}]},"sales_tax":{"source":"state sales tax allocation records","latest":[{"city":"McAllen","county":"Hidalgo","month":"2026-09","net_payment_usd":8646783.48,"prior_year_payment_usd":7978565.44,"yoy_pct":8.37,"payments_to_date_usd":81419238.95,"to_date_yoy_pct":7.78,"as_of":"2026-09-30","age_days":11,"cadence":"monthly","stale":false,"source":"state sales tax allocation records"}],"note":"Local sales tax the state sent the city in that month; a payment mostly reflects sales made two months earlier. yoy_pct compares with the same month a year before; payments_to_date_usd and to_date_yoy_pct run from January."},"material_prices":{"source":"Frontera Signal","latest":[{"item_key":"stud_2x4_8ft","item":"2x4 stud, 8 ft","low_usd":3.98,"high_usd":3.98,"unit":"each","stores":1,"as_of":"2026-10-01","age_days":10,"cadence":"weekly","stale":false,"source":"Frontera Signal"},{"item_key":"osb_7_16_4x8","item":"OSB 7/16 in, 4x8 sheet","low_usd":13.48,"high_usd":13.48,"unit":"sheet","stores":1,"as_of":"2026-10-01","age_days":10,"cadence":"weekly","stale":false,"source":"Frontera Signal"},{"item_key":"drywall_1_2_4x8","item":"Drywall 1/2 in, 4x8 sheet","low_usd":14.98,"high_usd":14.98,"unit":"sheet","stores":1,"as_of":"2026-10-01","age_days":10,"cadence":"weekly","stale":false,"source":"Frontera Signal"}],"note":"Shelf prices at Valley big-box stores and a local yard on the newest day each item was checked; low and high across the stores that priced it that day. /api/v1/materials has every store and item. Not a quote."},"new_commercial_projects":{"source":"public state construction filing","as_of":"2026-10-11","cadence":"weekly","matched":315,"latest":[{"id":"FSP-0b184f904d","name":"Urgent Care Facilities","facility":"Las Arboledas Office Park","address":"6316 N 10th Street, Building C1","city":"McAllen","county":"Hidalgo","zip":"78504","owner":"AAC Medical Properties, LLC","design_firm":null,"estimated_cost_usd":412000,"square_feet":5133,"estimated_start":"2026-08-24","estimated_end":"2027-02-12","status":"Project Registered","type_of_work":"Renovation/Alteration","scope_of_work":"Shown in new floor plan","funding":"private","registered":"2026-10-08","source":"public state construction filing"},{"id":"FSP-806786d275","name":"GOMEZ CARDIOVASCULAR CLINIC","facility":"LINDBERG CENTER CONDOMINIUMS","address":"212 LINDBERG BUILDING A UNIT 1","city":"McAllen","county":"Hidalgo","zip":"78501","owner":"VELOCITY TRIPLE J","design_firm":"G.D. DRAFTING & DESIGNS","estimated_cost_usd":165980,"square_feet":3192,"estimated_start":"2026-10-19","estimated_end":"2027-02-26","status":"Review Complete","type_of_work":"Renovation/Alteration","scope_of_work":"Renovation of commercial unit","funding":"private","registered":"2026-10-01","source":"public state construction filing"},{"id":"FSP-de511b28b3","name":"SH 336 (CSJ: 0921-00-092)","facility":"CSJ: 0921-00-092","address":"From: Tamarack Ave To: Fern Ave","city":"McAllen","county":"Hidalgo","zip":"78501","owner":"TxDOT District: Pharr","design_firm":"Pape-Dawson Engineers, Inc.","estimated_cost_usd":1778952,"square_feet":77729,"estimated_start":"2027-09-03","estimated_end":"2028-06-03","status":"Review Complete","type_of_work":"New Construction","scope_of_work":"For the construction of pedestrian sidewalks and curb ramps consisting of pedestrian infrastructure.","funding":"public","registered":"2026-09-29","source":"public state construction filing"}]},"latest_issue":{"week_id":"2026-W41","title":"Mortgage rate climbs to 7.40% as Hakes cuts unsold Valley homes","url":"https://fronterasignal.com/issues/2026-w41/"},"disclaimer":"Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"description":"Payment required. Free of charge to receive. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists price, network, asset and payTo; retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON payment requirements (x402 v2).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"example":{"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"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/projects":{"get":{"operationId":"projects","summary":"New commercial projects","description":"Use to find who is about to build what in the Rio Grande Valley, Texas (Hidalgo, Cameron, Starr, Willacy counties): commercial projects over $50,000 filed with the state before construction, with owner, design firm, estimated cost, square feet and dates. For suppliers, subcontractors, lenders and brokers chasing new work. Filter by city, county, since, min_cost or owner. Example: \"What commercial projects were registered in Hidalgo County since Sept 1, who owns them and how big are they?\"\n\nReturns: Commercial projects filed with the state before they build: name, address, owner, design firm, estimated cost, square feet, start and end dates, newest first.\n\nFree sample (a real answer to /api/v1/projects?city=McAllen&limit=5): https://fronterasignal.com/data/v1/samples/projects.json","externalDocs":{"description":"Free sample: a real answer to /api/v1/projects?city=McAllen&limit=5","url":"https://fronterasignal.com/data/v1/samples/projects.json"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"network":"eip155:8453","asset":"USDC"},"security":[],"parameters":[{"name":"city","in":"query","required":false,"description":"A Valley city with filed projects.","schema":{"type":"string","enum":["Alamo","Alton","Austin","Brownsville","Cameron","Combes","Corpus Christi","Donna","Edcouch","Edinburg","Elsa","Georgetown","Harlingen","Hidalgo","La Feria","La Joya","La Villa","Laguna Heights","Laguna Vista","Leander","Los Fresnos","Lyford","McAllen","Mercedes","Mission","Olmito","Palmhurst","Palmview","Penitas","Pharr","Port Isabel","Port Mansfield","Primera","Progreso","Rancho Viejo","Raymondville","Rio Grande City","Rio Hondo","Roma","San Antonio","San Benito","San Juan","San Perlita","Santa Maria","Santa Rosa","South Padre Island","Starbase","Unknown","Von Ormy","Weslaco"],"example":"McAllen"}},{"name":"county","in":"query","required":false,"description":"Hidalgo, Cameron, Starr or Willacy (\"Hidalgo County\" also works).","schema":{"type":"string","enum":["Hidalgo","Cameron","Starr","Willacy"],"example":"Hidalgo"}},{"name":"since","in":"query","required":false,"description":"Registered on or after this date, YYYY-MM-DD.","schema":{"type":"string","format":"date","example":"2026-09-01"}},{"name":"min_cost","in":"query","required":false,"description":"Minimum filed cost in US dollars; projects with no cost filed are left out.","schema":{"type":"number","minimum":0,"example":250000}},{"name":"owner","in":"query","required":false,"description":"Part of the owner name, case-insensitive.","schema":{"type":"string","minLength":3,"maxLength":80,"example":"school"}},{"name":"limit","in":"query","required":false,"description":"How many projects to return, 1-100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"example":5}}],"responses":{"200":{"description":"Commercial projects filed with the state before they build: name, address, owner, design firm, estimated cost, square feet, start and end dates, newest first.","content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string"},"dataset":{"type":"string"},"query":{"type":"object","properties":{"limit":{"type":"integer"},"city":{"type":"string"},"county":{"type":"string"}},"required":["limit"]},"source":{"type":"string"},"as_of":{"type":"string"},"cadence":{"type":"string"},"coverage":{"type":"object","properties":{"counties":{"type":"array","items":{"type":"string"}},"registered_since":{"type":"string"}},"required":["counties","registered_since"]},"matched":{"type":"integer"},"returned":{"type":"integer"},"projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"facility":{"type":"string"},"address":{"type":"string"},"city":{"type":"string"},"county":{"type":"string"},"zip":{"type":"string"},"owner":{"type":"string"},"design_firm":{"type":["null","string"]},"estimated_cost_usd":{"type":"integer"},"square_feet":{"type":"integer"},"estimated_start":{"type":"string"},"estimated_end":{"type":"string"},"status":{"type":"string"},"type_of_work":{"type":"string"},"scope_of_work":{"type":"string"},"funding":{"type":"string"},"registered":{"type":"string"},"source":{"type":"string"}},"required":["id","name","facility","address","city","county","zip","owner","design_firm","estimated_cost_usd","square_feet","estimated_start","estimated_end","status","type_of_work","scope_of_work","funding","registered","source"]}},"note":{"type":"string"},"disclaimer":{"type":"string"}},"required":["publisher","dataset","query","source","as_of","cadence","coverage","matched","returned","projects","note","disclaimer"]},"example":{"publisher":"Frontera Signal","dataset":"projects","query":{"limit":5,"city":"McAllen"},"source":"public state construction filing","as_of":"2026-10-11","cadence":"weekly","coverage":{"counties":["Cameron","Hidalgo","Starr","Willacy"],"registered_since":"2024-10-01"},"matched":315,"returned":5,"projects":[{"id":"FSP-0b184f904d","name":"Urgent Care Facilities","facility":"Las Arboledas Office Park","address":"6316 N 10th Street, Building C1","city":"McAllen","county":"Hidalgo","zip":"78504","owner":"AAC Medical Properties, LLC","design_firm":null,"estimated_cost_usd":412000,"square_feet":5133,"estimated_start":"2026-08-24","estimated_end":"2027-02-12","status":"Project Registered","type_of_work":"Renovation/Alteration","scope_of_work":"Shown in new floor plan","funding":"private","registered":"2026-10-08","source":"public state construction filing"},{"id":"FSP-806786d275","name":"GOMEZ CARDIOVASCULAR CLINIC","facility":"LINDBERG CENTER CONDOMINIUMS","address":"212 LINDBERG BUILDING A UNIT 1","city":"McAllen","county":"Hidalgo","zip":"78501","owner":"VELOCITY TRIPLE J","design_firm":"G.D. DRAFTING & DESIGNS","estimated_cost_usd":165980,"square_feet":3192,"estimated_start":"2026-10-19","estimated_end":"2027-02-26","status":"Review Complete","type_of_work":"Renovation/Alteration","scope_of_work":"Renovation of commercial unit","funding":"private","registered":"2026-10-01","source":"public state construction filing"},{"id":"FSP-de511b28b3","name":"SH 336 (CSJ: 0921-00-092)","facility":"CSJ: 0921-00-092","address":"From: Tamarack Ave To: Fern Ave","city":"McAllen","county":"Hidalgo","zip":"78501","owner":"TxDOT District: Pharr","design_firm":"Pape-Dawson Engineers, Inc.","estimated_cost_usd":1778952,"square_feet":77729,"estimated_start":"2027-09-03","estimated_end":"2028-06-03","status":"Review Complete","type_of_work":"New Construction","scope_of_work":"For the construction of pedestrian sidewalks and curb ramps consisting of pedestrian infrastructure.","funding":"public","registered":"2026-09-29","source":"public state construction filing"}],"note":"Newest filing first. Estimated cost, square feet and dates are what the owner filed with the state; null = not filed. min_cost leaves out projects with no cost filed.","disclaimer":"Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"description":"Payment required. Free of charge to receive. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists price, network, asset and payTo; retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON payment requirements (x402 v2).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"example":{"error":"payment_required","price":"$0.03","returns":"Commercial projects filed with the state before they build: name, address, owner, design firm, estimated cost, square feet, start and end dates, newest first.","sample":"https://fronterasignal.com/data/v1/samples/projects.json","docs":"https://fronterasignal.com/openapi.json","how_to_pay":"x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/companies":{"get":{"operationId":"companies","summary":"Company track record","description":"Use to vet a developer, owner, architecture firm or trade contractor in the Rio Grande Valley, Texas: projects filed since late 2024 (count, total and largest cost, cities, dates, newest projects) and state trade licenses held by the business (A/C, electrical, sign, elevator), current or expired. Pass part of the name (3+ characters). No match is a free 404. Example: \"How many projects has this developer filed in the Valley since 2024, and how large was the biggest one?\"\n\nReturns: For each matching owner, design firm or licensed contractor business: project count, total and largest filed cost, cities, first and last filing, its 10 newest projects and its state trade licenses (type, current or expired, expiry, county).\n\nFree sample (a real answer to /api/v1/companies?name=independent+school+district): https://fronterasignal.com/data/v1/samples/companies.json","externalDocs":{"description":"Free sample: a real answer to /api/v1/companies?name=independent+school+district","url":"https://fronterasignal.com/data/v1/samples/companies.json"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"security":[],"parameters":[{"name":"name","in":"query","required":true,"description":"Part of an owner or design-firm name, case-insensitive.","schema":{"type":"string","minLength":3,"maxLength":80,"example":"independent school district"}}],"responses":{"200":{"description":"For each matching owner, design firm or licensed contractor business: project count, total and largest filed cost, cities, first and last filing, its 10 newest projects and its state trade licenses (type, current or expired, expiry, county).","content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string"},"dataset":{"type":"string"},"query":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"source":{"type":"string"},"as_of":{"type":"string"},"cadence":{"type":"string"},"coverage":{"type":"object","properties":{"counties":{"type":"array","items":{"type":"string"}},"registered_since":{"type":"string"}},"required":["counties","registered_since"]},"licenses_source":{"type":"string"},"licenses_as_of":{"type":"string"},"status_checked":{"type":"string"},"matched_names":{"type":"integer"},"companies":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"role":{"type":"string"},"project_count":{"type":"integer"},"total_estimated_cost_usd":{"type":"integer"},"largest_project_cost_usd":{"type":["integer","null"]},"projects_with_cost":{"type":"integer"},"cities":{"type":"array","items":{"type":"string"}},"counties":{"type":"array","items":{"type":"string"}},"first_seen":{"type":["string","null"]},"last_seen":{"type":["string","null"]},"latest_projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"facility":{"type":"string"},"address":{"type":"string"},"city":{"type":"string"},"county":{"type":"string"},"zip":{"type":"string"},"owner":{"type":"string"},"design_firm":{"type":["string","null"]},"estimated_cost_usd":{"type":"integer"},"square_feet":{"type":"integer"},"estimated_start":{"type":"string"},"estimated_end":{"type":"string"},"status":{"type":"string"},"type_of_work":{"type":"string"},"scope_of_work":{"type":"string"},"funding":{"type":"string"},"registered":{"type":"string"},"source":{"type":"string"}},"required":["id","name","facility","address","city","county","zip","owner","design_firm","estimated_cost_usd","square_feet","estimated_start","estimated_end","status","type_of_work","scope_of_work","funding","registered","source"]}},"licenses":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"license_type":{"type":"string"},"status":{"type":"string"},"expires":{"type":"string"},"county":{"type":"string"}},"required":["name","license_type","status","expires","county"]}}},"required":["name","role","project_count","total_estimated_cost_usd","largest_project_cost_usd","projects_with_cost","cities","counties","first_seen","last_seen","latest_projects","licenses"]}},"note":{"type":"string"},"license_note":{"type":"string"},"disclaimer":{"type":"string"}},"required":["publisher","dataset","query","source","as_of","cadence","coverage","licenses_source","licenses_as_of","status_checked","matched_names","companies","note","license_note","disclaimer"]},"example":{"publisher":"Frontera Signal","dataset":"companies","query":{"name":"independent school district"},"source":"public state construction filing","as_of":"2026-10-11","cadence":"weekly","coverage":{"counties":["Cameron","Hidalgo","Starr","Willacy"],"registered_since":"2024-10-01"},"licenses_source":"state license records","licenses_as_of":"2026-09-19","status_checked":"2026-10-11","matched_names":10,"companies":[{"name":"Weslaco Independent School District","role":"owner","project_count":9,"total_estimated_cost_usd":3487542,"largest_project_cost_usd":2216000,"projects_with_cost":9,"cities":["Weslaco"],"counties":["Hidalgo"],"first_seen":"2025-05-09","last_seen":"2025-12-09","latest_projects":[{"id":"FSP-d28b5d37e3","name":"Weslaco ISD-Security Vestibule at Joe Calvillo Cate Center","facility":"Joe Calvillo Cate Center","address":"3601 N. Mile 5 1/2 W.","city":"Weslaco","county":"Hidalgo","zip":"78596","owner":"Weslaco Independent School District","design_firm":"Sam Garcia Architects","estimated_cost_usd":100000,"square_feet":100,"estimated_start":"2025-12-01","estimated_end":"2026-02-01","status":"Review Complete","type_of_work":"Renovation/Alteration","scope_of_work":"New Storefront Installation enclosing a new security vestibule within the existing lobby area.","funding":"public","registered":"2025-12-09","source":"public state construction filing"},{"id":"FSP-c736879179","name":"Weslaco ISD-Security Vestibule at Central Middle School","facility":"Central Middle School","address":"503 E. 6th St.","city":"Weslaco","county":"Hidalgo","zip":"78596","owner":"Weslaco Independent School District","design_firm":"Sam Garcia Architects","estimated_cost_usd":100000,"square_feet":500,"estimated_start":"2025-10-01","estimated_end":"2026-04-01","status":"Review Complete","type_of_work":"Renovation/Alteration","scope_of_work":"New Storefront Installation enclosing a new security vestibule within the existing area of lobby.","funding":"public","registered":"2025-08-26","source":"public state construction filing"},{"id":"FSP-71f904db3e","name":"Weslaco ISD-Security Vestibule at Airport Elementary","facility":"Airport Elementary","address":"410 N. Airport Dr.","city":"Weslaco","county":"Hidalgo","zip":"78596","owner":"Weslaco Independent School District","design_firm":"Sam Garcia Architects","estimated_cost_usd":250000,"square_feet":800,"estimated_start":"2025-10-01","estimated_end":"2026-04-01","status":"Review Complete","type_of_work":"Renovation/Alteration","scope_of_work":"New 800 sf. Enclosed Security Vestibule and Reception Area","funding":"public","registered":"2025-08-26","source":"public state construction filing"}],"licenses":[]},{"name":"Donna Independent School District","role":"owner","project_count":8,"total_estimated_cost_usd":21864000,"largest_project_cost_usd":20000000,"projects_with_cost":8,"cities":["Alamo","Donna"],"counties":["Hidalgo"],"first_seen":"2024-10-16","last_seen":"2026-09-17","latest_projects":[{"id":"FSP-ffc6a9ca05","name":"Cool Schools Rio Grande Valley","facility":"M. RIVAS & J.W. CACERES ELEMENTARY SCHOOLS","address":"503 S Hutto Rd","city":"Donna","county":"Hidalgo","zip":"78537","owner":"Donna Independent School District","design_firm":"Studio Outside","estimated_cost_usd":466000,"square_feet":137265,"estimated_start":"2026-09-30","estimated_end":"2027-04-30","status":"Review Complete","type_of_work":"Additions to Existing Building","scope_of_work":"Plantings, Trees, Irrigation, exterior furniture, trails, nature learning space & signage,","funding":"public","registered":"2026-09-17","source":"public state construction filing"},{"id":"FSP-f5c9c919b5","name":"Cool Schools Rio Grande Valley","facility":"CAPTAIN D. SALINAS II STEAM ACADEMY","address":"333 US-83 Business","city":"Alamo","county":"Hidalgo","zip":"78516","owner":"Donna Independent School District","design_firm":"Studio Outside","estimated_cost_usd":233000,"square_feet":163370,"estimated_start":"2026-09-30","estimated_end":"2027-04-30","status":"Review Complete","type_of_work":"Additions to Existing Building","scope_of_work":"Plantings, Trees, Irrigation, exterior furniture, trails, nature learning space & signage,","funding":"public","registered":"2026-09-17","source":"public state construction filing"},{"id":"FSP-cea314fc2b","name":"Cool Schools Rio Grande Valley","facility":"A.M. OCHOA PRIMARY SCIENCE & SPORTS ACADEMY","address":"424 S 11th St,","city":"Donna","county":"Hidalgo","zip":"78537","owner":"Donna Independent School District","design_firm":"Studio Outside","estimated_cost_usd":233000,"square_feet":68435,"estimated_start":"2026-09-30","estimated_end":"2027-04-30","status":"Review Complete","type_of_work":"Additions to Existing Building","scope_of_work":"Plantings, Trees, Irrigation, exterior furniture, trails, nature learning space & signage,","funding":"public","registered":"2026-09-17","source":"public state construction filing"}],"licenses":[]},{"name":"Mercedes Independent School District","role":"owner","project_count":6,"total_estimated_cost_usd":1398000,"largest_project_cost_usd":233000,"projects_with_cost":6,"cities":["Mercedes"],"counties":["Hidalgo"],"first_seen":"2026-09-16","last_seen":"2026-09-17","latest_projects":[{"id":"FSP-d51b84b5c5","name":"Cool Schools Rio Grande Valley","facility":"MERCEDES ACADEMIC ACADEMY","address":"719 S Mile 1 E","city":"Mercedes","county":"Hidalgo","zip":"78570","owner":"Mercedes Independent School District","design_firm":"Studio Outside","estimated_cost_usd":233000,"square_feet":52860,"estimated_start":"2026-09-30","estimated_end":"2027-04-30","status":"Project Registered","type_of_work":"Additions to Existing Building","scope_of_work":"Plantings, Trees, Irrigation, exterior furniture, trails, nature learning space & signage,","funding":"public","registered":"2026-09-17","source":"public state construction filing"},{"id":"FSP-735880c1d2","name":"Cool Schools Rio Grande Valley","facility":"MERCEDES HIGH SCHOOL","address":"1200 Florida Ave","city":"Mercedes","county":"Hidalgo","zip":"78570","owner":"Mercedes Independent School District","design_firm":"Studio Outside","estimated_cost_usd":233000,"square_feet":47680,"estimated_start":"2026-09-30","estimated_end":"2027-04-30","status":"Review Complete","type_of_work":"Additions to Existing Building","scope_of_work":"Plantings, Trees, Irrigation, exterior furniture, trails, nature learning space & signage,","funding":"public","registered":"2026-09-17","source":"public state construction filing"},{"id":"FSP-514ad84fde","name":"Cool Schools Rio Grande Valley","facility":"RUBEN HINOJOSA ELEMENTARY SCHOOL","address":"500 Rio Rico Rd","city":"Mercedes","county":"Hidalgo","zip":"78570","owner":"Mercedes Independent School District","design_firm":"Studio Outside","estimated_cost_usd":233000,"square_feet":45118,"estimated_start":"2026-09-30","estimated_end":"2027-04-30","status":"Project Registered","type_of_work":"Additions to Existing Building","scope_of_work":"Plantings, Trees, Irrigation, exterior furniture, trails, nature learning space & signage,","funding":"public","registered":"2026-09-17","source":"public state construction filing"}],"licenses":[]}],"note":"Public-record activity: projects filed with the state where the company is the owner or the design firm, up to 10 names with the most projects first, then up to 10 licensed businesses (role licensed_business) whose name matches but that filed no project we hold. Costs are the estimates owners filed, summed as filed; check largest_project_cost_usd for a single filing that dominates the total.","license_note":"licenses are state trade licenses held by the business: air conditioning, electrical, electrical sign, elevator and appliance installation contractors, matched on the business name with punctuation and LLC, Inc and similar dropped. Texas does not license general contractors or home builders, and plumbers are licensed by a separate board, so a builder or plumber with no license here is normal. sta…","disclaimer":"Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"description":"Payment required. Free of charge to receive. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists price, network, asset and payTo; retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON payment requirements (x402 v2).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"example":{"error":"payment_required","price":"$0.02","returns":"For each matching owner, design firm or licensed contractor business: project count, total and largest filed cost, cities, first and last filing, its 10 newest projects and its state trade licenses (type, current or expired, expiry, county).","sample":"https://fronterasignal.com/data/v1/samples/companies.json","docs":"https://fronterasignal.com/openapi.json","how_to_pay":"x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/nearby":{"get":{"operationId":"nearby","summary":"Projects near an address","description":"Use to size competing or neighboring construction around one Rio Grande Valley address before you buy, lend, lease or build there: count, summed filed cost and each commercial project within radius_mi (default 1, max 5), nearest first. Hidalgo, Cameron, Starr and Willacy counties; about 68% of filings have a map point. An address we cannot place is a free 404. Example: \"How many commercial projects were filed within two miles of 1201 E Capote Central Ave, Pharr, and what are they worth?\"\n\nReturns: Filed commercial projects within a radius of a Valley street address: how many, their summed and largest filed cost, a split by type of work, and each project with its distance and map point, nearest first.\n\nFree sample (a real answer to /api/v1/nearby?address=1201+E+Capote+Central+Ave&city=Pharr&radius_mi=2): https://fronterasignal.com/data/v1/samples/nearby.json","externalDocs":{"description":"Free sample: a real answer to /api/v1/nearby?address=1201+E+Capote+Central+Ave&city=Pharr&radius_mi=2","url":"https://fronterasignal.com/data/v1/samples/nearby.json"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"network":"eip155:8453","asset":"USDC"},"security":[],"parameters":[{"name":"address","in":"query","required":true,"description":"Street address with house number, e.g. 800 S 10th St. A suite or unit is ignored.","schema":{"type":"string","minLength":5,"maxLength":120,"example":"800 S 10th St"}},{"name":"city","in":"query","required":true,"description":"The city or town on the address, e.g. McAllen, Brownsville, Rio Grande City.","schema":{"type":"string","minLength":2,"maxLength":40,"example":"McAllen"}},{"name":"radius_mi","in":"query","required":false,"description":"Radius in miles, 0.1 to 5. Default 1.","schema":{"type":"number","minimum":0.1,"maximum":5,"default":1,"example":1}}],"responses":{"200":{"description":"Filed commercial projects within a radius of a Valley street address: how many, their summed and largest filed cost, a split by type of work, and each project with its distance and map point, nearest first.","content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string"},"dataset":{"type":"string"},"query":{"type":"object","properties":{"address":{"type":"string"},"city":{"type":"string"},"radius_mi":{"type":"integer"}},"required":["address","city","radius_mi"]},"location":{"type":"object","properties":{"matched_address":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"},"county":{"type":"string"},"placed_by":{"type":"string"}},"required":["matched_address","lat","lon","county","placed_by"]},"radius_mi":{"type":"integer"},"source":{"type":"string"},"as_of":{"type":"string"},"cadence":{"type":"string"},"coverage":{"type":"object","properties":{"counties":{"type":"array","items":{"type":"string"}},"registered_since":{"type":"string"},"filings":{"type":"integer"},"located":{"type":"integer"},"located_pct":{"type":"number"},"note":{"type":"string"}},"required":["counties","registered_since","filings","located","located_pct","note"]},"count":{"type":"integer"},"total_estimated_cost_usd":{"type":"integer"},"projects_with_cost":{"type":"integer"},"largest_project_cost_usd":{"type":"integer"},"newest_registration":{"type":"string"},"by_type_of_work":{"type":"array","items":{"type":"object","properties":{"type_of_work":{"type":"string"},"count":{"type":"integer"},"total_estimated_cost_usd":{"type":"integer"}},"required":["type_of_work","count","total_estimated_cost_usd"]}},"returned":{"type":"integer"},"projects":{"type":"array","items":{"type":"object","properties":{"distance_mi":{"type":"number"},"id":{"type":"string"},"name":{"type":"string"},"facility":{"type":"string"},"address":{"type":"string"},"city":{"type":"string"},"county":{"type":"string"},"zip":{"type":"string"},"owner":{"type":"string"},"design_firm":{"type":["null","string"]},"estimated_cost_usd":{"type":"integer"},"square_feet":{"type":"integer"},"estimated_start":{"type":"string"},"estimated_end":{"type":"string"},"status":{"type":"string"},"type_of_work":{"type":"string"},"scope_of_work":{"type":"string"},"funding":{"type":"string"},"registered":{"type":"string"},"source":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"},"geo_precision":{"type":"string"}},"required":["distance_mi","id","name","facility","address","city","county","zip","owner","design_firm","estimated_cost_usd","square_feet","estimated_start","estimated_end","status","type_of_work","scope_of_work","funding","registered","source","lat","lon","geo_precision"]}},"note":{"type":"string"},"disclaimer":{"type":"string"}},"required":["publisher","dataset","query","location","radius_mi","source","as_of","cadence","coverage","count","total_estimated_cost_usd","projects_with_cost","largest_project_cost_usd","newest_registration","by_type_of_work","returned","projects","note","disclaimer"]},"example":{"publisher":"Frontera Signal","dataset":"nearby","query":{"address":"1201 E Capote Central Ave","city":"Pharr","radius_mi":2},"location":{"matched_address":"1201 E CAPOTE CENTRAL AVE, PHARR TX","lat":26.089523,"lon":-98.189325,"county":"Hidalgo County, Texas","placed_by":"parcel_centroid"},"radius_mi":2,"source":"public state construction filing","as_of":"2026-10-11","cadence":"weekly","coverage":{"counties":["Cameron","Hidalgo","Starr","Willacy"],"registered_since":"2024-10-01","filings":1484,"located":999,"located_pct":67.3,"note":"67.3% of the filings we hold have a map point. The rest (intersections, addresses with no house number, addresses not on the map yet) cannot be counted by distance, so treat count as a floor."},"count":11,"total_estimated_cost_usd":44131468,"projects_with_cost":11,"largest_project_cost_usd":12156468,"newest_registration":"2026-09-14","by_type_of_work":[{"type_of_work":"Additions to Existing Building","count":4,"total_estimated_cost_usd":13750000},{"type_of_work":"New Construction","count":4,"total_estimated_cost_usd":29356468},{"type_of_work":"Renovation/Alteration","count":3,"total_estimated_cost_usd":1025000}],"returned":11,"projects":[{"distance_mi":0,"id":"FSP-83c0e15113","name":"Building \"H\"","facility":"Building \"H\"","address":"1201 E Capote Central Ave ste 400 bldg H","city":"Pharr","county":"Hidalgo","zip":"78577","owner":"OCP Capote 2023 LP","design_firm":null,"estimated_cost_usd":100000,"square_feet":3300,"estimated_start":"2026-09-21","estimated_end":"2026-12-23","status":"Review Complete","type_of_work":"Renovation/Alteration","scope_of_work":"Renovation / Alteration to existing building","funding":"private","registered":"2026-09-14","source":"public state construction filing","lat":26.08952,"lon":-98.18932,"geo_precision":"parcel_centroid"},{"distance_mi":0,"id":"FSP-4e6d8fe1b5","name":"Capote Building H - Suite 200","facility":"Capote Building H","address":"1201 E Capote Central","city":"Pharr","county":"Hidalgo","zip":"78577","owner":"OCP Capote 2023 LP","design_firm":null,"estimated_cost_usd":250000,"square_feet":59448,"estimated_start":"2026-04-01","estimated_end":"2026-05-29","status":"Review Complete","type_of_work":"Additions to Existing Building","scope_of_work":"Architectural Services.","funding":"private","registered":"2026-04-28","source":"public state construction filing","lat":26.08952,"lon":-98.18932,"geo_precision":"parcel_centroid"},{"distance_mi":0.7,"id":"FSP-c246e5d9b4","name":"FARMER'S BEST PHASE II","facility":"FARMER'S BEST","address":"1460 E. HI LINE RD.","city":"Pharr","county":"Hidalgo","zip":"78577","owner":"CEUTA PROPERTIES, INC.","design_firm":"MEMBER CONSTRUCTION, LLC.","estimated_cost_usd":7000000,"square_feet":40685,"estimated_start":"2025-07-01","estimated_end":"2026-01-30","status":"Inspection Complete","type_of_work":"Additions to Existing Building","scope_of_work":"ADDITIONS OF 40,685 SQ.FT. COLD STORAGE TO AN EXISTING COLD STORAGE WAREHOUSE.","funding":"private","registered":"2025-06-25","source":"public state construction filing","lat":26.09891,"lon":-98.1849,"geo_precision":"parcel_centroid"}],"note":"Nearest first, up to 100 projects; count and the totals cover every project in the radius. Distance is straight-line miles from the address to the project point: the filed street address (street_address) or the center of its parcel (parcel_centroid). Costs are the estimates owners filed with the state, summed as filed.","disclaimer":"Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"description":"Payment required. Free of charge to receive. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists price, network, asset and payTo; retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON payment requirements (x402 v2).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"example":{"error":"payment_required","price":"$0.03","returns":"Filed commercial projects within a radius of a Valley street address: how many, their summed and largest filed cost, a split by type of work, and each project with its distance and map point, nearest first.","sample":"https://fronterasignal.com/data/v1/samples/nearby.json","docs":"https://fronterasignal.com/openapi.json","how_to_pay":"x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/parcel":{"get":{"operationId":"parcel","summary":"Parcel record for an address","description":"Use when you have a Hidalgo County, Texas street address and need its parcel record before an offer, a loan or a site visit: parcel id, property class, acres, year built, building size, last deed, values, taxing units and the owner if it is a company or public body (people are withheld). /api/v1/parcel/match checks for free first; a miss is a 404 and is not charged. Example: \"What is the parcel id, building size and market value of 800 S 10th St, McAllen?\"\n\nReturns: The Hidalgo County parcel at a street address: parcel and map ids, property class, acres, year built, building square feet, last deed date and type, market, appraised and assessed values with their date, taxing units, the owner when it is an organization, and flood map status.\n\nFree sample (a real answer to /api/v1/parcel?address=800+S+10th+St&city=McAllen): https://fronterasignal.com/data/v1/samples/parcel.json","externalDocs":{"description":"Free sample: a real answer to /api/v1/parcel?address=800+S+10th+St&city=McAllen","url":"https://fronterasignal.com/data/v1/samples/parcel.json"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"network":"eip155:8453","asset":"USDC"},"security":[],"parameters":[{"name":"address","in":"query","required":true,"description":"Street address with house number, e.g. 800 S 10th St. A suite or unit is ignored.","schema":{"type":"string","minLength":5,"maxLength":120,"example":"800 S 10th St"}},{"name":"city","in":"query","required":true,"description":"A Hidalgo County city or town on the address, e.g. McAllen, Edinburg, Mission, Pharr, Weslaco. Other counties get a free 400.","schema":{"type":"string","enum":["Alamo","Alton","Donna","Edcouch","Edinburg","Elsa","Granjeno","Hargill","Hidalgo","La Joya","La Villa","Linn","McAllen","McCook","Mercedes","Mission","Monte Alto","Palmhurst","Palmview","Penitas","Pharr","Progreso","Progreso Lakes","San Carlos","San Juan","Sullivan City","Weslaco"],"example":"McAllen"}}],"responses":{"200":{"description":"The Hidalgo County parcel at a street address: parcel and map ids, property class, acres, year built, building square feet, last deed date and type, market, appraised and assessed values with their date, taxing units, the owner when it is an organization, and flood map status.","content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string"},"dataset":{"type":"string"},"query":{"type":"object","properties":{"address":{"type":"string"},"city":{"type":"string"}},"required":["address","city"]},"source":{"type":"string"},"county":{"type":"string"},"as_of":{"type":"string"},"age_days":{"type":"integer"},"cadence":{"type":"string"},"matched_by":{"type":"string"},"match_count":{"type":"integer"},"point":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"}},"required":["lat","lon"]},"parcels":{"type":"array","items":{"type":"object","properties":{"parcel_id":{"type":"string"},"map_id":{"type":"string"},"situs":{"type":"string"},"property_class":{"type":"string"},"property_class_label":{"type":"string"},"legal_description":{"type":"string"},"land_acres":{"type":"number"},"year_built":{"type":"integer"},"building_sqft":{"type":"integer"},"last_deed_date":{"type":"string"},"deed_type":{"type":"string"},"owner":{"type":"string"},"exemptions":{"type":"array","items":{}},"taxing_units":{"type":"array","items":{"type":"string"}},"values":{"type":"object","properties":{"market_value_usd":{"type":"integer"},"appraised_value_usd":{"type":"integer"},"assessed_value_usd":{"type":"integer"},"land_value_usd":{"type":"integer"},"improvement_value_usd":{"type":"integer"},"as_of":{"type":"string"},"tax_year":{"type":"null"},"note":{"type":"string"}},"required":["market_value_usd","appraised_value_usd","assessed_value_usd","land_value_usd","improvement_value_usd","as_of","tax_year","note"]},"validation":{"type":"string"}},"required":["parcel_id","map_id","situs","property_class","property_class_label","legal_description","land_acres","year_built","building_sqft","last_deed_date","deed_type","owner","exemptions","taxing_units","values","validation"]}},"flood":{"type":"object","properties":{"status":{"type":"string"},"zone":{"type":"null"},"meaning":{"type":"string"},"source":{"type":"string"},"checked":{"type":"string"}},"required":["status","zone","meaning","source","checked"]},"note":{"type":"string"},"disclaimer":{"type":"string"}},"required":["publisher","dataset","query","source","county","as_of","age_days","cadence","matched_by","match_count","point","parcels","flood","note","disclaimer"]},"example":{"publisher":"Frontera Signal","dataset":"parcel","query":{"address":"800 S 10th St","city":"McAllen"},"source":"county parcel records","county":"Hidalgo County, Texas","as_of":"2026-02-11","age_days":242,"cadence":"read live per call","matched_by":"situs_address","match_count":1,"point":{"lat":26.195754,"lon":-98.232595},"parcels":[{"parcel_id":"189432","map_id":"H2550-00-007-0001-26","situs":"800 S 10TH ST, MCALLEN TX","property_class":"F1","property_class_label":"commercial real property","legal_description":"HIDALGO CANAL CO-MC N 1/2 LOT 1 EXC NEC 125 X 150 NW 1/4 BLK 7 2.99 AC NET","land_acres":2.9555,"year_built":1982,"building_sqft":35000,"last_deed_date":"2004-03-29","deed_type":"CORP-ADMT","owner":"WRI JACKSON WEST LP","exemptions":[],"taxing_units":["CAD","CML","DR1"],"values":{"market_value_usd":3223000,"appraised_value_usd":3223000,"assessed_value_usd":3223000,"land_value_usd":2150008,"improvement_value_usd":1072992,"as_of":"2026-02-11","tax_year":null,"note":"The latest values in the county parcel records as of as_of. The tax year they belong to is not confirmed, so check the county before you rely on them for a tax figure."},"validation":"full"}],"flood":{"status":"no_digital_firm","zone":null,"meaning":"Hidalgo County has no digital flood insurance rate map, so the public flood map has no zone to read for this parcel. That does not mean the parcel is outside a flood zone. Ask the lender, the insurer or a surveyor for a flood determination or an elevation certificate.","source":"public flood map","checked":"2026-10-11"},"note":"Read from the county parcel records at the time of the call. as_of is the date those records were last updated. Several parcels come back when one address has several units. Owners are shown only when the owner is an organization (a company, church, school district, government body, bank and the like); a person's name, exemptions and any legal description that names them are withheld (owner_withh…","disclaimer":"Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/ Not a title search, survey or flood determination."}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"description":"Payment required. Free of charge to receive. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists price, network, asset and payTo; retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON payment requirements (x402 v2).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"example":{"error":"payment_required","price":"$0.04","returns":"The Hidalgo County parcel at a street address: parcel and map ids, property class, acres, year built, building square feet, last deed date and type, market, appraised and assessed values with their date, taxing units, the owner when it is an organization, and flood map status.","sample":"https://fronterasignal.com/data/v1/samples/parcel.json","docs":"https://fronterasignal.com/openapi.json","how_to_pay":"x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/cost-per-sqft":{"get":{"operationId":"cost_per_sqft","summary":"Filed cost per square foot","description":"Use to check whether a commercial building budget in the Rio Grande Valley, Texas is in line: median and 25th-75th percentile of filed estimated cost per square foot over the last 24 months, by county (Hidalgo, Cameron, Starr, Willacy) and type of work (new construction, renovation, addition), with n. For estimating, appraisal and lending checks. Filed estimates, not bids. Example: \"What does new commercial construction cost per square foot in Hidalgo County right now?\"\n\nReturns: Median and middle half (25th to 75th percentile) of filed cost per square foot by county and type of work, with n and the date range.\n\nFree sample (a real answer to /api/v1/cost-per-sqft?county=Hidalgo): https://fronterasignal.com/data/v1/samples/cost-per-sqft.json","externalDocs":{"description":"Free sample: a real answer to /api/v1/cost-per-sqft?county=Hidalgo","url":"https://fronterasignal.com/data/v1/samples/cost-per-sqft.json"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"network":"eip155:8453","asset":"USDC"},"security":[],"parameters":[{"name":"county","in":"query","required":false,"description":"Hidalgo, Cameron, Starr or Willacy (\"Hidalgo County\" also works).","schema":{"type":"string","enum":["Hidalgo","Cameron","Starr","Willacy"],"example":"Hidalgo"}},{"name":"type_of_work","in":"query","required":false,"description":"New Construction, Renovation/Alteration or Additions to Existing Building (a unique part of the name works).","schema":{"type":"string","enum":["Additions to Existing Building","New Construction","Renovation/Alteration"],"example":"New Construction"}}],"responses":{"200":{"description":"Median and middle half (25th to 75th percentile) of filed cost per square foot by county and type of work, with n and the date range.","content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string"},"dataset":{"type":"string"},"query":{"type":"object","properties":{"county":{"type":"string"}},"required":[]},"source":{"type":"string"},"as_of":{"type":"string"},"cadence":{"type":"string"},"window":{"type":"object","properties":{"registered_since":{"type":"string"},"months":{"type":"integer"}},"required":["registered_since","months"]},"method":{"type":"string"},"projects_used":{"type":"integer"},"groups":{"type":"array","items":{"type":"object","properties":{"county":{"type":"string"},"type_of_work":{"type":"string"},"n":{"type":"integer"},"registered_from":{"type":"string"},"registered_to":{"type":"string"},"source":{"type":"string"},"median_usd_per_sqft":{"type":["number","null"]},"p25_usd_per_sqft":{"type":["number","null"]},"p75_usd_per_sqft":{"type":["number","null"]},"median_square_feet":{"type":"integer"},"note":{"type":"string"}},"required":["county","type_of_work","n","registered_from","registered_to","source","median_usd_per_sqft","p25_usd_per_sqft","p75_usd_per_sqft"]}},"disclaimer":{"type":"string"}},"required":["publisher","dataset","query","source","as_of","cadence","window","method","projects_used","groups","disclaimer"]},"example":{"publisher":"Frontera Signal","dataset":"cost-per-sqft","query":{"county":"Hidalgo"},"source":"public state construction filing","as_of":"2026-10-11","cadence":"weekly","window":{"registered_since":"2024-10-11","months":24},"method":"Estimated cost divided by square footage, as each owner filed them with the state. Projects without both values, or under 100 sq ft, are left out. Median and 25th/75th percentiles (linear interpolation). Groups with n under 5 report the count only.","projects_used":928,"groups":[{"county":"Hidalgo","type_of_work":"all types","n":928,"registered_from":"2024-10-15","registered_to":"2026-10-08","source":"public state construction filing","median_usd_per_sqft":100.91,"p25_usd_per_sqft":46.79,"p75_usd_per_sqft":206.9,"median_square_feet":5035},{"county":"Hidalgo","type_of_work":"New Construction","n":471,"registered_from":"2024-10-15","registered_to":"2026-10-07","source":"public state construction filing","median_usd_per_sqft":121.36,"p25_usd_per_sqft":61.41,"p75_usd_per_sqft":228.14,"median_square_feet":6000},{"county":"Hidalgo","type_of_work":"Renovation/Alteration","n":393,"registered_from":"2024-10-17","registered_to":"2026-10-08","source":"public state construction filing","median_usd_per_sqft":84.17,"p25_usd_per_sqft":37.71,"p75_usd_per_sqft":170.46,"median_square_feet":3900}],"disclaimer":"Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/ Filed estimates, not bids or appraisals; a project's f…"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"description":"Payment required. Free of charge to receive. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists price, network, asset and payTo; retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON payment requirements (x402 v2).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"example":{"error":"payment_required","price":"$0.03","returns":"Median and middle half (25th to 75th percentile) of filed cost per square foot by county and type of work, with n and the date range.","sample":"https://fronterasignal.com/data/v1/samples/cost-per-sqft.json","docs":"https://fronterasignal.com/openapi.json","how_to_pay":"x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/materials":{"get":{"operationId":"materials","summary":"Building material shelf prices","description":"Use to check what common building materials cost on the shelf in the Rio Grande Valley (McAllen, Mission, Edinburg): 2x4 and 2x6 studs, OSB, drywall, concrete mix, CMU block, rebar, shingles, underlayment, housewrap, insulation, paint, doors, deck screws. Dated prices at big-box stores and a local yard, checked twice a week, for estimating or checking a bid. Not a quote. Example: \"What does a sheet of 7/16 OSB cost in McAllen this week?\"\n\nReturns: Dated shelf prices for common building materials at Valley big-box stores and a local yard, newest price per item and store first.\n\nFree sample (a real answer to /api/v1/materials?item=osb): https://fronterasignal.com/data/v1/samples/materials.json","externalDocs":{"description":"Free sample: a real answer to /api/v1/materials?item=osb","url":"https://fronterasignal.com/data/v1/samples/materials.json"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"security":[],"parameters":[{"name":"item","in":"query","required":false,"description":"An item key or a word from the item name, e.g. osb, rebar, drywall.","schema":{"type":"string","minLength":2,"maxLength":80,"example":"osb"}},{"name":"store","in":"query","required":false,"description":"big-box, local yard or a city (McAllen, Mission, Edinburg).","schema":{"type":"string","minLength":2,"maxLength":60,"example":"McAllen"}}],"responses":{"200":{"description":"Dated shelf prices for common building materials at Valley big-box stores and a local yard, newest price per item and store first.","content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string"},"dataset":{"type":"string"},"region":{"type":"string"},"query":{"type":"object","properties":{"item":{"type":"string"},"store":{"type":"string"}},"required":[]},"source":{"type":"string"},"data_through":{"type":"string"},"first_observed":{"type":"string"},"cadence":{"type":"string"},"rule":{"type":"string"},"note":{"type":"string"},"latest":{"type":"array","items":{"type":"object","properties":{"item_key":{"type":"string"},"item":{"type":"string"},"product":{"type":"string"},"store":{"type":"string"},"city":{"type":["null","string"]},"outlet_id":{"type":"string"},"price_usd":{"type":"number"},"unit":{"type":"string"},"observed":{"type":"string"},"source":{"type":"string"},"age_days":{"type":"integer"}},"required":["item_key","item","product","store","city","outlet_id","price_usd","unit","observed","source","age_days"]}},"count":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","properties":{"item_key":{"type":"string"},"item":{"type":"string"},"product":{"type":"string"},"store":{"type":"string"},"city":{"type":["null","string"]},"outlet_id":{"type":"string"},"price_usd":{"type":"number"},"unit":{"type":"string"},"observed":{"type":"string"},"source":{"type":"string"}},"required":["item_key","item","product","store","city","outlet_id","price_usd","unit","observed","source"]}},"disclaimer":{"type":"string"}},"required":["publisher","dataset","region","query","source","data_through","first_observed","cadence","rule","note","latest","count","rows","disclaimer"]},"example":{"publisher":"Frontera Signal","dataset":"materials","region":"Rio Grande Valley, Texas","query":{"item":"osb"},"source":"Frontera Signal","data_through":"2026-10-01","first_observed":"2026-08-27","cadence":"twice a week","rule":"Only single-unit shelf prices. Volume-only and volume-tier prices are counted as misses, never as prices.","note":"store is big-box or local yard; outlet_id tells two stores of the same kind apart. city is null where the check did not record which Valley branch priced the item.","latest":[{"item_key":"osb_7_16_4x8","item":"OSB 7/16 in, 4x8 sheet","product":"OSB 7/16 4x8","store":"big-box","city":null,"outlet_id":"BB-91a314","price_usd":13.48,"unit":"sheet","observed":"2026-10-01","source":"Frontera Signal","age_days":10},{"item_key":"osb_7_16_4x8","item":"OSB 7/16 in, 4x8 sheet","product":"OSB 7/16\" 4×8 sheathing","store":"big-box","city":"McAllen","outlet_id":"BB-3c03e8","price_usd":13.48,"unit":"sheet","observed":"2026-09-07","source":"Frontera Signal","age_days":34},{"item_key":"osb_7_16_4x8","item":"OSB 7/16 in, 4x8 sheet","product":"OSB 7/16\" 4×8 square sheathing","store":"big-box","city":"McAllen","outlet_id":"BB-d57dc9","price_usd":13.48,"unit":"sheet","observed":"2026-09-07","source":"Frontera Signal","age_days":34}],"count":20,"rows":[{"item_key":"osb_7_16_4x8","item":"OSB 7/16 in, 4x8 sheet","product":"OSB 7/16 4x8","store":"big-box","city":null,"outlet_id":"BB-91a314","price_usd":13.48,"unit":"sheet","observed":"2026-10-01","source":"Frontera Signal"},{"item_key":"osb_7_16_4x8","item":"OSB 7/16 in, 4x8 sheet","product":"OSB 7/16 4x8","store":"big-box","city":null,"outlet_id":"BB-91a314","price_usd":13.48,"unit":"sheet","observed":"2026-09-30","source":"Frontera Signal"},{"item_key":"osb_7_16_4x8","item":"OSB 7/16 in, 4x8 sheet","product":"OSB 7/16 4x8","store":"big-box","city":null,"outlet_id":"BB-91a314","price_usd":13.48,"unit":"sheet","observed":"2026-09-24","source":"Frontera Signal"}],"disclaimer":"Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/ Shelf prices at Valley stores; not a quote or a bid."}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"description":"Payment required. Free of charge to receive. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists price, network, asset and payTo; retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON payment requirements (x402 v2).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"example":{"error":"payment_required","price":"$0.01","returns":"Dated shelf prices for common building materials at Valley big-box stores and a local yard, newest price per item and store first.","sample":"https://fronterasignal.com/data/v1/samples/materials.json","docs":"https://fronterasignal.com/openapi.json","how_to_pay":"x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/series/permits-weekly":{"get":{"operationId":"series_permits_weekly","summary":"Building permits by week","description":"Use to track building-permit activity week by week in Rio Grande Valley cities (McAllen, Edinburg, Pharr, Mission, Weslaco, Brownsville, Harlingen and others) by permit class, to judge whether local construction demand is rising or falling before a lending, supply or market-entry decision. dark means the city published nothing that week. Example: \"Are McAllen single-family permits up or down over the last two months?\"\n\nReturns: Building-permit counts by Valley city, permit class and ISO week, each row reported, dark or no_reading.\n\nFree sample (a real answer to /api/v1/series/permits-weekly?from=2026-W41&to=2026-W41): https://fronterasignal.com/data/v1/samples/series-permits-weekly.json","externalDocs":{"description":"Free sample: a real answer to /api/v1/series/permits-weekly?from=2026-W41&to=2026-W41","url":"https://fronterasignal.com/data/v1/samples/series-permits-weekly.json"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC"},"security":[],"parameters":[{"name":"from","in":"query","required":false,"description":"First ISO week to include, YYYY-Www.","schema":{"type":"string","pattern":"^\\d{4}-[Ww]\\d{2}$","example":"2026-W38"}},{"name":"to","in":"query","required":false,"description":"Last ISO week to include, YYYY-Www.","schema":{"type":"string","pattern":"^\\d{4}-[Ww]\\d{2}$","example":"2026-W38"}}],"responses":{"200":{"description":"Building-permit counts by Valley city, permit class and ISO week, each row reported, dark or no_reading.","content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string"},"series":{"type":"string"},"title":{"type":"string"},"schema_version":{"type":"string"},"latest_week":{"type":"string"},"query":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":[]},"cadence":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"returned":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","properties":{"week_id":{"type":"string"},"county":{"type":"string"},"city":{"type":"string"},"permit_class":{"type":"string"},"count":{"type":["integer","null"]},"value_usd":{"type":["string","null"]},"as_of":{"type":"string"},"age_days":{"type":["integer","null"]},"cadence":{"type":"string"},"stale":{"type":"boolean"},"source":{"type":"string"},"status":{"type":"string"},"backfill":{"type":"boolean"}},"required":["week_id","county","city","permit_class","count","value_usd","as_of","age_days","cadence","stale","source","status","backfill"]}},"disclaimer":{"type":"string"}},"required":["publisher","series","title","schema_version","latest_week","query","cadence","fields","returned","rows","disclaimer"]},"example":{"publisher":"Frontera Signal","series":"permits-weekly","title":"Permits by city and week","schema_version":"2.0","latest_week":"2026-W41","query":{"from":"2026-W41","to":"2026-W41"},"cadence":"weekly","fields":["week_id","county","city"],"returned":19,"rows":[{"week_id":"2026-W41","county":"Hidalgo","city":"McAllen","permit_class":"commercial_projects_registered_state","count":4,"value_usd":"4356932","as_of":"2026-10-09","age_days":2,"cadence":"weekly","stale":false,"source":"Frontera Signal","status":"reported","backfill":false},{"week_id":"2026-W41","county":"Hidalgo","city":"Mission","permit_class":"commercial_projects_registered_state","count":1,"value_usd":"2237966","as_of":"2026-10-09","age_days":2,"cadence":"weekly","stale":false,"source":"Frontera Signal","status":"reported","backfill":false},{"week_id":"2026-W41","county":"Hidalgo","city":"Edinburg","permit_class":"commercial_projects_registered_state","count":2,"value_usd":"305000","as_of":"2026-10-09","age_days":2,"cadence":"weekly","stale":false,"source":"Frontera Signal","status":"reported","backfill":false}],"disclaimer":"Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"description":"Payment required. Free of charge to receive. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists price, network, asset and payTo; retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON payment requirements (x402 v2).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"example":{"error":"payment_required","price":"$0.05","returns":"Building-permit counts by Valley city, permit class and ISO week, each row reported, dark or no_reading.","sample":"https://fronterasignal.com/data/v1/samples/series-permits-weekly.json","docs":"https://fronterasignal.com/openapi.json","how_to_pay":"x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/series/permits-monthly":{"get":{"operationId":"series_permits_monthly","summary":"Housing permits by month","description":"Use to track new housing permits month by month in Rio Grande Valley cities and county areas (Hidalgo, Cameron, Starr, Willacy counties): units and buildings by structure type and valuation since January 2024, with year-to-date totals. Filter by place, county, from and to (YYYY-MM). Covers cities that publish no weekly permits. Example: \"How many single-family homes did Brownsville permit each month this year?\"\n\nReturns: New housing units and buildings authorized by permit each month, by structure type (single-family, 2 units, 3-4 units, 5 or more) with valuation, for Valley cities and unincorporated county areas, plus each year-to-date total.\n\nFree sample (a real answer to /api/v1/series/permits-monthly?place=Brownsville&from=2026-01): https://fronterasignal.com/data/v1/samples/series-permits-monthly.json","externalDocs":{"description":"Free sample: a real answer to /api/v1/series/permits-monthly?place=Brownsville&from=2026-01","url":"https://fronterasignal.com/data/v1/samples/series-permits-monthly.json"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC"},"security":[],"parameters":[{"name":"place","in":"query","required":false,"description":"A Valley city, or \"Hidalgo County (unincorporated)\" and the like.","schema":{"type":"string","enum":["Alamo","Alton","Bayview","Brownsville","Cameron County (unincorporated)","Combes","Donna","Edcouch","Edinburg","Elsa","Escobares","Granjeno","Harlingen","Hidalgo","Hidalgo County (unincorporated)","Indian Lake","La Feria","La Joya","La Villa","Laguna Vista","Los Fresnos","Los Indios","Lyford","McAllen","Mercedes","Mission","Palm Valley","Palmhurst","Palmview","Penitas","Pharr","Port Isabel","Primera","Progreso","Progreso Lakes","Rancho Viejo","Raymondville","Rio Hondo","San Benito","San Juan","Santa Rosa","South Padre Island","Starbase","Sullivan City","Weslaco","Willacy County (unincorporated)"],"example":"Brownsville"}},{"name":"county","in":"query","required":false,"description":"Hidalgo, Cameron, Starr or Willacy (\"Hidalgo County\" also works).","schema":{"type":"string","enum":["Hidalgo","Cameron","Starr","Willacy"],"example":"Hidalgo"}},{"name":"from","in":"query","required":false,"description":"First month to include, YYYY-MM. Default: 12 months back for one place, 3 months otherwise. from=2024-01 returns the whole history.","schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","example":"2026-01"}},{"name":"to","in":"query","required":false,"description":"Last month to include, YYYY-MM.","schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","example":"2026-01"}}],"responses":{"200":{"description":"New housing units and buildings authorized by permit each month, by structure type (single-family, 2 units, 3-4 units, 5 or more) with valuation, for Valley cities and unincorporated county areas, plus each year-to-date total.","content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string"},"series":{"type":"string"},"title":{"type":"string"},"query":{"type":"object","properties":{"place":{"type":"string"},"from":{"type":"string"},"county":{"type":"string"}},"required":["from"]},"source":{"type":"string"},"cadence":{"type":"string"},"months_available":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"returned":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","properties":{"place":{"type":"string"},"county":{"type":"string"},"month":{"type":"string"},"units_total":{"type":"integer"},"buildings_total":{"type":"integer"},"valuation_usd":{"type":"integer"},"single_family_units":{"type":"integer"},"two_unit_units":{"type":"integer"},"three_four_unit_units":{"type":"integer"},"five_plus_unit_units":{"type":"integer"},"single_family_buildings":{"type":"integer"},"two_unit_buildings":{"type":"integer"},"three_four_unit_buildings":{"type":"integer"},"five_plus_unit_buildings":{"type":"integer"},"status":{"type":"string"},"as_of":{"type":"string"},"age_days":{"type":"integer"},"cadence":{"type":"string"},"stale":{"type":"boolean"},"source":{"type":"string"}},"required":["place","county","month","units_total","buildings_total","valuation_usd","single_family_units","two_unit_units","three_four_unit_units","five_plus_unit_units","single_family_buildings","two_unit_buildings","three_four_unit_buildings","five_plus_unit_buildings","status","as_of","age_days","cadence","stale","source"]}},"year_to_date":{"type":"array","items":{"type":"object","properties":{"place":{"type":"string"},"county":{"type":"string"},"year":{"type":"integer"},"through":{"type":"string"},"units_total":{"type":"integer"},"buildings_total":{"type":"integer"},"valuation_usd":{"type":"integer"},"single_family_units":{"type":"integer"},"two_unit_units":{"type":"integer"},"three_four_unit_units":{"type":"integer"},"five_plus_unit_units":{"type":"integer"},"single_family_buildings":{"type":"integer"},"two_unit_buildings":{"type":"integer"},"three_four_unit_buildings":{"type":"integer"},"five_plus_unit_buildings":{"type":"integer"},"as_of":{"type":"string"},"age_days":{"type":"integer"},"cadence":{"type":"string"},"stale":{"type":"boolean"},"source":{"type":"string"}},"required":["place","county","year","through","units_total","buildings_total","valuation_usd","single_family_units","two_unit_units","three_four_unit_units","five_plus_unit_units","single_family_buildings","two_unit_buildings","three_four_unit_buildings","five_plus_unit_buildings","as_of","age_days","cadence","stale","source"]}},"year_to_date_differs":{"type":"array","items":{"type":"object","properties":{"place":{"type":"string"},"year":{"type":"integer"},"through":{"type":"string"},"monthly_rows":{"type":"integer"},"sum_of_months_units":{"type":"integer"},"year_to_date_units":{"type":"integer"}},"required":["place","year","through","monthly_rows","sum_of_months_units","year_to_date_units"]}},"note":{"type":"string"},"disclaimer":{"type":"string"}},"required":["publisher","series","title","query","source","cadence","months_available","fields","returned","rows","year_to_date","year_to_date_differs","note","disclaimer"]},"example":{"publisher":"Frontera Signal","series":"permits-monthly","title":"Housing units authorized by permit, by month","query":{"place":"Brownsville","from":"2026-01"},"source":"public permit statistics","cadence":"monthly","months_available":["2024-01","2026-08"],"fields":["place","county","month"],"returned":8,"rows":[{"place":"Brownsville","county":"Cameron","month":"2026-01","units_total":62,"buildings_total":44,"valuation_usd":8942770,"single_family_units":43,"two_unit_units":0,"three_four_unit_units":0,"five_plus_unit_units":19,"single_family_buildings":43,"two_unit_buildings":0,"three_four_unit_buildings":0,"five_plus_unit_buildings":1,"status":"reported","as_of":"2026-01-31","age_days":253,"cadence":"monthly","stale":true,"source":"public permit statistics"},{"place":"Brownsville","county":"Cameron","month":"2026-02","units_total":91,"buildings_total":55,"valuation_usd":11534890,"single_family_units":54,"two_unit_units":0,"three_four_unit_units":0,"five_plus_unit_units":37,"single_family_buildings":54,"two_unit_buildings":0,"three_four_unit_buildings":0,"five_plus_unit_buildings":1,"status":"reported","as_of":"2026-02-28","age_days":225,"cadence":"monthly","stale":true,"source":"public permit statistics"},{"place":"Brownsville","county":"Cameron","month":"2026-03","units_total":78,"buildings_total":61,"valuation_usd":12281073,"single_family_units":60,"two_unit_units":0,"three_four_unit_units":0,"five_plus_unit_units":18,"single_family_buildings":60,"two_unit_buildings":0,"three_four_unit_buildings":0,"five_plus_unit_buildings":1,"status":"reported","as_of":"2026-03-31","age_days":194,"cadence":"monthly","stale":true,"source":"public permit statistics"}],"year_to_date":[{"place":"Brownsville","county":"Cameron","year":2026,"through":"2026-08","units_total":940,"buildings_total":525,"valuation_usd":110314605,"single_family_units":505,"two_unit_units":0,"three_four_unit_units":8,"five_plus_unit_units":427,"single_family_buildings":505,"two_unit_buildings":0,"three_four_unit_buildings":2,"five_plus_unit_buildings":18,"as_of":"2026-08-31","age_days":41,"cadence":"monthly","stale":false,"source":"public permit statistics"}],"year_to_date_differs":[{"place":"Brownsville","year":2026,"through":"2026-08","monthly_rows":8,"sum_of_months_units":768,"year_to_date_units":940}],"note":"New privately owned housing units authorized by building permits, as each city or county permit office reported them. A monthly row is that month's report. year_to_date is the running total the office filed for the year, with late reports and corrections, so for some places it is not the sum of the months; year_to_date_differs lists those places. Places with no row for a month reported nothing fo…","disclaimer":"Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"description":"Payment required. Free of charge to receive. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists price, network, asset and payTo; retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON payment requirements (x402 v2).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"example":{"error":"payment_required","price":"$0.05","returns":"New housing units and buildings authorized by permit each month, by structure type (single-family, 2 units, 3-4 units, 5 or more) with valuation, for Valley cities and unincorporated county areas, plus each year-to-date total.","sample":"https://fronterasignal.com/data/v1/samples/series-permits-monthly.json","docs":"https://fronterasignal.com/openapi.json","how_to_pay":"x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/series/cost-basket-weekly":{"get":{"operationId":"series_cost_basket_weekly","summary":"Building-input prices by week","description":"Use to see which way building-input costs are moving for South Texas jobs, week by week: framing lumber, studs, OSB, drywall, rebar, copper, Gulf Coast diesel, the 30-year mortgage rate and the construction producer price index. Each row has the level, unit, direction (up, down, flat) and date. Not a bid or quote. Example: \"Has framing lumber gone up or down since August?\"\n\nReturns: Level, unit and direction (up, down, flat) of framing lumber, studs, OSB, drywall, rebar, copper, diesel, the 30-year mortgage rate and the construction producer price index, by week.\n\nFree sample (a real answer to /api/v1/series/cost-basket-weekly?from=2026-W41&to=2026-W41): https://fronterasignal.com/data/v1/samples/series-cost-basket-weekly.json","externalDocs":{"description":"Free sample: a real answer to /api/v1/series/cost-basket-weekly?from=2026-W41&to=2026-W41","url":"https://fronterasignal.com/data/v1/samples/series-cost-basket-weekly.json"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC"},"security":[],"parameters":[{"name":"from","in":"query","required":false,"description":"First ISO week to include, YYYY-Www.","schema":{"type":"string","pattern":"^\\d{4}-[Ww]\\d{2}$","example":"2026-W38"}},{"name":"to","in":"query","required":false,"description":"Last ISO week to include, YYYY-Www.","schema":{"type":"string","pattern":"^\\d{4}-[Ww]\\d{2}$","example":"2026-W38"}}],"responses":{"200":{"description":"Level, unit and direction (up, down, flat) of framing lumber, studs, OSB, drywall, rebar, copper, diesel, the 30-year mortgage rate and the construction producer price index, by week.","content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string"},"series":{"type":"string"},"title":{"type":"string"},"schema_version":{"type":"string"},"latest_week":{"type":"string"},"query":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":[]},"cadence":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"returned":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","properties":{"week_id":{"type":"string"},"input":{"type":"string"},"direction":{"type":["string","null"]},"direction_detail":{"type":["string","null"]},"value":{"type":["number","string","null"]},"unit":{"type":["string","null"]},"value_type":{"type":["string","null"]},"as_of":{"type":["string","null"]},"age_days":{"type":["integer","null"]},"cadence":{"type":"string"},"stale":{"type":"boolean"},"source":{"type":["string","null"]},"so_what":{"type":["string","null"]},"status":{"type":"string"},"backfill":{"type":"boolean"},"value_text":{"type":"string"},"approx":{"type":"boolean"}},"required":["week_id","input","direction","direction_detail","value","unit","value_type","as_of","age_days","cadence","stale","source","so_what","status","backfill"]}},"disclaimer":{"type":"string"}},"required":["publisher","series","title","schema_version","latest_week","query","cadence","fields","returned","rows","disclaimer"]},"example":{"publisher":"Frontera Signal","series":"cost-basket-weekly","title":"Materials basket","schema_version":"2.0","latest_week":"2026-W41","query":{"from":"2026-W41","to":"2026-W41"},"cadence":"weekly and monthly","fields":["week_id","input","direction"],"returned":20,"rows":[{"week_id":"2026-W41","input":"osb_7_16","direction":"flat","direction_detail":"flat_no_new_shelf","value":13.48,"unit":"USD/sheet","value_type":"number","as_of":"2026-10-01","age_days":10,"cadence":"weekly","stale":false,"source":"Frontera Signal","so_what":"do not lock off the futures tick or local yard web 13.99","status":"reported","backfill":false},{"week_id":"2026-W41","input":"rebar_3_20ft","direction":"flat","direction_detail":"flat_no_new_shelf","value":7.38,"unit":"USD/stick","value_type":"number","as_of":"2026-10-01","age_days":10,"cadence":"weekly","stale":false,"source":"Frontera Signal","so_what":"local yard web 5.79 is a walk item not a cut; volume_tier is not the comparison","status":"reported","backfill":false},{"week_id":"2026-W41","input":"quikrete_80","direction":"flat","direction_detail":"flat_no_new_shelf","value":6.24,"unit":"USD/bag","value_type":"number","as_of":"2026-10-01","age_days":10,"cadence":"weekly","stale":false,"source":"Frontera Signal","so_what":"hold the bag; ready-mix withheld","status":"reported","backfill":false}],"disclaimer":"Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"description":"Payment required. Free of charge to receive. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists price, network, asset and payTo; retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON payment requirements (x402 v2).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"example":{"error":"payment_required","price":"$0.05","returns":"Level, unit and direction (up, down, flat) of framing lumber, studs, OSB, drywall, rebar, copper, diesel, the 30-year mortgage rate and the construction producer price index, by week.","sample":"https://fronterasignal.com/data/v1/samples/series-cost-basket-weekly.json","docs":"https://fronterasignal.com/openapi.json","how_to_pay":"x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/series/absorption":{"get":{"operationId":"series_absorption","summary":"Housing supply by week","description":"Use to judge whether Valley housing is oversupplied before you build, lend or buy: months of supply, homes for sale, homes sold, median days on market and typical home value for the McAllen-Edinburg-Mission and Brownsville-Harlingen metros, as read each week. The sources publish monthly, so check age_days and stale. Example: \"Is the McAllen metro carrying more than six months of housing supply?\"\n\nReturns: Months of supply, homes for sale, homes sold, days on market and typical home value for the McAllen and Brownsville metros, as read each week.\n\nFree sample (a real answer to /api/v1/series/absorption?from=2026-W41&to=2026-W41): https://fronterasignal.com/data/v1/samples/series-absorption.json","externalDocs":{"description":"Free sample: a real answer to /api/v1/series/absorption?from=2026-W41&to=2026-W41","url":"https://fronterasignal.com/data/v1/samples/series-absorption.json"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC"},"security":[],"parameters":[{"name":"from","in":"query","required":false,"description":"First ISO week to include, YYYY-Www.","schema":{"type":"string","pattern":"^\\d{4}-[Ww]\\d{2}$","example":"2026-W38"}},{"name":"to","in":"query","required":false,"description":"Last ISO week to include, YYYY-Www.","schema":{"type":"string","pattern":"^\\d{4}-[Ww]\\d{2}$","example":"2026-W38"}}],"responses":{"200":{"description":"Months of supply, homes for sale, homes sold, days on market and typical home value for the McAllen and Brownsville metros, as read each week.","content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string"},"series":{"type":"string"},"title":{"type":"string"},"schema_version":{"type":"string"},"latest_week":{"type":"string"},"query":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":[]},"cadence":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"returned":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","properties":{"week_id":{"type":"string"},"geo":{"type":"string"},"metric":{"type":"string"},"value":{"anyOf":[{"type":"object","properties":{"low":{"type":"integer"},"high":{"type":"integer"},"unit":{"type":"string"}},"required":["low","high","unit"]},{"type":["number","null"]}]},"unit":{"type":["string","null"]},"value_type":{"type":["string","null"]},"as_of":{"type":["string","null"]},"age_days":{"type":["integer","null"]},"cadence":{"type":"string"},"stale":{"type":"boolean"},"source":{"type":["string","null"]},"status":{"type":"string"},"backfill":{"type":"boolean"},"approx":{"type":"boolean"},"value_text":{"type":"string"}},"required":["week_id","geo","metric","value","unit","value_type","as_of","age_days","cadence","stale","source","status","backfill"]}},"disclaimer":{"type":"string"}},"required":["publisher","series","title","schema_version","latest_week","query","cadence","fields","returned","rows","disclaimer"]},"example":{"publisher":"Frontera Signal","series":"absorption","title":"Absorption and inventory","schema_version":"2.0","latest_week":"2026-W41","query":{"from":"2026-W41","to":"2026-W41"},"cadence":"monthly","fields":["week_id","geo","metric"],"returned":20,"rows":[{"week_id":"2026-W41","geo":"McAllen-Edinburg-Mission","metric":"homes_for_sale","value":3628,"unit":"homes","value_type":"number","as_of":"2026-08-31","age_days":41,"cadence":"monthly","stale":false,"source":"Zillow","status":"reported","backfill":false},{"week_id":"2026-W41","geo":"Brownsville-Harlingen","metric":"homes_for_sale","value":1681,"unit":"homes","value_type":"number","as_of":"2026-08-31","age_days":41,"cadence":"monthly","stale":false,"source":"Zillow","status":"reported","backfill":false},{"week_id":"2026-W41","geo":"McAllen-Edinburg-Mission","metric":"typical_home_value_usd","value":193007.08,"unit":"USD","value_type":"number","as_of":"2026-08-31","age_days":41,"cadence":"monthly","stale":false,"source":"Zillow","status":"reported","backfill":false}],"disclaimer":"Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"description":"Payment required. Free of charge to receive. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists price, network, asset and payTo; retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON payment requirements (x402 v2).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"example":{"error":"payment_required","price":"$0.05","returns":"Months of supply, homes for sale, homes sold, days on market and typical home value for the McAllen and Brownsville metros, as read each week.","sample":"https://fronterasignal.com/data/v1/samples/series-absorption.json","docs":"https://fronterasignal.com/openapi.json","how_to_pay":"x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/series/labor-ranges":{"get":{"operationId":"series_labor_ranges","summary":"Labor and financing conditions","description":"Use to gauge construction labor and financing conditions in the Rio Grande Valley: typical build time for a 2,100 sq ft house, the immigration-enforcement climate on job sites and the construction-loan trend. Aggregated, with no firm-level data. Readings are sparse; check age_days before you rely on one. Example: \"How long does it take to build a 2,100 sq ft house in the Valley right now?\"\n\nReturns: Build time for a 2,100 sq ft house, the immigration-enforcement climate and the construction-loan trend in the Valley, by week.\n\nFree sample (a real answer to /api/v1/series/labor-ranges?from=2026-W30&to=2026-W30): https://fronterasignal.com/data/v1/samples/series-labor-ranges.json","externalDocs":{"description":"Free sample: a real answer to /api/v1/series/labor-ranges?from=2026-W30&to=2026-W30","url":"https://fronterasignal.com/data/v1/samples/series-labor-ranges.json"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC"},"security":[],"parameters":[{"name":"from","in":"query","required":false,"description":"First ISO week to include, YYYY-Www.","schema":{"type":"string","pattern":"^\\d{4}-[Ww]\\d{2}$","example":"2026-W38"}},{"name":"to","in":"query","required":false,"description":"Last ISO week to include, YYYY-Www.","schema":{"type":"string","pattern":"^\\d{4}-[Ww]\\d{2}$","example":"2026-W38"}}],"responses":{"200":{"description":"Build time for a 2,100 sq ft house, the immigration-enforcement climate and the construction-loan trend in the Valley, by week.","content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string"},"series":{"type":"string"},"title":{"type":"string"},"schema_version":{"type":"string"},"latest_week":{"type":"string"},"query":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":[]},"cadence":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"returned":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","properties":{"week_id":{"type":"string"},"metric":{"type":"string"},"value":{"anyOf":[{"type":"object","properties":{"low":{"type":"integer"},"high":{"type":"integer"},"unit":{"type":"string"}},"required":["low","high","unit"]},{"type":["string","integer","null"]}]},"unit":{"type":["string","null"]},"value_type":{"type":["string","null"]},"value_text":{"type":"string"},"as_of":{"type":["string","null"]},"age_days":{"type":["integer","null"]},"cadence":{"type":"string"},"stale":{"type":"boolean"},"source":{"type":["string","null"]},"status":{"type":"string"},"backfill":{"type":"boolean"}},"required":["week_id","metric","value","unit","value_type","as_of","age_days","cadence","stale","source","status","backfill"]}},"disclaimer":{"type":"string"}},"required":["publisher","series","title","schema_version","latest_week","query","cadence","fields","returned","rows","disclaimer"]},"example":{"publisher":"Frontera Signal","series":"labor-ranges","title":"Labor and capacity","schema_version":"2.0","latest_week":"2026-W30","query":{"from":"2026-W30","to":"2026-W30"},"cadence":"monthly","fields":["week_id","metric","value"],"returned":3,"rows":[{"week_id":"2026-W30","metric":"build_time_2100sf","value":{"low":9,"high":11,"unit":"months"},"unit":"months","value_type":"range","value_text":"9-11 months","as_of":"2026-07","age_days":72,"cadence":"monthly","stale":false,"source":"Frontera Signal","status":"reported","backfill":false},{"week_id":"2026-W30","metric":"enforcement_climate","value":"elevated","unit":null,"value_type":"category","as_of":"2026-07-24","age_days":79,"cadence":"monthly","stale":false,"source":"Frontera Signal","status":"reported","backfill":false},{"week_id":"2026-W30","metric":"construction_loans_rgv","value":-30,"unit":"pct vs 2025","value_type":"number","value_text":"-30pct vs 2025","as_of":"2026-01","age_days":253,"cadence":"monthly","stale":true,"source":"Frontera Signal","status":"reported","backfill":false}],"disclaimer":"Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"description":"Payment required. Free of charge to receive. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists price, network, asset and payTo; retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON payment requirements (x402 v2).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"example":{"error":"payment_required","price":"$0.05","returns":"Build time for a 2,100 sq ft house, the immigration-enforcement climate and the construction-loan trend in the Valley, by week.","sample":"https://fronterasignal.com/data/v1/samples/series-labor-ranges.json","docs":"https://fronterasignal.com/openapi.json","how_to_pay":"x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/series/calls":{"get":{"operationId":"series_calls","summary":"Forecast track record","description":"Use to check how often Frontera Signal's forecasts come true before you trust one: every dated call since 2026-W30 with its resolve-by date and grade (HIT, MISS, PUSH or OPEN). Example: \"How many of Frontera Signal's forecasts have been graded HIT?\"\n\nReturns: Every dated forecast Frontera Signal has made, with its resolve-by date and grade (HIT, MISS, PUSH, OPEN).\n\nFree sample (a real answer to /api/v1/series/calls?from=2026-W41&to=2026-W41): https://fronterasignal.com/data/v1/samples/series-calls.json","externalDocs":{"description":"Free sample: a real answer to /api/v1/series/calls?from=2026-W41&to=2026-W41","url":"https://fronterasignal.com/data/v1/samples/series-calls.json"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"network":"eip155:8453","asset":"USDC"},"security":[],"parameters":[{"name":"from","in":"query","required":false,"description":"First ISO week to include, YYYY-Www.","schema":{"type":"string","pattern":"^\\d{4}-[Ww]\\d{2}$","example":"2026-W38"}},{"name":"to","in":"query","required":false,"description":"Last ISO week to include, YYYY-Www.","schema":{"type":"string","pattern":"^\\d{4}-[Ww]\\d{2}$","example":"2026-W38"}}],"responses":{"200":{"description":"Every dated forecast Frontera Signal has made, with its resolve-by date and grade (HIT, MISS, PUSH, OPEN).","content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string"},"series":{"type":"string"},"title":{"type":"string"},"schema_version":{"type":"string"},"latest_week":{"type":"string"},"query":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":[]},"cadence":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"returned":{"type":"integer"},"rows":{"type":"array","items":{"type":"object","properties":{"week_id":{"type":"string"},"claim_id":{"type":["string","null"]},"claim_text":{"type":["string","null"]},"resolve_by":{"type":["string","null"]},"grade":{"type":["string","null"]},"status":{"type":"string"},"source":{"type":["string","null"]}},"required":["week_id","claim_id","claim_text","resolve_by","grade","status","source"]}},"disclaimer":{"type":"string"}},"required":["publisher","series","title","schema_version","latest_week","query","cadence","fields","returned","rows","disclaimer"]},"example":{"publisher":"Frontera Signal","series":"calls","title":"Forecast record","schema_version":"2.0","latest_week":"2026-W41","query":{"from":"2026-W41","to":"2026-W41"},"cadence":"weekly","fields":["week_id","claim_id","claim_text","resolve_by","grade","status","source"],"returned":10,"rows":[{"week_id":"2026-W41","claim_id":"W40-diesel","claim_text":"Gulf Coast diesel near 5.955 holds until the next weekly figure","resolve_by":"2026-10-07","grade":"MISS","status":"reported","source":"Frontera Signal"},{"week_id":"2026-W41","claim_id":"W39-shells","claim_text":"Printed starts 2026-09-28 through 2026-10-01 stay shells and finishes not broke ground","resolve_by":"2026-10-08","grade":"PUSH","status":"reported","source":"Frontera Signal"},{"week_id":"2026-W41","claim_id":"W41-no-hidalgo-spec","claim_text":"Do not release a new unsold Hidalgo spec foundation in the 250000 to 290000 band in the next 60 days","resolve_by":"2026-12-10","grade":"OPEN","status":"reported","source":"Frontera Signal"}],"disclaimer":"Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"description":"Payment required. Free of charge to receive. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists price, network, asset and payTo; retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON payment requirements (x402 v2).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"example":{"error":"payment_required","price":"$0.05","returns":"Every dated forecast Frontera Signal has made, with its resolve-by date and grade (HIT, MISS, PUSH, OPEN).","sample":"https://fronterasignal.com/data/v1/samples/series-calls.json","docs":"https://fronterasignal.com/openapi.json","how_to_pay":"x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/issue":{"get":{"operationId":"issue","summary":"Weekly briefing as JSON","description":"Use when you need the written weekly briefing on Rio Grande Valley construction (permits, materials, labor, housing supply, major projects) in English or Spanish, as JSON with headline, key figures, chart data and full text. Pass week=YYYY-Www for a past issue; a week we never published is a free 400 that lists the weeks we have. Example: \"What changed in Valley construction this week?\"\n\nReturns: One weekly briefing as JSON: title, summary, key figures with dates and sources, chart data and the full text, in English or Spanish.\n\nFree sample (a real answer to /api/v1/issue?week=2026-W37&lang=en): https://fronterasignal.com/data/v1/samples/issue.json","externalDocs":{"description":"Free sample: a real answer to /api/v1/issue?week=2026-W37&lang=en","url":"https://fronterasignal.com/data/v1/samples/issue.json"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"network":"eip155:8453","asset":"USDC"},"security":[],"parameters":[{"name":"week","in":"query","required":false,"description":"ISO week of a published issue, YYYY-Www. Default: the latest issue.","schema":{"type":"string","pattern":"^\\d{4}-[Ww]\\d{2}$","example":"2026-W39"}},{"name":"lang","in":"query","required":false,"description":"en or es.","schema":{"type":"string","enum":["en","es"],"default":"en","example":"en"}}],"responses":{"200":{"description":"One weekly briefing as JSON: title, summary, key figures with dates and sources, chart data and the full text, in English or Spanish.","content":{"application/json":{"schema":{"type":"object","properties":{"publisher":{"type":"string"},"week_id":{"type":"string"},"date":{"type":"string"},"lang":{"type":"string"},"title":{"type":"string"},"dek":{"type":"string"},"issue_no":{"type":"integer"},"data_as_of":{"type":"string"},"sample":{"type":"boolean"},"stats":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"},"meta":{"type":"string"},"as_of":{"type":"string"},"source":{"type":"string"},"delta":{"type":"string"}},"required":["label","value","meta","as_of","source"]}},"charts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"kicker":{"type":"string"},"title":{"type":"string"},"note":{"type":"string"},"unit":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}},"values":{"type":"array","items":{"type":"number"}},"highlight":{"type":"string"},"source":{"type":"string"},"as_of":{"type":"string"},"today":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"},"status":{"type":"string"}},"required":["label","start","status"]}},"x":{"type":"array","items":{"type":"string"}},"series":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"number"}}},"required":["name","values"]}}},"required":["id","type","kicker","title","note","source","as_of"]}},"body_markdown":{"type":"string"},"cadence":{"type":"string"},"disclaimer":{"type":"string"}},"required":["publisher","week_id","date","lang","title","dek","issue_no","data_as_of","sample","stats","charts","body_markdown","cadence","disclaimer"]},"example":{"publisher":"Frontera Signal","week_id":"2026-W37","date":"2026-09-13","lang":"en","title":"Cameron County clears Fluidstack for grading and utility work","dek":"The Sep 10 permit covers sitework only, so civil crews go first. In Hidalgo County, 9.1 months of supply and a 6.76% rate weigh on spec homes.","issue_no":1,"data_as_of":"Sep 12, 2026","sample":true,"stats":[{"label":"McAllen months of supply","value":"9.1","meta":"May 2026 · latest available","as_of":"May 2026","source":"Redfin"},{"label":"30-year mortgage rate","value":"6.76%","meta":"Week of Sep 10 · prior week 6.71%","delta":"up","as_of":"Sep 10, 2026","source":"Freddie Mac"},{"label":"Gulf Coast diesel","value":"$5.754","meta":"Week ending Sep 7 · up $0.394","delta":"up","as_of":"Sep 7, 2026","source":"Frontera Signal"}],"charts":[{"id":"commercial-by-value","type":"bar","kicker":"Hidalgo and Cameron counties","title":"Commercial projects by filed value","note":"Projects set to start between Sep 14 and Oct 1.","unit":"$","labels":["7 Palmas cold storage","Amore Produce","Bridge interiors","Target Nolana paving","Ross, Mission","Ed Carey, Harlingen","Re Pilates","Ruleta warehouse"],"values":[14000000,8000000,1925000,898612,850000,250000,205400,200000],"highlight":"7 Palmas cold storage","source":"Frontera Signal","as_of":"Sep 12, 2026"},{"id":"starts-calendar","type":"timeline","kicker":"Hidalgo and Cameron counties","title":"Scheduled start dates","note":"Planned start and finish dates as filed.","today":"2026-09-13","items":[{"label":"Target Nolana paving","start":"2026-09-14","end":"2026-10-09","status":"verified"},{"label":"Ruleta warehouse","start":"2026-09-14","status":"verified"},{"label":"Re Pilates","start":"2026-09-21","end":"2026-12-20","status":"verified"}],"source":"Frontera Signal","as_of":"Sep 12, 2026"},{"id":"shelf-prices","type":"bar","kicker":"Retail prices, Sep 11","title":"Prices of common building materials","note":"Stud from a local yard, the other four from a big-box store, all priced the morning of Sep 11.","unit":"$","labels":["2x4 stud, local yard","OSB 7/16","No. 3 rebar, 20 ft","8-inch block","1/2-inch drywall"],"values":[3.49,13.48,7.38,2.37,14.98],"highlight":"2x4 stud, local yard","source":"Frontera Signal price check","as_of":"Sep 11, 2026"}],"body_markdown":"Cameron County on Sep 10 issued Fluidstack a worksite permit for the $4 billion first phase of its data center project, the county judge said. The permit covers clearing, grading, utilities, streets and ponds on land east of FM 509 and west of FM 106. Buildings will need permits of their own, and none has been filed, so civil contractors are first in line.\n\nFluidstack says the project will create…","cadence":"weekly","disclaimer":"Every value carries as_of, age_days, cadence and stale (weekly measures go stale after 14 days, monthly measures after 90). dark = the source published nothing that week; no_reading = we have no reading for it. Ranges are {low, high, unit}; approx marks a rounded reading. Not a quote, bid or appraisal. Terms: https://fronterasignal.com/terms/"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"description":"Payment required. Free of charge to receive. The PAYMENT-REQUIRED header (base64 JSON, x402 v2) lists price, network, asset and payTo; retry with a PAYMENT-SIGNATURE header.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON payment requirements (x402 v2).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"example":{"error":"payment_required","price":"$0.25","returns":"One weekly briefing as JSON: title, summary, key figures with dates and sources, chart data and the full text, in English or Spanish.","sample":"https://fronterasignal.com/data/v1/samples/issue.json","docs":"https://fronterasignal.com/openapi.json","how_to_pay":"x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE"}}}},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}},"components":{"schemas":{"Error":{"type":"object","required":["ok","error","message","docs"],"description":"One error shape for every refusal. 400 and 404 come before any payment and are free.\nunknown_param (400): A query parameter this endpoint does not take. allowed lists the ones it does.\nrepeated_param (400): The same parameter was sent twice.\nmissing_param (400): A required parameter is missing.\nbad_param (400): A value in the wrong format (date, ISO week, number, length). The message names the parameter.\nunknown_value (400): A value outside the list we cover (city, county, item, store, type of work, language). allowed lists the valid ones.\nunknown_week (400): No issue was published for that week in that language. allowed.week lists the ones we have.\nbad_range (400): from is after to.\nno_house_number (400): nearby and parcel need a house number and street; an intersection or a street alone has no single place.\nnot_covered (400): The place is outside what the endpoint covers. parcel covers Hidalgo County only for now.\nno_results (404): The query is valid but nothing matches it. Free.\nno_readings (404): Rows exist for that range but every one is dark or no_reading. Free.\nno_match (404): No owner or design firm contains that name. Free.\ntoo_few_projects (404): Fewer than 5 usable filings in every group, so there is no statistic to sell. Free; counts are in the body.\nnot_found (404): No such endpoint or series.\naddress_not_found (404): nearby and parcel: the address could not be placed on the map or matched to a parcel. Found after the payment is verified; the payment is not settled.\nambiguous (404): nearby and parcel: the address fits several different places or parcels. Add the direction (N, S, E, W). Not settled.\noutside_coverage (404): nearby: the address is outside Hidalgo, Cameron, Starr and Willacy counties. Not settled.\nnot_available (404): parcel: this record is not available from this API. Not settled.\nrate_limited (429): parcel/match: too many free lookups from one IP address. Retry after the Retry-After header.\nupstream_unavailable (503): nearby and parcel read public records at request time, and that service did not answer in time. Retry in a minute. Not settled.\npayment_service_starting (503): The payment service is starting. Retry after the Retry-After header (2 s). Never charged.\npayments_not_configured (503): Payments are not switched on for this deployment.","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string","enum":["unknown_param","repeated_param","missing_param","bad_param","unknown_value","unknown_week","bad_range","no_house_number","not_covered","no_results","no_readings","no_match","too_few_projects","not_found","address_not_found","ambiguous","outside_coverage","not_available","rate_limited","upstream_unavailable","payment_service_starting","payments_not_configured"]},"message":{"type":"string","description":"What was wrong, in a sentence."},"param":{"type":"string","description":"The parameter at fault, when there is one."},"docs":{"type":"string","format":"uri","const":"https://fronterasignal.com/openapi.json"},"allowed":{"type":"object","description":"Every parameter this endpoint takes, with its type and valid values.","additionalProperties":{"type":"object"}},"groups":{"type":"array","description":"too_few_projects only: the count in each county and type of work.","items":{"type":"object"}},"location":{"type":"object","description":"nearby no_results only: where the address was placed."},"coverage":{"type":"object","description":"nearby no_results only: how many filings have a map point."},"retry_after_seconds":{"type":"integer","description":"payment_service_starting only."}}},"PaymentRequired":{"type":"object","required":["error","price","returns","sample","docs","how_to_pay"],"properties":{"error":{"type":"string","const":"payment_required"},"price":{"type":"string","description":"USD per call, paid in USDC.","example":"$0.02"},"returns":{"type":"string","description":"What the paid call answers with, in one line."},"sample":{"type":"string","format":"uri","description":"A real answer to this endpoint, free."},"docs":{"type":"string","format":"uri"},"how_to_pay":{"type":"string","const":"x402 v2, USDC on Base; retry with PAYMENT-SIGNATURE"}}},"Health":{"type":"object","required":["ok","version","data_through_week","generated_at"],"properties":{"ok":{"type":"boolean"},"version":{"type":"string"},"data_through_week":{"type":["string","null"]},"generated_at":{"type":"string","format":"date-time"}}}},"responses":{"BadRequest":{"description":"Bad or unknown parameters. Free, before any payment; allowed lists the valid ones.\nunknown_param (400): A query parameter this endpoint does not take. allowed lists the ones it does.\nrepeated_param (400): The same parameter was sent twice.\nmissing_param (400): A required parameter is missing.\nbad_param (400): A value in the wrong format (date, ISO week, number, length). The message names the parameter.\nunknown_value (400): A value outside the list we cover (city, county, item, store, type of work, language). allowed lists the valid ones.\nunknown_week (400): No issue was published for that week in that language. allowed.week lists the ones we have.\nbad_range (400): from is after to.\nno_house_number (400): nearby and parcel need a house number and street; an intersection or a street alone has no single place.\nnot_covered (400): The place is outside what the endpoint covers. parcel covers Hidalgo County only for now.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"ok":false,"error":"unknown_value","message":"city must be one of McAllen, Edinburg, Mission, Pharr, San Juan, Weslaco, Donna, Mercedes, Brownsville, Harlingen (got \"Laredo\").","param":"city","docs":"https://fronterasignal.com/openapi.json","allowed":{"city":{"type":"enum","description":"A Valley city. Omit for the whole Valley."}}}}}},"NotFound":{"description":"A valid query with nothing to return, or no such endpoint. Free: before any payment, or for nearby and parcel after the payment is verified and never settled.\nno_results (404): The query is valid but nothing matches it. Free.\nno_readings (404): Rows exist for that range but every one is dark or no_reading. Free.\nno_match (404): No owner or design firm contains that name. Free.\ntoo_few_projects (404): Fewer than 5 usable filings in every group, so there is no statistic to sell. Free; counts are in the body.\nnot_found (404): No such endpoint or series.\naddress_not_found (404): nearby and parcel: the address could not be placed on the map or matched to a parcel. Found after the payment is verified; the payment is not settled.\nambiguous (404): nearby and parcel: the address fits several different places or parcels. Add the direction (N, S, E, W). Not settled.\noutside_coverage (404): nearby: the address is outside Hidalgo, Cameron, Starr and Willacy counties. Not settled.\nnot_available (404): parcel: this record is not available from this API. Not settled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"ok":false,"error":"no_results","message":"No filed projects match city=McAllen, since=2026-10-03. Widen the filters; filings go back to 2024-10-01.","docs":"https://fronterasignal.com/openapi.json","allowed":{}}}}},"ServiceUnavailable":{"description":"The payment service is starting (retry after the Retry-After header), payments are off, or a live public-records lookup did not answer in time. Never settled.\nupstream_unavailable (503): nearby and parcel read public records at request time, and that service did not answer in time. Retry in a minute. Not settled.\npayment_service_starting (503): The payment service is starting. Retry after the Retry-After header (2 s). Never charged.\npayments_not_configured (503): Payments are not switched on for this deployment.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","example":2}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"ok":false,"error":"payment_service_starting","message":"The payment service is starting. Retry in 2 seconds.","docs":"https://fronterasignal.com/openapi.json","retry_after_seconds":2}}}}}}}