Obtenir les éléments d'un document SEC
Financial Data
Company fundamentals, financial statements, market prices and economic data.
Obtenir les éléments d'un document SEC
Le texte intégral des éléments numérotés d'un document SEC. ticker, filing_type (10-K, 10-Q ou 8-K) et year sont tous obligatoires ; affinez avec quarter, item, accession_number ou include_exhibits. Renvoie items — chacun avec number, title et le text complet —, plus filing_url et accession_number. Attention à la taille : un 10-K revient sous la forme d'environ 19 éléments de prose complète, donc demandez un item précis plutôt que tout extraire, sauf si vous avez vraiment besoin du document entier. Pour trouver quel document ouvrir, utilisez get_financial_filings.
Référence tarifaire
- Mesure : base de coût fixe par requête réussie.
- Estimation de référence par requête : USD 0.02.
- Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.
Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.
- Type: stringaccession
_number Le numéro d'accès du dépôt s'il s'agit d'un 8-K.
- Type: string enumfiling
_type obligatoireLe type de dépôt.
valeurs- 10
- K - 10
- Q - 8
- K
- Type: booleaninclude
_exhibits Indique si le texte brut des pièces jointes liées doit être inclus. Applicable uniquement aux dépôts 8-K. Lorsque la valeur est true, les objets de pièce jointe incluront le champ 'text' contenant le contenu complet de la pièce jointe.
- Type: string enumitem
L'élément à récupérer.
valeurs- Item
-1 - Item
-1 A - Item
-1 B - Item
-2 - Item
-3
- Type: integerquarter
Le trimestre du dépôt s'il s'agit d'un 10-Q.
- Type: stringtickerobligatoire
Le symbole boursier.
- Type: integeryearobligatoire
L'année du dépôt.
- Type: object · ResponseE40Feb4D3D6B_FilingItemsResponse200
Réponse d'éléments de document SEC
- Type: stringaccession
_number Le numéro d'accession du document.
- Type: stringcik
La Central Index Key (CIK) de la société.
- Type: stringfiling
_type Le type de dépôt.
- Type: array object[] · ResponseE40Feb4D3D6B_FilingItem[]items
- exhibitsType: array object[] · ResponseE40Feb4D3D6B_Exhibit[]
Un tableau d'annexes liées à cet élément. Présent uniquement pour les documents 8-K lorsque des annexes existent.
- descriptionType: string
La description de l'annexe.
- numberType: string
Le numéro de l'annexe (par exemple '99.1').
- textType: string
Le contenu textuel brut de l'annexe. Inclus uniquement lorsque le paramètre 'include_exhibits' est défini sur true.
- urlType: string Format: uri
L'URL du document de l'annexe sur le site de la SEC.
- nameType: string
Le nom de l'élément.
- numberType: string
Le numéro de l'élément.
- textType: string
Le texte de l'élément.
- Type: integerquarter
Le trimestre du document.
- Type: stringresource
L'identifiant du type de ressource.
- Type: stringticker
Le symbole ticker de la société.
- Type: integeryear
L'année du dépôt.
application/json - Type: object · ResponseE40Feb4D3D6B_FilingItemsAccepted202
Le document est encore en préparation. Interrogez le result_url du corps de la réponse pour récupérer le résultat. Cette réponse ne vous est pas facturée.
- Type: stringaccession
_number Le numéro d'accession du document en cours de préparation.
- Type: string Format: date-timeestimated
_ready _at Quand le document devrait être prêt.
- Type: stringmessage
Description lisible de la prochaine étape à suivre.
- Type: string Format: uuidrequest
_id Identifiant de cette requête ; utile lors d'un contact avec le support.
- Type: stringresult
_url L'URL à interroger pour obtenir le résultat.
- enumstatusconstante:processing
Toujours 'processing' dans une réponse 202.
valeurs- processing
application/json - 400
La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
- 401
Une clé API Felo valide est requise.
- 402
La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
- 403
Le compte n'est pas autorisé à effectuer cette opération.
- 429
Une limite de requêtes ou de dépenses a été atteinte.
- 502
Le service n'a pas pu terminer la requête.
- 503
L'API ou le service de facturation est temporairement indisponible.
- 504
Le service a expiré lors du traitement de la requête.
- default
Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur
application/json
curl 'https://openapi.felo.ai/v1/beta/financial/filings/items?filing_type=10-K&ticker=&year=1' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"resource": "string",
"ticker": "string",
"cik": "string",
"filing_type": "string",
"accession_number": "string",
"year": 1,
"quarter": 1,
"items": [
{
"number": "string",
"name": "string",
"text": "string",
"exhibits": [
{
"number": "string",
"description": "string",
"url": "https://example.com",
"text": "string"
}
]
}
]
}