finra-py

finra-py es una biblioteca cliente de Python de código abierto y no oficial que envuelve la plataforma de API de FINRA. Se presenta como una capa deliberadamente delgada: las solicitudes se asignan a la API de FINRA y los objetos httpx.Response sin procesar se devuelven al llamador, de modo que no se impone ningún modelo de respuesta o datos propietario. El objetivo declarado es ofrecer la comodidad de un cliente dedicado de FINRA sin renunciar al control de las solicitudes HTTP directas. La autenticación es lo principal que la biblioteca quita de las manos del usuario. La API de FINRA utiliza OAuth 2.0, y finra-py gestiona la adquisición y el ciclo de vida del token, incluido el almacenamiento de token personalizable para aplicaciones que mantienen las credenciales en sus propios sistemas. El README enumera la cobertura de tres áreas de API: - Conjuntos de datos de la API de Consulta, incluidos Acciones, Renta Fija, FINRA, Empresa, Registro y Tarjeta de Informe TRACE. - Conjuntos de datos de la API de Notificación para eventos de notificación de FINRA. - Flujos de trabajo de la API de Envío para presentaciones regulatorias y otros datos, que cubren la creación, validación, envío, actualización y recuperación de Form U4, Form U5, Form BR, Crear Individual, Huella dactilar no registrada y otros flujos compatibles. Capacidades adicionales documentadas incluyen soporte para todos los tipos de credenciales, conjuntos de datos simulados, la API de Entorno de Prueba QA, solicitudes asíncronas del lado del servidor y asyncio del lado del cliente. La instalación requiere Python 3.11 o posterior y se realiza con `python -m pip install finra-py`; el paquete se importa como `import finra`. La documentación completa se aloja por separado, con una guía de introducción, notas ADR y un changelog vinculados desde el README. Las limitaciones se indican claramente: aunque la biblioteca pretende una cobertura completa de los conjuntos de datos documentados, algunos conjuntos de datos y servicios de FINRA pueden no estar expuestos a través de la API en absoluto, y la API fileX no está soportada explícitamente en este momento. El desarrollo se gestiona a través de issues de GitHub, se aceptan informes de errores y solicitudes de características, aunque actualmente no se aceptan pull requests. El autor también anuncia servicios de consultoría relacionados con integraciones de la API de FINRA, migraciones de Web EFT, flujos de trabajo relacionados con cumplimiento y sistemas de datos de mercado. El proyecto incluye insignias de CI y cobertura y describe la cobertura de pruebas en Windows, macOS y Linux. El README incluye una descargo de responsabilidad que indica que la biblioteca es no oficial y no está respaldada, afiliada ni patrocinada por FINRA, que no ofrece asesoramiento financiero ni estrategias de trading, y que los usuarios son responsables de cumplir con los términos de servicio de la API subyacente. Se distribuye bajo un archivo LICENSE sin garantía. Para fines de clasificación, esta biblioteca se ubica mejor bajo developer-tools como una biblioteca cliente de backend/API, con data-integration como un ajuste secundario dado su uso práctico de extraer conjuntos de datos regulatorios y de mercado hacia otros sistemas.