{"openapi":"3.1.0","info":{"title":"BUY SIGNAL Portugal","description":"Given a Portuguese company NIF/NIPC, return official Portugal 2030 EU-funded project facts and evidence-based inferred investment and purchasing categories for company intelligence, sales research and procurement opportunity screening. Includes funding, rule-based confidence, provenance, snapshot freshness and a conservative commercial-opportunity assessment. Not confirmed purchase intent, open tenders, remaining budgets or live procurement needs.","version":"0.7.1","x-guidance":"# BUY SIGNAL Portugal\n\nPortugal Company Funding & Purchase Intent Intelligence\nCapability: portugal_company_purchase_intelligence\nLook up official Portugal 2030 EU-funded-project facts and evidence-based purchasing/investment categories by Portuguese company NIF/NIPC. Useful for industrial expansion research, company intelligence, sales prioritisation and procurement opportunity screening. A funded project is not proof of current purchase intent or an open order.\nOrigin: https://buy-signal-portugal.onrender.com\nProduct metadata: /product\nOpenAPI: /openapi.json\nFree example: /example\nSource and snapshot freshness: /source\nFree coverage check: /company/{nif}/coverage (check before authorising payment)\nLive coverage and reporting date: /health\n\nGET /company/{nif}/buy-signal\nInput: a nine-digit Portuguese NIF/NIPC; replace {nif} in the URL path.\nExample URL: https://buy-signal-portugal.onrender.com/company/507168216/buy-signal\nPayment: x402 version 2, exact scheme, Base mainnet (eip155:8453), 0.03 USDC (30000 atomic units).\nUSDC token: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\nUse an x402-compatible client. Read the HTTP 402 Payment-Required challenge and verify the live recipient, network, token and amount before signing. Spend only within the user's authorized budget. Never paste private keys or seed phrases into chat.\nRetry the same URL with the generated PAYMENT-SIGNATURE header. A successful response is HTTP 200 with a PAYMENT-RESPONSE settlement receipt. Verify receipt success and returned nif before reporting a successful purchase.\nDo not automatically retry an outcome-unknown payment; first reconcile its settlement.\n\nBuying decision: Use this tool when you already know a Portuguese company NIF and need official funded-project context. One 0.03 USDC lookup returns all matching project records for that NIF in the current snapshot; it does not buy a company list, live tenders or verified purchase intent. Review /example and /source, then call the free coverage check. If the company is absent or the snapshot is too old for your task, do not purchase. Name/sector searches are not supported.\nSuggested workflow: known NIF -> free coverage -> check freshness and authorized budget -> paid lookup -> cite official facts separately from hypotheses -> independently verify current procurement needs. Save the result and settlement receipt; repurchasing the same NIF does not refresh the source snapshot.\n\nOutput: status, nif, company, signals, count and freshness. Each signal includes commercial_assessment: RESEARCH_LEAD, HISTORICAL_CONTEXT or UNKNOWN; current purchase opportunity stays UNKNOWN without direct evidence. Scheduled end dates are not verified completion dates.\nOptional X-Discovery-Source header: short directory/router name for aggregate attribution; buyer-supplied and not independently verified. No referral reward is offered. Each signal separates official facts from purchase_inferences.\nNo match: HTTP 404 with status UNKNOWN. This server does not settle payment on error responses. UNKNOWN means absent from this snapshot, not absence of all funded projects.\nData: official workbook reported to 2026-08-31. 24125 projects, 20285 queryable records and 9189 distinct beneficiaries. Other identifiers are not queryable by NIF.\nBeneficiaries include businesses, public bodies, academic entities and nonprofits.\nExecution percentages are missing from this source; progress and stage remain unknown.\nCategory confidence and strength scores are rule-based inferences, not calibrated probabilities or confirmed orders. Do not turn them into claims that a company is about to buy.\n"},"paths":{"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}},"security":[]}},"/example":{"get":{"summary":"Example","operationId":"example_example_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/llms.txt":{"get":{"summary":"Agent Instructions","operationId":"agent_instructions_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}},"security":[]}},"/.well-known/x402":{"get":{"summary":"Discovery","operationId":"discovery__well_known_x402_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/source":{"get":{"summary":"Source Metadata","operationId":"source_metadata_source_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/company/{nif}/coverage":{"get":{"summary":"Coverage","operationId":"coverage_company__nif__coverage_get","parameters":[{"name":"nif","in":"path","required":true,"schema":{"type":"string","title":"Nif"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/product":{"get":{"summary":"Product","operationId":"product_product_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/company/{nif}/buy-signal":{"get":{"summary":"Portugal company funding and purchase intelligence by NIF/NIPC","operationId":"portugal_company_purchase_intelligence","parameters":[{"name":"nif","in":"path","required":true,"schema":{"type":"string","title":"Nif"},"example":"507168216"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["FOUND"]},"nif":{"type":"string","pattern":"^[0-9]{9}$"},"company":{"type":"string"},"signals":{"type":"array","items":{"type":"object","properties":{"schema":{"type":"string"},"change_type":{"type":"string"},"operation_code":{"type":"string"},"company":{"type":"object","properties":{"name":{"type":"string"},"nipc":{"type":"string"},"beneficiary_profile":{"type":"object","properties":{"type":{"type":"string"},"confidence":{"type":"number"},"basis":{"type":"string"},"matched_terms":{"type":"array","items":{}}}}}},"signal":{"type":"object","properties":{"strength":{"type":"string"},"score":{"type":"integer"},"event":{"type":"string"},"stage":{"type":"string"},"funding_eur":{"type":"number"},"execution_pct":{"type":["number","null"]},"project_name":{"type":"string"},"project_start":{"type":"string"},"project_end":{"type":"string"}}},"facts":{"type":"object","properties":{"description":{"type":"string"},"intervention_field":{"type":"string"},"source_type":{"type":"string"},"source_url":{"type":"string"},"source_updated":{"type":"string"},"dataset_url":{"type":"string"}}},"purchase_inferences":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"confidence":{"type":"number"},"basis":{"type":"string"},"matched_terms":{"type":"array","items":{"type":"string"}}}},"description":"Rule-based hypotheses derived from published project text, not confirmed orders."},"guardrail":{"type":"string"},"detected_at":{"type":"string"},"_api":{"type":"object","properties":{"product":{"type":"string"},"version":{"type":"string"},"facts_and_inferences_separated":{"type":"boolean"},"guardrail":{"type":"string"}}},"commercial_assessment":{"type":"object","properties":{"funded_project_present":{"type":"boolean"},"category_evidence":{"type":"string"},"commercial_usefulness":{"type":"string","enum":["RESEARCH_LEAD","HISTORICAL_CONTEXT","UNKNOWN"]},"current_purchase_opportunity":{"type":"string"},"procurement_status":{"type":"string"},"remaining_budget_eur":{"type":["number","null"],"description":"Unknown without direct evidence; this service does not infer unspent project budgets."},"scheduled_end_elapsed":{"type":["boolean","null"]},"assessed_as_of":{"type":"string"},"basis":{"type":"string"},"next_check":{"type":"string"}}}}},"minItems":1},"count":{"type":"integer"},"freshness":{"type":"object","properties":{"source_url":{"type":"string"},"reporting_date":{"type":"string"},"source_sha256":{"type":"string"},"snapshot_sha256":{"type":"string"},"snapshot_age_days":{"type":"integer"},"snapshot_validated_at":{},"upstream_latest_release_checked_at":{"type":"string"},"publisher_page":{"type":"string"},"latest_release_status":{"type":"string"},"freshness_policy":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}}}},"required":["status","nif","company","signals","count","freshness"],"description":"All matching records for one Portuguese NIF in the published snapshot. Official facts are separated from inferences and commercial assessments."},"example":{"status":"FOUND","nif":"507168216","company":"EXLABESA EXTRUSION COIMBRA, LDA","signals":[{"schema":"buy-signal.pt.v0.2","change_type":"snapshot","operation_code":"COMPETE2030-FEDER-03487100","company":{"name":"EXLABESA EXTRUSION COIMBRA, LDA","nipc":"507168216","beneficiary_profile":{"type":"unclassified","confidence":0.0,"basis":"insufficient_evidence","matched_terms":[]}},"signal":{"strength":"MEDIUM","score":61,"event":"funded_project_detected","stage":"unknown","funding_eur":9599750.99,"execution_pct":null,"project_name":"Exlabesa - aumento da capacidade produtiva","project_start":"","project_end":"2028-08-31"},"facts":{"description":"A Exlabesa implementa em Soure, Coimbra, um investimento para a expansão da capacidade produtiva de 5.500 para 12.000 toneladas anuais (+243%) através de linha de extrusão 12\" de 45 MN com tecnologia short-stroke e automação robotizada. O projeto integra soluções Indústria 4.0 com PLC Allen-Bradley, diagnóstico preditivo e sistemas digitais avançados, complementado por painéis fotovoltaicos de 1MW para autoconsumo energético.\nA operação aborda a","intervention_field":"Desenvolvimento empresarial e internacionalização das PME, incluindo os investimentos produtivos","source_type":"official_public_record","source_url":"https://transparencia.gov.pt/pt/fundos-europeus/pt2030/beneficiarios-projetos/projeto/COMPETE2030-FEDER-03487100/","source_updated":"2026-08-31","dataset_url":"https://portugal2030.pt/wp-content/uploads/sites/3/2026/09/PT2030-Lista-Operacoes-a-Publicar_31-ago-2026.xlsx"},"purchase_inferences":[{"category":"industrial_automation","confidence":0.82,"basis":"project_name_and_purpose","matched_terms":["indústria 4.0","automação"]},{"category":"production_machinery","confidence":0.82,"basis":"project_name_and_purpose","matched_terms":["capacidade produtiva","extrusão"]},{"category":"energy","confidence":0.82,"basis":"project_name_and_purpose","matched_terms":["fotovolta","autoconsumo"]}],"guardrail":"Purchase categories are inferred signals, not confirmed purchase orders.","detected_at":"2026-10-01T20:48:05.118134+00:00","_api":{"product":"BUY SIGNAL Portugal","version":"0.7.1","facts_and_inferences_separated":true,"guardrail":"Purchase categories are inferred signals, not confirmed purchase orders."},"commercial_assessment":{"funded_project_present":true,"category_evidence":"PROJECT_TEXT_MATCH","commercial_usefulness":"RESEARCH_LEAD","current_purchase_opportunity":"UNKNOWN","procurement_status":"UNKNOWN","remaining_budget_eur":null,"scheduled_end_elapsed":false,"assessed_as_of":"2026-10-03","basis":"Published project text and scheduled dates; no verified purchasing timetable, open tender or unspent budget.","next_check":"Verify current procurement needs and implementation status before treating this beneficiary as an active sales opportunity."}},{"schema":"buy-signal.pt.v0.2","change_type":"snapshot","operation_code":"COMPETE2030-FEDER-03575100","company":{"name":"EXLABESA EXTRUSION COIMBRA, LDA","nipc":"507168216","beneficiary_profile":{"type":"unclassified","confidence":0.0,"basis":"insufficient_evidence","matched_terms":[]}},"signal":{"strength":"LOW","score":40,"event":"funded_project_detected","stage":"unknown","funding_eur":173782.0,"execution_pct":null,"project_name":"Exlabesa - Expansão internacional","project_start":"","project_end":"2028-07-01"},"facts":{"description":"A Exlabesa Extrusion Coimbra, produtora de perfis extrudidos de alumínio, pretende desenvolver este projeto de internacionalização para aumentar a sua capacidade exportadora, expandindo de 2 para 10 mercados internacionais. O projeto estrutura-se em 3 domínios: implementação da certificação ISO 50001 para diferenciação ESG, participação em 6 feiras especializadas (EUA, Suíça, Colômbia, México, Chile) para apresentação externa e desenvolvimento de","intervention_field":"Desenvolvimento empresarial e internacionalização das PME, incluindo os investimentos produtivos","source_type":"official_public_record","source_url":"https://transparencia.gov.pt/pt/fundos-europeus/pt2030/beneficiarios-projetos/projeto/COMPETE2030-FEDER-03575100/","source_updated":"2026-08-31","dataset_url":"https://portugal2030.pt/wp-content/uploads/sites/3/2026/09/PT2030-Lista-Operacoes-a-Publicar_31-ago-2026.xlsx"},"purchase_inferences":[{"category":"production_machinery","confidence":0.77,"basis":"project_name_and_purpose","matched_terms":["extrusion"]},{"category":"marketing_internationalization","confidence":0.77,"basis":"project_name_and_purpose","matched_terms":["internacionalização"]}],"guardrail":"Purchase categories are inferred signals, not confirmed purchase orders.","detected_at":"2026-10-01T20:48:05.118134+00:00","_api":{"product":"BUY SIGNAL Portugal","version":"0.7.1","facts_and_inferences_separated":true,"guardrail":"Purchase categories are inferred signals, not confirmed purchase orders."},"commercial_assessment":{"funded_project_present":true,"category_evidence":"PROJECT_TEXT_MATCH","commercial_usefulness":"RESEARCH_LEAD","current_purchase_opportunity":"UNKNOWN","procurement_status":"UNKNOWN","remaining_budget_eur":null,"scheduled_end_elapsed":false,"assessed_as_of":"2026-10-03","basis":"Published project text and scheduled dates; no verified purchasing timetable, open tender or unspent budget.","next_check":"Verify current procurement needs and implementation status before treating this beneficiary as an active sales opportunity."}}],"count":2,"freshness":{"source_url":"https://portugal2030.pt/wp-content/uploads/sites/3/2026/09/PT2030-Lista-Operacoes-a-Publicar_31-ago-2026.xlsx","reporting_date":"2026-08-31","source_sha256":"e7266f9a38db338201bbe804ae8a83d3478dacb4fba34bae1f1a89b22e8b91d1","snapshot_sha256":"e0d10666f84fcca742f6e2df7fc0ecec13e6e8b02e48c4b1345bb02c4aab8213","snapshot_age_days":33,"snapshot_validated_at":"2026-10-03T10:35:34.621822+00:00","upstream_latest_release_checked_at":"2026-10-01T22:45:13.589166+00:00","publisher_page":"https://portugal2030.pt/resultados-pt2030/","latest_release_status":"MATCHED_PUBLISHER_LISTING_AT_CHECK","freshness_policy":"Validated dated snapshot; not a live feed. Health checked_at indicates API availability, not a new source check.","limitations":["Beneficiaries include public, academic and nonprofit bodies as well as businesses.","Execution percentages are absent from this source; stage remains unknown.","Anonymous or non-nine-digit identifiers cannot be queried by the current NIF endpoint.","Purchase categories and strength scores are rule-based inferences, not confirmed orders or calibrated probabilities."]}}}}},"402":{"description":"Payment required: 0.03 USDC via x402 on Base"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453"}}],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"security":[],"description":"Given a Portuguese company NIF/NIPC, return official Portugal 2030 EU-funded project facts and evidence-based inferred investment and purchasing categories for company intelligence, sales research and procurement opportunity screening. Includes funding, rule-based confidence, provenance, snapshot freshness and a conservative commercial-opportunity assessment. Not confirmed purchase intent, open tenders, remaining budgets or live procurement needs. No account API key is required. This paid operation uses the x402 Payment-Required challenge and PAYMENT-SIGNATURE authorization header; verify the live challenge before signing."}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}