Calculateur de flottant

Si les actions restreintes dépassent le total des actions en circulation, la tâche échoue avec invalid_input au lieu d'inventer un flottant négatif.

Ce qu'est le flottant et comment l'on soustrait restreints et initiés

L'identité est free_float égal à shares_outstanding moins restricted_shares moins insider_holdings. Le endpoint ne récupère ni dépôts, ni tables de propriété bénéficiaire, ni cotations en direct ; il applique les trois nombres que vous avez déjà extraits afin que les corrigés, les widgets d'atterrissage et l'automatisation partagent un seul chiffre public d'actions auditable.

Contrat d'entrée, forme de la réponse et comportement d'erreur

Si les restreintes plus les initiés dépassent les titres en circulation, la tâche échoue aussi car le flottant ne peut pas être négatif. Une validation en échec ne consomme pas de solde, ce qui maintient bon marché les scripts d'exploration lorsque vous envoyez volontairement un bloc restreint plus grand que les titres en circulation pour confirmer le chemin d'erreur. Envoyez par POST un corps JSON avec trois nombres finis obligatoires. shares_outstanding (alias total_shares, outstanding_shares, shares, number_of_shares et shares_issued) est le nombre de départ et le dénominateur du pourcentage ; il doit être un nombre fini strictement supérieur à zéro. restricted_shares (alias restricted, restricted_stock et lockup_shares) est le bloc non négociable et doit être fini et supérieur ou égal à zéro. insider_holdings (alias insider_shares, insiders et insider_ownership) est le bloc d'affiliés soustrait après les restreintes et doit être fini et supérieur ou égal à zéro. En cas de succès le corps répète shares_outstanding, restricted_shares et insider_holdings, puis free_float comme nombre public, free_float_percent comme pour cent des titres en circulation, et une chaîne formula qui reformule que le flottant égale les titres en circulation moins les restreintes moins les initiés. Exemple : un milliard d'actions en circulation, cent cinquante millions restreintes et cent millions de détentions d'initiés renvoient free_float sept cent cinquante millions et free_float_percent soixante-quinze. Les champs manquants, les valeurs non finies, un nombre restreint ou d'initiés négatif, ou un nombre en circulation nul ou négatif échouent avec invalid_input en nommant le champ et ne sont pas facturés. Les restreintes qui dépassent le total en circulation échouent avec un message invalid_input dédié plutôt qu'un flottant négatif. Préférez des nombres JSON simples à des chaînes avec virgules, étiquettes de classe d'actions ou signes de pour cent ; les chaînes numériques ne sont acceptées que si elles correspondent à un motif strict de nombre fini. Le tarif est un $0.002 fixe par appel réussi avec unit item.

Où un calculateur de flottant prouve son utilité

Les filtres d'indices et de liquidité utilisent le flottant plutôt que les actions pleinement diluées afin qu'un nom étroitement détenu ne soit pas traité comme si toute sa capitalisation pouvait se négocier en un jour. Les enseignants et les plateformes LMS ont besoin d'un oracle pour la question de définition qui demande de calculer le flottant à partir des titres en circulation, des restreintes et des initiés, y compris le cas où les restreintes dépassent les titres en circulation et doivent être rejetées. Utilisez cette capacité lorsque vous avez déjà les trois nombres d'actions ; si vous avez la capitalisation boursière, la dette et la trésorerie, utilisez un calculateur de valeur d'entreprise au lieu de cette identité de flottant. Les carnets de recherche actions et les fichiers de table de capitalisation stockent souvent les actions en circulation, les titres de lock-up et la détention d'initiés dans des colonnes distinctes ; un endpoint déterministe retrouve le flottant sans une cellule de tableur que quelqu'un pourrait plus tard réécrire en capitalisation boursière en multipliant les titres en circulation par le cours. Les intégrateurs branchent le endpoint sur des carnets, des outils de flux ou des workers en bordure pour figer les goldens dès qu'un dépôt met à jour le calendrier de lock-up ou qu'un Form 4 change le total d'initiés. Parce que l'implémentation est un travail analytique parse de niveau A pur, chaque appel réussi coûte le tarif de base publié $0.002 sans jetons de modèle et sans réseau sortant. Conservez shares_outstanding strictement positif, restricted_shares et insider_holdings non négatifs et dans les titres en circulation, figez les champs free_float et free_float_percent arrondis dans les tests, et vous obtenez des nombres publics reproductibles pour widgets, salles de classe et production sans dresser votre propre terminal de données actions.