Séries

Fundamentos de um ativo

Indicadores fundamentalistas de uma ação, FII ou ETF: valor de mercado, P/L, P/VP, dividend yield, margens e retorno sobre o patrimônio.

GEThttps://api.fintay.com.br/v1/series/{source}/{code}/fundamentals

Autorização

X-API-Keystringheaderobrigatório

Chave de API criada em API Keys. Veja Chaves e limites.

Parâmetros de rota

sourcestringobrigatório

Use b3.

codestringobrigatório

Ticker do ativo.

Parâmetros de consulta

limitintegerpadrão: 1mín. 1 · máx. 30

Quantidade de retratos, do mais recente para trás.

Resposta

Envelope { success, data, meta }. Campos de data:

series_idstring

Exemplo: 34f27cc6-1076-46c0-aeb7-b5e85499b799

profileobject

snapshotsobject[]

GETFundamentos de um ativo

curl "https://api.fintay.com.br/v1/series/b3/PETR4/fundamentals?limit=1" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
    "profile": {
      "ticker": "PETR4",
      "asset_group": "stock",
      "quote_type": null,
      "long_name": "Petroleo Brasileiro SA Pfd",
      "short_name": "PETR4",
      "currency": "BRL",
      "exchange": null,
      "market": null,
      "sector": "Energia",
      "industry": "Petróleo e Gás Integrado",
      "website": "https://petrobras.com.br",
      "country": null,
      "long_business_summary": "A Petróleo Brasileiro S.A. (Petrobras) é uma sociedade de economia mista brasileira, controlada pela União Federal, com ações negociadas na B3 (PETR3/PETR4) e ADRs na NYSE (PBR/PBR.A). Fundada em 1953, a companhia atua de forma integrada na cadeia de óleo, gás e energia, com foco…",
      "logo_url": "/v1/public/logos/PETR4.svg",
      "regular_market_source": null,
      "updated_at": "2026-10-10T06:21:01.910310Z"
    },
    "snapshots": [
      {
        "snapshot_date": "2026-10-09",
        "fetched_at": "2026-10-10T06:21:01.910310Z",
        "market_cap": 755566433692,
        "enterprise_value": 1337586000000,
        "total_revenue": 548493000000,
        "ebitda": 273323000000,
        "net_income_to_common": 133376000000,
        "total_cash": 53764000000,
        "total_debt": 676283000000,
        "total_cash_per_share": 4.1713953,
        "debt_to_equity": 1.40614,
        "current_ratio": 0.8544373,
        "quick_ratio": 0.57706815,
        "revenue_growth": 0.11228661,
        "earnings_growth": 0.7238277,
        "gross_margins": 0.5059536,
        "ebitda_margins": 0.4983163,
        "operating_margins": 0.3386479,
        "profit_margins": 0.2438609,
        "return_on_assets": 0.10457702,
        "return_on_equity": 0.27731782,
        "price_to_earnings": 5.41151687,
        "forward_pe": null,
        "price_to_book": 1.4867802,
        "book_value": 37.315536,
        "earnings_per_share": 10.3482633,
        "dividend_yield": 0.07,
        "payout_ratio": null,
        "beta": 0.47338906,
        "fifty_two_week_low": 29.31,
        "fifty_two_week_high": 56.8,
        "target_mean_price": null,
        "target_high_price": null,
        "target_low_price": null,
        "recommendation_key": null,
        "recommendation_mean": null
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}