Metadata-Version: 2.4
Name: nexus-filings
Version: 0.1.0
Summary: SDK oficial de Nexus Filings: datos financieros normalizados a partir de filings oficiales de múltiples registros (UK, EE.UU., Dinamarca, Noruega, Brasil y otros mercados europeos)
Author: TFSouthCode
License-Expression: Apache-2.0
Keywords: financial-data,xbrl,ixbrl,companies-house,filings
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: requests>=2.31
Dynamic: license-file

# nexus-filings (Python)

SDK oficial de [Nexus Filings](https://nexusfilings.io): datos financieros normalizados
(revenue, profit, equity, ratios) a partir de filings oficiales de múltiples registros (UK,
EE.UU., Dinamarca, Noruega, Brasil y otros mercados europeos — ver la cobertura completa en
[nexusfilings.io](https://nexusfilings.io/#coverage)), con la procedencia de cada campo
(`direct`, `derived` o `unavailable`).

```bash
pip install nexus-filings
```

```python
from nexus_filings_sdk import NexusFilingsClient

client = NexusFilingsClient(api_key="TU_API_KEY")

for company in client.search("wise"):
    print(company["id"], company["name"])

result = client.get_financials("GB:07209813")             # Free: el último ejercicio; planes pagos: todo el historial
result = client.get_financials("GB:07209813", fiscal_year=2024)
print(result["available_years"])
```

Una consulta a una empresa nueva puede responder `202` (se está procesando): el SDK devuelve el
cuerpo con `"status": "processing"` y `retry_after_seconds`; reintentá el mismo request pasado ese tiempo
(los errores, en cambio, lanzan `NexusFilingsAPIError`). Documentación completa: https://nexusfilings.io/docs.html

## Licencia

Apache License 2.0 — Copyright 2026 TFSouthCode. Ver `LICENSE` y `NOTICE`. La licencia cubre el código de este SDK; el uso de la API y de los datos se rige por los Términos de servicio de Nexus Filings.
