> ## Documentation Index > Fetch the complete documentation index at: https://artemis.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Fetch Equity Valuation Metrics > Seven valuation ratios (daily), in one call: | Metric | Description | |---|---| | `ENTERPRISE_VALUE_DIVIDE_TOTAL_REVENUE` | EV / Revenue | | `ENTERPRISE_VALUE_DIVIDE_NET_INCOME` | EV / Earnings | | `ENTERPRISE_VALUE_DIVIDE_EBITDA` | EV / EBITDA | | `ENTERPRISE_VALUE_DIVIDE_FREE_CASH_FLOW` | EV / FCF | | `MARKET_CAP_DIVIDE_FREE_CASH_FLOW` | Price / FCF | | `EARNINGS_YIELD` | Earnings yield (1 / P/E) | | `FCF_YIELD` | Free cash flow yield | Ratios are quoted daily — `start_date` / `end_date` slice the time-series window. FCF-derived ratios (`EV/FCF`, `P/FCF`, `FCF_YIELD`) may have sparse coverage in short windows since they depend on the most recent fiscal-period FCF; widen the window if a series comes back empty. ## OpenAPI ````yaml /openapi.documented.json get /data/api/ENTERPRISE_VALUE_DIVIDE_TOTAL_REVENUE,ENTERPRISE_VALUE_DIVIDE_NET_INCOME,ENTERPRISE_VALUE_DIVIDE_EBITDA,ENTERPRISE_VALUE_DIVIDE_FREE_CASH_FLOW,MARKET_CAP_DIVIDE_FREE_CASH_FLOW,EARNINGS_YIELD,FCF_YIELD/ openapi: 3.1.0 info: title: Artemis API version: 1.0.0 description: > Enterprise API for Artemis metrics, stablecoins, and flows. ## Authentication All endpoints authenticate via an API key. The simplest pattern when using the Python SDK is to set the `ARTEMIS_API_KEY` environment variable — the SDK will pick it up automatically: ```bash export ARTEMIS_API_KEY="your-key-here" ``` ```python from artemis import Artemis client = Artemis() # reads ARTEMIS_API_KEY from env ``` Endpoints under `/data/api/*` and `/flows/top/` also accept the key as an `APIKey` query parameter — the snippets below pass `api_key=os.environ["ARTEMIS_API_KEY"]` to populate it explicitly. servers: - url: https://data-svc.artemisxyz.com security: [] tags: - name: Core Artemis Assets description: Endpoints for general asset data - name: Stablecoins description: Endpoints for stablecoin-specific metrics - name: Flows description: Endpoints for inflows, outflows, and netflows - name: Equities description: > Typed convenience endpoints for equity coverage, scoped to metrics that are **comparable across equities** (valuation ratios, core P&L line items, price). Symbols are prefixed with `eq-` — e.g. `eq-nvda`, `eq-meta`, `eq-coin`. Discover valid symbols via [List Supported Assets](#tag/Core-Artemis-Assets/operation/listAssetSymbols). Three methods: - [`fetch_price`](#tag/Equities/operation/fetchEquityPrice) — daily closing price - [`fetch_financials`](#tag/Equities/operation/fetchEquityFinancials) — 7 quarterly P&L line items (Revenue, Net Income, EBITDA, Operating Income, FCF, Basic EPS, Diluted EPS) - [`fetch_valuation_metrics`](#tag/Equities/operation/fetchEquityValuationMetrics) — 7 valuation ratios (EV/Revenue, EV/Earnings, EV/EBITDA, EV/FCF, P/FCF, Earnings Yield, FCF Yield) **The long tail lives elsewhere.** Artemis tracks many more equity metrics under the hood — company-specific KPIs (Trading Volume for COIN, DAP/ARPP for META, Data Center Revenue for NVDA), regional breakdowns, segment-level revenue, and so on. Discover what's available for a given symbol via [List Available Metrics](#tag/Core-Artemis-Assets/operation/listSupportedMetrics), then query via the generic [Fetch Metrics](#tag/Core-Artemis-Assets/operation/fetchMetrics) endpoint. - name: Insights description: > Pre-computed insight cards across Artemis's coverage — "asset X's metric Y hit a new all-time high", growth streaks, decline streaks, and accelerating trends. Each endpoint returns a feed of cards covering crypto protocols, stablecoins, and equities in one response. This is the same data rendered on [artemis.ai/insights](https://www.artemis.ai/insights). Five card-producing endpoints, all parameterless `GET`s: - [`list_all_time_highs`](#tag/Insights/operation/listAthInsights) — new ATH events - [`list_all_time_lows`](#tag/Insights/operation/listAtlInsights) — new ATL events - [`list_growth_streaks`](#tag/Insights/operation/listStreakInsights) — N consecutive periods of growth - [`list_decline_streaks`](#tag/Insights/operation/listDeclineStreakInsights) — N consecutive periods of decline - [`list_acceleration_signals`](#tag/Insights/operation/listAccelerationInsights) — rate of change itself accelerating **Caching.** Each endpoint is cached server-side for one hour. The first call after cache expiry can take up to a minute as the underlying Snowflake query runs; subsequent calls within the hour are sub-second. paths: /data/api/ENTERPRISE_VALUE_DIVIDE_TOTAL_REVENUE,ENTERPRISE_VALUE_DIVIDE_NET_INCOME,ENTERPRISE_VALUE_DIVIDE_EBITDA,ENTERPRISE_VALUE_DIVIDE_FREE_CASH_FLOW,MARKET_CAP_DIVIDE_FREE_CASH_FLOW,EARNINGS_YIELD,FCF_YIELD/: get: tags: - Equities summary: Fetch Equity Valuation Metrics description: > Seven valuation ratios (daily), in one call: | Metric | Description | |---|---| | `ENTERPRISE_VALUE_DIVIDE_TOTAL_REVENUE` | EV / Revenue | | `ENTERPRISE_VALUE_DIVIDE_NET_INCOME` | EV / Earnings | | `ENTERPRISE_VALUE_DIVIDE_EBITDA` | EV / EBITDA | | `ENTERPRISE_VALUE_DIVIDE_FREE_CASH_FLOW` | EV / FCF | | `MARKET_CAP_DIVIDE_FREE_CASH_FLOW` | Price / FCF | | `EARNINGS_YIELD` | Earnings yield (1 / P/E) | | `FCF_YIELD` | Free cash flow yield | Ratios are quoted daily — `start_date` / `end_date` slice the time-series window. FCF-derived ratios (`EV/FCF`, `P/FCF`, `FCF_YIELD`) may have sparse coverage in short windows since they depend on the most recent fiscal-period FCF; widen the window if a series comes back empty. operationId: fetchEquityValuationMetrics parameters: - in: query name: symbols schema: type: string required: true description: Comma-separated list of equity symbols (e.g. `eq-nvda,eq-meta`). example: eq-nvda - in: query name: startDate schema: type: string format: date description: Start date in YYYY-MM-DD format example: '2024-01-01' - in: query name: endDate schema: type: string format: date description: End date in YYYY-MM-DD format example: '2024-12-31' - $ref: '#/components/parameters/Granularity' - $ref: '#/components/parameters/Limit' - in: query name: APIKey schema: type: string required: true description: Your Artemis API key responses: '200': description: >- Equity valuation ratios time-series, keyed by metric name within each symbol. content: application/json: schema: $ref: '#/components/schemas/DataResponse' example: data: symbols: eq-nvda: ENTERPRISE_VALUE_DIVIDE_TOTAL_REVENUE: - date: '2024-09-30' val: 26.38 - date: '2024-10-01' val: 26.21 ENTERPRISE_VALUE_DIVIDE_NET_INCOME: - date: '2024-09-30' val: 47.37 - date: '2024-10-01' val: 47.06 ENTERPRISE_VALUE_DIVIDE_EBITDA: - date: '2024-09-30' val: 40.94 - date: '2024-10-01' val: 40.68 EARNINGS_YIELD: - date: '2024-09-30' val: 2.12 - date: '2024-10-01' val: 2.13 x-codeSamples: - lang: python source: | import os from datetime import date from artemis import Artemis client = Artemis() response = client.equity.fetch_valuation_metrics( api_key=os.environ["ARTEMIS_API_KEY"], symbols="eq-nvda", start_date=date(2024, 1, 1), end_date=date(2024, 12, 31), ) # Latest reading for each valuation ratio: metrics = response.data.symbols["eq-nvda"] headline = { "ENTERPRISE_VALUE_DIVIDE_TOTAL_REVENUE": "EV / Revenue", "ENTERPRISE_VALUE_DIVIDE_NET_INCOME": "EV / Earnings", "ENTERPRISE_VALUE_DIVIDE_EBITDA": "EV / EBITDA", "EARNINGS_YIELD": "Earnings Yield (%)", "FCF_YIELD": "FCF Yield (%)", } for key, label in headline.items(): series = metrics.get(key) or [] if series: print(f"{label:25} {series[-1].val:.2f}") components: parameters: Granularity: name: granularity in: query description: Time-bucket granularity for returned series. schema: type: string enum: - DAY - WEEK - MONTH - QUARTER - YEAR default: DAY Limit: name: limit in: query description: Maximum number of data points to return (1–1000). schema: type: integer minimum: 1 maximum: 1000 schemas: DataResponse: type: object properties: data: type: object properties: symbols: $ref: '#/components/schemas/SymbolsData' required: - symbols required: - data SymbolsData: type: object additionalProperties: $ref: '#/components/schemas/SymbolMetrics' description: >- Object where keys are symbol names (e.g., 'btc', 'eth') and values are their metric data SymbolMetrics: type: object additionalProperties: $ref: '#/components/schemas/MetricDataArray' description: >- Object where keys are metric names (e.g., 'price', 'mc', 'dau') and values are arrays of data points MetricDataArray: type: array items: $ref: '#/components/schemas/MetricDataPoint' MetricDataPoint: type: object properties: date: type: string format: date val: type: number required: - date - val ````