À propos du projet

finra-py est une bibliothèque client Python non officielle, open-source, qui enveloppe la plateforme API FINRA. Elle se présente comme une couche délibérément fine : les requêtes sont mappées sur l'API FINRA et les objets httpx.Response bruts sont renvoyés à l'appelant, de sorte qu'aucun modèle de réponse ou de données propriétaire n'est imposé. L'objectif déclaré est d'offrir la commodité d'un client dédié à FINRA sans renoncer au contrôle des requêtes HTTP directes. L'authentification est la principale tâche que la bibliothèque prend en charge pour l'utilisateur. L'API FINRA utilise OAuth 2.0, et finra-py gère l'acquisition et le cycle de vie des jetons, y compris un stockage de jetons personnalisable pour les applications qui conservent leurs identifiants dans leurs propres systèmes. Le README présente la couverture de trois domaines d'API : - Jeux de données de l'API Query, incluant Equity, Fixed Income, FINRA, Firm, Registration et TRACE Report Card. - Jeux de données de l'API Notification pour les événements de notification FINRA. - Flux de travail de l'API Submission pour les dépôts réglementaires et autres données, couvrant la création, la validation, la soumission, les mises à jour et la récupération pour le Form U4, le Form U5, le Form BR, Create Individual, Non-Registered Fingerprint et autres flux pris en charge. Les capacités documentées supplémentaires incluent la prise en charge de tous les types d'identifiants, les jeux de données Mock, l'API QA Test Environment, les requêtes asynchrones côté serveur et asyncio côté client. L'installation nécessite Python 3.11 ou ultérieur et se fait avec `python -m pip install finra-py` ; le package s'importe comme `import finra`. La documentation complète est hébergée séparément, avec un guide de mise en route, des notes ADR et un changelog liés depuis le README. Les limites sont clairement indiquées : bien que la bibliothèque vise une couverture complète des jeux de données documentés, certains jeux de données et services FINRA peuvent ne pas être exposés via l'API du tout, et l'API fileX n'est pas explicitement prise en charge pour le moment. Le développement est géré via les issues GitHub, avec les rapports de bogues et les demandes de fonctionnalités les bienvenus, bien que les pull requests ne soient actuellement pas acceptés. L'auteur propose également des services de conseil autour des intégrations API FINRA, des migrations Web EFT, des workflows liés à la conformité et des systèmes de données de marché. Le projet est fourni avec des badges CI et de couverture et décrit la couverture des tests sous Windows, macOS et Linux. Le README comporte une mention de non-responsabilité indiquant que la bibliothèque est non officielle et n'est ni approuvée, ni affiliée, ni sponsorisée par FINRA, qu'elle ne fournit aucun conseil financier ou stratégie de trading, et que les utilisateurs sont responsables du respect des conditions d'utilisation de l'API sous-jacente. Elle est distribuée sous un fichier LICENSE sans garantie. À des fins de classement, cette bibliothèque est idéalement placée sous developer-tools en tant que bibliothèque client backend/API, avec data-integration comme catégorie secondaire puisque son usage pratique consiste à extraire des jeux de données réglementaires et de marché vers d'autres systèmes.