Felo API PlatformFelo API Platform
Wszystkie endpointy Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Wyszukaj sprawozdania finansowe

Serwer:https://openapi.felo.ai
Biblioteki klienckie

Financial Data

​

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

Wyszukaj sprawozdania finansowe

​

Znajduje tickery spełniające warunki liczbowe. Treść przyjmuje filters — każdy z field, operator i value — oraz limit. Zwraca results z ticker, currency, sector, industry i dopasowanym polem filtra. To jedyne narzędzie tutaj, które działa bez wcześniejszej znajomości tickera; wszystkie pozostałe przyjmują go jako dane wejściowe. Filtrowalne pola to nazwy metryk zwracane przez get_financial_financial_metrics. Używaj go do zbudowania listy kandydatów, a następnie pobierz szczegóły każdej spółki narzędziami sprawozdań lub metryk.

Cennik referencyjny

  • Rozliczanie: stała podstawa kosztu za udane żądanie.
  • Szacunek referencyjny dla żądania: USD 0.02.
  • Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść
wymagane
application/json
  • filters
    Typ: array object[] 1…
    wymagane

    Tablica obiektów filtrów do zastosowania w wyszukiwaniu.

    • field
      Typ: string
      wymagane

      Kryteria filtrowania. W przypadku pól wskaźników finansowych używaj operatorów 'gt', 'lt', 'gte', 'lte', 'eq'. W przypadku pól 'ticker' i 'cik' używaj operatora 'in', aby filtrować według wielu wartości.

    • operator
      Typ: string enum
      wymagane

      Operator porównania. Operatora 'in' można używać tylko z wartością pola 'ticker' lub 'cik' i pozwala filtrować według wielu wartości.

      wartości
      • gt
      • lt
      • gte
      • lte
      • eq
      • in
    • value
      wymagane
      • Typ: number

        Wartość do porównania dla operatorów jednoargumentowych (gt, lt, gte, lte, eq)

  • limit
    Typ: integer
    min.:  
    1

    Maksymalna liczba wyników do zwrócenia.

Odpowiedzi
  • 200
    Typ: object · ResponseE40Feb4D3D6B_FinancialsSearchResponse

    Pomyślna odpowiedź wyszukiwania

    • search_results
      Typ: array object[]
      • currency
        Typ: string

        Waluta danych finansowych.

      • period
        Typ: string enum

        Okres danych finansowych.

        wartości
        • annual
        • quarterly
        • ttm
      • report_period
        Typ: string Format: date

        Okres sprawozdawczy danych finansowych.

      • ticker
        Typ: string

        Symbol tickera spółki.

      • propertyName
        Typ: string

        Dodatkowe wskaźniki finansowe na podstawie kryteriów wyszukiwania.

    application/json
  • 400

    Nie można przetworzyć żądania. Sprawdź parametry żądania.

  • 401

    Wymagany jest prawidłowy klucz API Felo.

  • 402

    Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.

  • 403

    Konto nie ma uprawnień do wykonania tej operacji.

  • 429

    Osiągnięto limit żądań lub wydatków.

  • 502

    Usługa nie mogła ukończyć żądania.

  • 503

    API lub usługa rozliczeniowa jest tymczasowo niedostępna.

  • 504

    Upłynął limit czasu usługi podczas przetwarzania żądania.

  • default

    Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

    application/json
Request Example for post/v1/beta/financial/financials/search/screener
curl https://openapi.felo.ai/v1/beta/financial/financials/search/screener \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "limit": 10,
  "filters": [
    {
      "field": "",
      "operator": "gt",
      "value": 1
    }
  ]
}'
{
  "search_results": [
    {
      "ticker": "string",
      "report_period": "2026-10-26",
      "period": "annual",
      "currency": "string",
      "additionalProperty": "string"
    }
  ]
}
Search financial statements