Felo API PlatformFelo API Platform
Tutti gli endpoint di Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Ottieni le voci del deposito SEC

Server:https://openapi.felo.ai
Librerie client

Financial Data

​

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

Financial Data Operazioni

Ottieni le voci del deposito SEC

​

Il testo completo delle voci numerate all'interno di un deposito SEC. ticker, filing_type (10-K, 10-Q o 8-K) e year sono tutti obbligatori; restringi ulteriormente con quarter, item, accession_number o include_exhibits. Restituisce items — ciascuno con number, title e il text completo — più filing_url e accession_number. Attenzione alla dimensione: un 10-K torna come circa 19 voci di prosa completa, quindi richiedi un item specifico invece di recuperare tutto, a meno che tu non abbia davvero bisogno dell'intero documento. Per trovare prima quale deposito aprire, usa get_financial_filings.

Riferimento prezzi

  • Misurazione: base di costo fissa per richiesta riuscita.
  • Stima di riferimento per richiesta: USD 0.02.
  • Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.

Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Parametri di query
  • accession_number
    Tipo: string

    Il numero di accessione del deposito se 8-K.

  • filing_type
    Tipo: string enum
    obbligatorio

    Il tipo di deposito.

    valori
    • 10-K
    • 10-Q
    • 8-K
  • include_exhibits
    Tipo: boolean

    Se includere il testo non elaborato degli allegati collegati. Applicabile solo ai depositi 8-K. Se true, gli oggetti allegato includono il campo 'text' con il contenuto completo dell'allegato.

  • item
    Tipo: string enum

    L'elemento da recuperare.

    valori
    • Item-1
    • Item-1A
    • Item-1B
    • Item-2
    • Item-3
  • quarter
    Tipo: integer

    Il trimestre del deposito se 10-Q.

  • ticker
    Tipo: string
    obbligatorio

    Il simbolo ticker.

  • year
    Tipo: integer
    obbligatorio

    L'anno del deposito.

Risposte
  • 200
    Tipo: object · ResponseE40Feb4D3D6B_FilingItemsResponse

    Risposta delle voci del deposito SEC

    • accession_number
      Tipo: string

      Il numero di accesso del deposito.

    • cik
      Tipo: string

      Il Central Index Key (CIK) della società.

    • filing_type
      Tipo: string

      Il tipo di deposito.

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

        Un array di exhibit collegati a questo elemento. Presente solo per i depositi 8-K quando esistono exhibit.

        • description
          Tipo: string

          La descrizione dell'exhibit.

        • number
          Tipo: string

          Il numero dell'exhibit (ad es. '99.1').

        • text
          Tipo: string

          Il contenuto testuale grezzo dell'exhibit. Incluso solo quando il parametro 'include_exhibits' è impostato su true.

        • url
          Tipo: string Formato: uri

          L'URL del documento dell'exhibit sul sito della SEC.

      • name
        Tipo: string

        Il nome dell'elemento.

      • number
        Tipo: string

        Il numero dell'elemento.

      • text
        Tipo: string

        Il testo dell'elemento.

    • quarter
      Tipo: integer

      Il trimestre del deposito.

    • resource
      Tipo: string

      L'identificatore del tipo di risorsa.

    • ticker
      Tipo: string

      Il simbolo ticker dell'azienda.

    • year
      Tipo: integer

      L'anno del deposito.

    application/json
  • 202
    Tipo: object · ResponseE40Feb4D3D6B_FilingItemsAccepted

    Il deposito è ancora in preparazione. Esegui il polling del result_url dal corpo della risposta per recuperare il risultato. Questa risposta non viene addebitata.

    • accession_number
      Tipo: string

      Il numero di accesso del deposito in preparazione.

    • estimated_ready_at
      Tipo: string Formato: date-time

      Quando il deposito sarà presumibilmente pronto.

    • message
      Tipo: string

      Descrizione leggibile dei passaggi successivi.

    • request_id
      Tipo: string Formato: uuid

      Identificatore di questa richiesta; utile quando si contatta l'assistenza.

    • result_url
      Tipo: string

      L'URL da interrogare per ottenere il risultato.

    • status
      enum
      const:  
      processing

      Sempre 'processing' in una risposta 202.

      valori
      • processing
    application/json
  • 400

    Impossibile elaborare la richiesta. Controlla i parametri della richiesta.

  • 401

    È richiesta una chiave API Felo valida.

  • 402

    Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.

  • 403

    L'account non è autorizzato a eseguire questa operazione.

  • 429

    È stato raggiunto un limite di richieste o di spesa.

  • 502

    Il servizio non è riuscito a completare la richiesta.

  • 503

    L'API o il servizio di fatturazione è temporaneamente non disponibile.

  • 504

    Si è verificato un timeout durante l'elaborazione della richiesta.

  • default

    Risposta di errore; le risposte passthrough upstream possono usare formati del provider

    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