Felo API PlatformFelo API Platform
Alle Endpoints von Financial Data
v0.2.0-beta
OpenAPI 3.1.0

SEC-Einreichungspunkte abrufen

Server:https://openapi.felo.ai
Client-Bibliotheken

Financial Data

​

Company fundamentals, financial statements, market prices and economic data.

Financial Data Operationen

SEC-Einreichungspunkte abrufen

​

Der vollständige Text der nummerierten Punkte innerhalb einer SEC-Einreichung. ticker, filing_type (10-K, 10-Q oder 8-K) und year sind alle erforderlich; grenzen Sie weiter mit quarter, item, accession_number oder include_exhibits ein. Liefert items – jeweils mit number, title und dem vollständigen text – sowie filing_url und accession_number. Beachten Sie die Größe: Ein 10-K kommt als rund 19 Punkte voller Prosa zurück; fordern Sie daher einen bestimmten item an, statt alles abzurufen, es sei denn, Sie brauchen wirklich das ganze Dokument. Um überhaupt zu finden, welche Einreichung Sie öffnen sollten, nutzen Sie get_financial_filings.

Preisreferenz

  • Abrechnung: Feste Kostenbasis pro erfolgreicher Anfrage.
  • Referenzschätzung pro Anfrage: USD 0.02.
  • Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Query-Parameter
  • accession_number
    Typ: string

    Die Accession Number der Einreichung, falls 8-K.

  • filing_type
    Typ: string enum
    erforderlich

    Der Typ der Einreichung.

    Werte
    • 10-K
    • 10-Q
    • 8-K
  • include_exhibits
    Typ: boolean

    Ob der Rohtext aus verknüpften Anlagen einbezogen werden soll. Nur anwendbar auf 8-K-Einreichungen. Bei true enthalten Anlagenobjekte das Feld 'text' mit dem vollständigen Inhalt der Anlage.

  • item
    Typ: string enum

    Das abzurufende Element.

    Werte
    • Item-1
    • Item-1A
    • Item-1B
    • Item-2
    • Item-3
  • quarter
    Typ: integer

    Das Quartal der Einreichung, falls 10-Q.

  • ticker
    Typ: string
    erforderlich

    Das Tickersymbol.

  • year
    Typ: integer
    erforderlich

    Das Jahr der Einreichung.

Antworten
  • 200
    Typ: object · ResponseE40Feb4D3D6B_FilingItemsResponse

    SEC-Einreichungspunkte-Antwort

    • accession_number
      Typ: string

      Die Accession-Nummer der Einreichung.

    • cik
      Typ: string

      Der Central Index Key (CIK) des Unternehmens.

    • filing_type
      Typ: string

      Der Typ der Einreichung.

    • items
      Typ: array object[] · ResponseE40Feb4D3D6B_FilingItem[]
      • exhibits
        Typ: array object[] · ResponseE40Feb4D3D6B_Exhibit[]

        Ein Array von Exhibits, die mit diesem Element verknüpft sind. Nur bei 8-K-Einreichungen vorhanden, wenn Exhibits existieren.

        • description
          Typ: string

          Die Beschreibung des Exhibits.

        • number
          Typ: string

          Die Exhibit-Nummer (z. B. '99.1').

        • text
          Typ: string

          Der reine Textinhalt des Exhibits. Wird nur einbezogen, wenn der Parameter 'include_exhibits' auf true gesetzt ist.

        • url
          Typ: string Format: uri

          Die URL zum Exhibit-Dokument auf der SEC-Website.

      • name
        Typ: string

        Der Name des Elements.

      • number
        Typ: string

        Die Nummer des Elements.

      • text
        Typ: string

        Der Text des Elements.

    • quarter
      Typ: integer

      Das Quartal der Einreichung.

    • resource
      Typ: string

      Die Kennung des Ressourcentyps.

    • ticker
      Typ: string

      Das Tickersymbol des Unternehmens.

    • year
      Typ: integer

      Das Jahr der Einreichung.

    application/json
  • 202
    Typ: object · ResponseE40Feb4D3D6B_FilingItemsAccepted

    Die Einreichung wird noch vorbereitet. Fragen Sie die result_url aus dem Antwort-Body ab, um das Ergebnis zu erhalten. Für diese Antwort wird nichts berechnet.

    • accession_number
      Typ: string

      Die Accession-Nummer der Einreichung, die vorbereitet wird.

    • estimated_ready_at
      Typ: string Format: date-time

      Wann die Einreichung voraussichtlich bereit sein wird.

    • message
      Typ: string

      Menschenlesbare Beschreibung der nächsten Schritte.

    • request_id
      Typ: string Format: uuid

      Kennung für diese Anfrage; nützlich bei der Kontaktaufnahme mit dem Support.

    • result_url
      Typ: string

      Die URL, an der das Ergebnis abgefragt werden kann.

    • status
      enum
      Konstante:  
      processing

      Bei einer 202-Antwort immer 'processing'.

      Werte
      • processing
    application/json
  • 400

    Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.

  • 401

    Ein gültiger Felo-API-Schlüssel ist erforderlich.

  • 402

    Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.

  • 403

    Das Konto ist für diesen Vorgang nicht berechtigt.

  • 429

    Ein Anfrage- oder Ausgabenlimit wurde erreicht.

  • 502

    Der Dienst konnte die Anfrage nicht abschließen.

  • 503

    Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.

  • 504

    Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.

  • default

    Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

    application/json
Request Example for get/v1/beta/financial/filings/items
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"
        }
      ]
    }
  ]
}
Get SEC filing items