Skip to content
noxstock
API referenceEndpointsFinancials

Get fundamentals

GET/v2/fundamentals

Curated income statement, balance sheet, and cash flow rows for quarterly or annual periods, including margins, returns, growth, and quality fields where reliable.

Access: Starter and Builder.

Authorization

ApiKeyAuth
X-API-Key<token>

noxstock API key from the dashboard.

In: header

Query Parameters

symbol*Symbol

Ticker symbol. Case-insensitive; share-class dots are normalized to dashes (BRK.B == BRK-B). Returns SYMBOL_UNKNOWN when the symbol is outside the supported universe.

period?|

Reporting cadence: quarter (default, last 8 quarters) or annual (last 5 fiscal years).

Header Parameters

X-API-Key?string|null

Response Body

application/json

application/json

curl -X GET "https://example.com/v2/fundamentals?symbol=AAPL"
{
  "data": {
    "as_of": "string",
    "balance_sheet": [
      {
        "cash_and_equivalents": 0,
        "common_shares_outstanding": 0,
        "current_assets": 0,
        "current_liabilities": 0,
        "fiscal_period": "string",
        "fiscal_year": 0,
        "intangibles": 0,
        "inventory": 0,
        "long_term_debt": 0,
        "long_term_investments": 0,
        "net_debt": 0,
        "period_end": "string",
        "ppe_net": 0,
        "ratios": {
          "current_ratio": 0,
          "debt_to_assets": 0,
          "debt_to_equity": 0,
          "interest_coverage": 0,
          "net_debt_to_ebitda": 0
        },
        "receivables": 0,
        "retained_earnings": 0,
        "short_term_investments": 0,
        "tangible_book_value": 0,
        "total_assets": 0,
        "total_debt": 0,
        "total_equity": 0,
        "total_liabilities": 0
      }
    ],
    "cache_age_seconds": 0,
    "cash_flow": [
      {
        "acquisitions": 0,
        "buybacks": 0,
        "capex": 0,
        "dividends_paid": 0,
        "fcf_margin_pct": 0,
        "fcf_yoy_pct": 0,
        "financing_cash_flow": 0,
        "fiscal_period": "string",
        "fiscal_year": 0,
        "free_cash_flow": 0,
        "investing_cash_flow": 0,
        "ocf_yoy_pct": 0,
        "operating_cash_flow": 0,
        "period_end": "string",
        "stock_based_comp": 0,
        "working_capital_change": 0
      }
    ],
    "currency": "USD",
    "freshness": "intraday",
    "income_statement": [
      {
        "cost_of_revenue": 0,
        "depreciation_amortization": 0,
        "ebitda": 0,
        "eps_basic": 0,
        "eps_diluted": 0,
        "fiscal_period": "string",
        "fiscal_year": 0,
        "gross_profit": 0,
        "growth": {
          "eps_yoy_pct": 0,
          "net_income_yoy_pct": 0,
          "revenue_qoq_pct": 0,
          "revenue_yoy_pct": 0
        },
        "income_tax": 0,
        "interest_coverage": 0,
        "interest_expense": 0,
        "investment": {
          "capex_intensity_3y_avg_pct": 0,
          "capex_intensity_pct": 0
        },
        "margins": {
          "ebitda_margin_pct": 0,
          "gross_margin_pct": 0,
          "net_margin_pct": 0,
          "operating_margin_pct": 0
        },
        "net_income": 0,
        "operating_expense": 0,
        "operating_income": 0,
        "period_end": "string",
        "pretax_income": 0,
        "quality": {
          "piotroski_f_score": 0,
          "piotroski_status": {
            "available": true
          }
        },
        "revenue": 0,
        "rnd_expense": 0,
        "sga_expense": 0,
        "shares_basic": 0,
        "shares_diluted": 0
      }
    ],
    "market_status": "open",
    "period": "quarter",
    "symbol": "string",
    "ttm": {
      "eps_diluted_ttm": 0,
      "flags": [
        "string"
      ],
      "net_income_ttm_usd": 0,
      "net_profit_margin_pct": 0,
      "revenue_ttm_usd": 0,
      "roa_pct": 0,
      "roce_pct": 0,
      "roe_pct": 0,
      "roic_pct": 0
    }
  }
}
Empty
Empty
{
  "detail": [
    {
      "ctx": {},
      "input": null,
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
Empty
Empty