Felo API PlatformFelo API Platform
Všechny endpointy Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Hledat finanční výkazy

Server:https://openapi.felo.ai
Klientské knihovny

Financial Data

​

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

Hledat finanční výkazy

​

Najde tickery odpovídající číselným podmínkám. Tělo přebírá filters — každý s field, operator a value — a limit. Vrací results s ticker, currency, sector, industry a odpovídajícím filtrovaným polem. Toto je jediný nástroj zde, který funguje bez předchozí znalosti tickeru; všechny ostatní jej přijímají jako vstup. Filtrovatelná pole jsou názvy ukazatelů, které vrací get_financial_financial_metrics. Použijte jej k sestavení seznamu kandidátů a poté u každého načtěte podrobnosti nástroji pro výkazy nebo ukazatele.

Cenová reference

  • Účtování: pevná nákladová základna za úspěšný požadavek.
  • Referenční odhad požadavku: USD 0.02.
  • Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo
povinné
application/json
  • filters
    Typ: array object[] 1…
    povinné

    Pole objektů filtrů, které se má použít pro vyhledávání.

    • field
      Typ: string
      povinné

      Kritéria filtrování. U polí finančních ukazatelů používejte operátory 'gt', 'lt', 'gte', 'lte', 'eq'. U polí 'ticker' a 'cik' používejte operátor 'in' pro filtrování podle více hodnot.

    • operator
      Typ: string enum
      povinné

      Operátor porovnání. Operátor 'in' lze použít pouze s hodnotou pole 'ticker' nebo 'cik' a umožňuje filtrovat podle více hodnot.

      hodnoty
      • gt
      • lt
      • gte
      • lte
      • eq
      • in
    • value
      povinné
      • Typ: number

        Hodnota pro porovnání u jednoargumentových operátorů (gt, lt, gte, lte, eq)

  • limit
    Typ: integer
    min:  
    1

    Maximální počet výsledků, které se mají vrátit.

Odpovědi
  • 200
    Typ: object · ResponseE40Feb4D3D6B_FinancialsSearchResponse

    Úspěšná odpověď hledání

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

        Měna finančních údajů.

      • period
        Typ: string enum

        Časové období finančních údajů.

        hodnoty
        • annual
        • quarterly
        • ttm
      • report_period
        Typ: string Formát: date

        Vykazované období finančních údajů.

      • ticker
        Typ: string

        Symbol tickeru společnosti.

      • propertyName
        Typ: string

        Další finanční ukazatele na základě kritérií vyhledávání.

    application/json
  • 400

    Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.

  • 401

    Je vyžadován platný API klíč Felo.

  • 402

    V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.

  • 403

    Účet nemá oprávnění tuto operaci provést.

  • 429

    Byl dosažen limit požadavků nebo útraty.

  • 502

    Služba nemohla požadavek dokončit.

  • 503

    API nebo fakturační služba je dočasně nedostupná.

  • 504

    Při zpracování požadavku vypršel časový limit služby.

  • default

    Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

    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