{ "openapi": "3.1.0", "info": { "title": "Artemis API", "version": "1.0.0", "description": "Enterprise API for Artemis metrics, stablecoins, and flows.\n\n## Authentication\n\nAll 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:\n\n```bash\nexport ARTEMIS_API_KEY=\"your-key-here\"\n```\n\n```python\nfrom artemis import Artemis\nclient = Artemis() # reads ARTEMIS_API_KEY from env\n```\n\nEndpoints 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.\n" }, "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).\n\nThree methods:\n\n- [`fetch_price`](#tag/Equities/operation/fetchEquityPrice) — daily closing price\n- [`fetch_financials`](#tag/Equities/operation/fetchEquityFinancials) — 7 quarterly P&L line items (Revenue, Net Income, EBITDA, Operating Income, FCF, Basic EPS, Diluted EPS)\n- [`fetch_valuation_metrics`](#tag/Equities/operation/fetchEquityValuationMetrics) — 7 valuation ratios (EV/Revenue, EV/Earnings, EV/EBITDA, EV/FCF, P/FCF, Earnings Yield, FCF Yield)\n\n**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.\n" }, { "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).\n\nFive card-producing endpoints, all parameterless `GET`s:\n\n- [`list_all_time_highs`](#tag/Insights/operation/listAthInsights) — new ATH events\n- [`list_all_time_lows`](#tag/Insights/operation/listAtlInsights) — new ATL events\n- [`list_growth_streaks`](#tag/Insights/operation/listStreakInsights) — N consecutive periods of growth\n- [`list_decline_streaks`](#tag/Insights/operation/listDeclineStreakInsights) — N consecutive periods of decline\n- [`list_acceleration_signals`](#tag/Insights/operation/listAccelerationInsights) — rate of change itself accelerating\n\n**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.\n" } ], "servers": [ { "url": "https://data-svc.artemisxyz.com" } ], "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key" } }, "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": { "AssetSymbol": { "type": "object", "properties": { "artemis_id": { "type": "string" }, "symbol": { "type": "string" }, "coingecko_id": { "type": [ "string", "null" ] }, "title": { "type": "string" }, "color": { "type": "string" } }, "required": [ "artemis_id", "symbol", "title" ] }, "AssetSymbolsResponse": { "type": "object", "properties": { "assets": { "type": "array", "items": { "$ref": "#/components/schemas/AssetSymbol" } } }, "required": [ "assets" ] }, "MetricDataPoint": { "type": "object", "properties": { "date": { "type": "string", "format": "date" }, "val": { "type": "number" } }, "required": [ "date", "val" ] }, "MetricDataArray": { "type": "array", "items": { "$ref": "#/components/schemas/MetricDataPoint" } }, "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" }, "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" }, "DataResponse": { "type": "object", "properties": { "data": { "type": "object", "properties": { "symbols": { "$ref": "#/components/schemas/SymbolsData" } }, "required": [ "symbols" ] } }, "required": [ "data" ] }, "MetricTag": { "type": "object", "properties": { "value": { "type": "string" }, "label": { "type": "string" } } }, "MetricDefinition": { "type": "object", "properties": { "label": { "type": "string" }, "tags": { "type": "array", "items": { "$ref": "#/components/schemas/MetricTag" } }, "internal_data_source": { "type": "string" }, "aggregation_type": { "type": "string" }, "unit": { "type": "string" }, "description": { "type": "string" }, "base_metric": { "type": [ "string", "null" ] }, "accepts_date": { "type": "boolean" }, "cuts": { "type": "array", "items": { "type": "object", "properties": { "granularity": { "type": "string" }, "dimension_type": { "type": "string" } } } }, "thumbnail_url": { "type": [ "string", "null" ] }, "source_link": { "type": [ "string", "null" ] }, "source": { "type": "string" }, "methodology": { "type": [ "string", "null" ] }, "currency_type": { "type": [ "string", "null" ], "description": "For equity financial metrics, the reporting currency (e.g., \"USD\"). Null for non-financial metrics." }, "earliest_fiscal_period": { "type": [ "string", "null" ], "description": "For equity financial metrics, the earliest fiscal period available (e.g., \"2014-Q1\"). Null when not applicable." }, "latest_fiscal_period": { "type": [ "string", "null" ], "description": "For equity financial metrics, the most recent fiscal period available. Null when not applicable." }, "priority": { "type": [ "integer", "null" ], "description": "Display ordering hint. Null when not set." } } }, "MetricEntry": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/MetricDefinition" }, "description": "Object with a single key (metric name) mapping to its definition" }, "SupportedMetricsResponse": { "type": "object", "properties": { "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/MetricEntry" } } }, "required": [ "metrics" ] }, "StablecoinMetricData": { "type": "object", "additionalProperties": { "type": "array", "items": { "$ref": "#/components/schemas/MetricDataPoint" } }, "description": "Object where keys are metric names and values are arrays of data points" }, "StablecoinDataResponse": { "type": "object", "properties": { "data": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/StablecoinMetricData" }, "description": "Object where keys are symbol names (e.g., 'eth', 'sol') and values contain metric data" } }, "required": [ "data" ] }, "FlowsChainData": { "type": "object", "additionalProperties": { "type": "number" }, "description": "Object where keys are chain names and values are flow amounts" }, "FlowsResponse": { "type": "object", "properties": { "netflow": { "$ref": "#/components/schemas/FlowsChainData" }, "inflow": { "$ref": "#/components/schemas/FlowsChainData" }, "outflow": { "$ref": "#/components/schemas/FlowsChainData" } }, "description": "Response containing flow data by chain. Properties present depend on flowType parameter." }, "InsightSparklinePoint": { "type": "object", "properties": { "date": { "type": "string", "format": "date" }, "value": { "type": [ "number", "null" ] } }, "required": [ "date", "value" ] }, "InsightExtremeCard": { "type": "object", "description": "An insight card for a new all-time high or all-time low event.", "properties": { "DOMAIN": { "type": "string", "description": "Coverage bucket for the entity (e.g. `protocol`, `stablecoin_per_chain`, `equity`)." }, "ENTITY_ID": { "type": "string", "description": "Entity identifier (e.g. `ethereum`, `usdc-eth`, `RKT`)." }, "METRIC_NAME": { "type": "string" }, "HORIZON": { "type": "string", "description": "Aggregation horizon: `daily`, `weekly`, `monthly`, or `quarterly`." }, "UNIT": { "type": "string" }, "METRIC_TYPE": { "type": "string" }, "NEW_VALUE": { "type": "number" }, "NEW_DATE": { "type": "string", "format": "date" }, "PREVIOUS_ATH_VALUE": { "type": [ "number", "null" ], "description": "Previous all-time-high value. Present only on `/insights/ath/` cards; null on ATL cards." }, "PREVIOUS_ATH_DATE": { "type": [ "string", "null" ], "format": "date" }, "PREVIOUS_ATL_VALUE": { "type": [ "number", "null" ], "description": "Previous all-time-low value. Present only on `/insights/atl/` cards; null on ATH cards." }, "PREVIOUS_ATL_DATE": { "type": [ "string", "null" ], "format": "date" }, "PERCENT_ABOVE_PREVIOUS": { "type": [ "number", "null" ], "description": "Percent above the previous ATH (ATH cards only)." }, "PERCENT_BELOW_PREVIOUS": { "type": [ "number", "null" ], "description": "Percent below the previous ATL (ATL cards only)." }, "PERIOD_END_DATE": { "type": [ "string", "null" ], "format": "date", "description": "Fiscal period end date (equity cards only)." }, "FISCAL_YEAR": { "type": [ "number", "null" ], "description": "Fiscal year (equity cards only)." }, "FISCAL_PERIOD": { "type": [ "string", "null" ], "description": "Fiscal period label such as `Q3` (equity cards only)." }, "REPORT_DATE": { "type": [ "string", "null" ], "format": "date" }, "SPARKLINE": { "type": "array", "items": { "$ref": "#/components/schemas/InsightSparklinePoint" } } }, "required": [ "DOMAIN", "ENTITY_ID", "METRIC_NAME", "HORIZON", "NEW_VALUE", "NEW_DATE", "SPARKLINE" ] }, "InsightTrendCard": { "type": "object", "description": "An insight card for a growth streak, decline streak, or accelerating trend.", "properties": { "DOMAIN": { "type": "string" }, "ENTITY_ID": { "type": "string" }, "METRIC_NAME": { "type": "string" }, "FLAG": { "type": "string", "description": "Trend flag identifier (e.g. `streak_weekly`, `decline_streak_monthly`, `accel_quarterly`)." }, "UNIT": { "type": "string" }, "METRIC_TYPE": { "type": "string" }, "DURATION": { "type": "integer", "description": "Number of consecutive periods in the streak / acceleration window." }, "DATE_RANGE": { "type": "string", "description": "Human-readable date range string (e.g. `2026-04-01 to 2026-05-05`)." }, "START_VALUE": { "type": [ "number", "null" ] }, "END_VALUE": { "type": [ "number", "null" ] }, "PERIOD_START_DATE": { "type": [ "string", "null" ], "format": "date" }, "PERIOD_END_DATE": { "type": [ "string", "null" ], "format": "date" }, "FISCAL_YEAR_END": { "type": [ "number", "null" ], "description": "Fiscal year for the period end (equity cards only)." }, "FISCAL_PERIOD_END": { "type": [ "string", "null" ], "description": "Fiscal period label for the period end (equity cards only)." }, "LATEST_REPORT_DATE": { "type": [ "string", "null" ], "format": "date" }, "SPARKLINE": { "type": "array", "items": { "$ref": "#/components/schemas/InsightSparklinePoint" } } }, "required": [ "DOMAIN", "ENTITY_ID", "METRIC_NAME", "FLAG", "SPARKLINE" ] }, "InsightExtremeCardsResponse": { "type": "object", "properties": { "rows": { "type": "array", "items": { "$ref": "#/components/schemas/InsightExtremeCard" } } }, "required": [ "rows" ] }, "InsightTrendCardsResponse": { "type": "object", "properties": { "rows": { "type": "array", "items": { "$ref": "#/components/schemas/InsightTrendCard" } } }, "required": [ "rows" ] } } }, "paths": { "/asset/symbols/": { "get": { "summary": "List Supported Assets", "tags": [ "Core Artemis Assets" ], "operationId": "listAssetSymbols", "description": "Returns the complete catalog of assets supported by Artemis — covering crypto assets (chains, tokens, ecosystems, categories) and equities. Use the `symbol` (or `artemis_id`) from this list when calling [List Available Metrics](/docs/api-reference/core-artemis-assets/list-available-metrics-for-assets-by-symbol) or [Fetch Metrics](/docs/api-reference/core-artemis-assets/fetch-metrics-for-assets-by-symbol). Results are unpaged.\n", "x-codeSamples": [ { "lang": "python", "source": "from artemis import Artemis\n\nclient = Artemis()\nresponse = client.asset.list_asset_symbols()\nprint(response.assets)\n" } ], "responses": { "200": { "description": "An unpaged list of assets with simplified metadata.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssetSymbolsResponse" }, "example": { "assets": [ { "artemis_id": "aave", "symbol": "aave", "coingecko_id": "aave", "title": "Aave", "color": "#667cfc" }, { "artemis_id": "abstract", "symbol": "abstract", "coingecko_id": null, "title": "Abstract", "color": "#04db74" }, { "artemis_id": "abtc", "symbol": "eq-abtc", "coingecko_id": null, "title": "American Bitcoin", "color": "#F7931A" } ] } } } } } } }, "/supported-metrics/": { "get": { "summary": "List Available Metrics for Assets by Symbol", "tags": [ "Core Artemis Assets" ], "operationId": "listSupportedMetrics", "description": "Returns the metrics available for a given asset symbol. The metric set depends on the asset type — equities like `AAPL` expose price/volume/financials; crypto chains like `ETH` expose on-chain metrics (DAU, fees, TVL); category symbols like `mev` expose category aggregates.\n\nAccepts both crypto and equity symbols. Discover valid symbols via [List Supported Assets](/docs/api-reference/core-artemis-assets/list-supported-assets).\n", "x-codeSamples": [ { "lang": "python", "source": "from artemis import Artemis\n\nclient = Artemis()\nresponse = client.asset.list_supported_metrics(symbol=\"btc\")\nprint(response.metrics)\n" } ], "parameters": [ { "in": "query", "name": "symbol", "schema": { "type": "string" }, "required": true, "description": "The symbol to get supported metrics for (e.g., \"BTC\")", "example": "btc" } ], "responses": { "200": { "description": "Available metrics for the given symbol", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupportedMetricsResponse" }, "example": { "metrics": [ { "24H_VOLUME": { "label": "Daily Token Trading Volume", "description": "Token Trading Volume in the last 24 hours", "tags": [ { "value": "market_data", "label": "Market Data" } ], "aggregation_type": "SUM", "unit": "CURRENCY", "internal_data_source": "coingecko", "source": "Source: Coingecko", "base_metric": null, "accepts_date": false, "cuts": [ { "granularity": "DAY", "dimension_type": "TOTAL" } ], "thumbnail_url": null, "source_link": null, "methodology": null, "currency_type": null, "earliest_fiscal_period": null, "latest_fiscal_period": null, "priority": null } }, { "PRICE": { "label": "Price", "description": "Token closing price", "tags": [ { "value": "market_data", "label": "Market Data" } ], "aggregation_type": "LAST", "unit": "CURRENCY", "internal_data_source": "coingecko", "source": "Source: Coingecko", "base_metric": null, "accepts_date": true, "cuts": [ { "granularity": "DAY", "dimension_type": "TOTAL" } ], "thumbnail_url": null, "source_link": null, "methodology": null, "currency_type": null, "earliest_fiscal_period": null, "latest_fiscal_period": null, "priority": null } } ] } } } } } } }, "/data/api/{metricNames}/": { "get": { "summary": "Fetch Metrics for Assets by Symbol", "tags": [ "Core Artemis Assets" ], "operationId": "fetchMetrics", "description": "Universal time-series endpoint. Works for **both crypto and equity assets** — pass any symbol from [List Supported Assets](/docs/api-reference/core-artemis-assets/list-supported-assets) (e.g. `btc`, `eth`, `usdc`, `eq-nvda`, `eq-meta`) and any metric name from [List Available Metrics](/docs/api-reference/core-artemis-assets/list-available-metrics-for-assets-by-symbol) for that symbol.\n\nThis is the **escape hatch** for any metric not exposed via a typed convenience method:\n- Stablecoin endpoints (`STABLECOIN_DAU`, `STABLECOIN_SUPPLY`, etc.) are wrappers around this same route.\n- Equity convenience methods (`fetch_price`, `fetch_financials`, `fetch_valuation_metrics`) cover universal/comparable metrics only. For company-specific or long-tail metrics — e.g. NVDA's `DATA_CENTER_REVENUE`, META's `FAMILY_DAILY_ACTIVE_PEOPLE`, COIN's `TRADING_VOLUME` — query them here directly.\n\nMultiple metrics can be packed into a single call as comma-separated names (e.g. `metricNames=price,mc,dau`).\n", "x-codeSamples": [ { "lang": "python", "source": "import os\nfrom datetime import date\nfrom artemis import Artemis\n\nclient = Artemis()\nresponse = client.fetch_metrics(\n metric_names=\"PRICE\",\n api_key=os.environ[\"ARTEMIS_API_KEY\"],\n symbols=\"btc,eq-coin,eq-nvda\",\n start_date=date(2026, 1, 1),\n end_date=date(2026, 2, 1),\n)\nprint(response.data)\n" } ], "parameters": [ { "in": "path", "name": "metricNames", "schema": { "type": "string" }, "required": true, "description": "Comma-separated list of metric names (e.g., \"price,mc\" or \"dau\")", "example": "PRICE" }, { "in": "query", "name": "symbols", "schema": { "type": "string" }, "required": true, "description": "Comma-separated list of symbols. Accepts crypto symbols (e.g., `btc`, `eth`) and equity symbols prefixed with `eq-` (e.g., `eq-coin`, `eq-nvda`).", "example": "btc,eq-coin,eq-nvda" }, { "in": "query", "name": "startDate", "schema": { "type": "string", "format": "date" }, "required": true, "description": "Start date in YYYY-MM-DD format", "example": "2026-01-01" }, { "in": "query", "name": "endDate", "schema": { "type": "string", "format": "date" }, "required": true, "description": "End date in YYYY-MM-DD format", "example": "2026-02-01" }, { "in": "query", "name": "summarize", "schema": { "type": "boolean" }, "description": "When true, calculates percent change from startDate to endDate" }, { "$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": "Metric data for the requested symbols and date range", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DataResponse" }, "example": { "data": { "symbols": { "btc": { "PRICE": [ { "date": "2026-01-01", "val": 88727.670042497 }, { "date": "2026-01-02", "val": 89926.279249534 }, { "date": "2026-01-03", "val": 90593.854431804 } ] }, "eq-coin": { "PRICE": [ { "date": "2026-01-01", "val": 226.14 }, { "date": "2026-01-02", "val": 236.53 }, { "date": "2026-01-03", "val": 236.53 } ] }, "eq-nvda": { "PRICE": [ { "date": "2026-01-01", "val": 186.5 }, { "date": "2026-01-02", "val": 188.85 }, { "date": "2026-01-03", "val": 188.85 } ] } } } } } } } } } }, "/data/api/STABLECOIN_DAU/": { "get": { "summary": "Fetch Stablecoin DAU (Daily Active Users)", "tags": [ "Stablecoins" ], "operationId": "fetchStablecoinDau", "x-codeSamples": [ { "lang": "python", "source": "import os\nfrom datetime import date\nfrom artemis import Artemis\n\nclient = Artemis()\nresponse = client.stablecoin.fetch_dau(\n api_key=os.environ[\"ARTEMIS_API_KEY\"],\n symbols=\"eth,sol,arbitrum\",\n start_date=date(2026, 1, 1),\n end_date=date(2026, 2, 1),\n)\nprint(response.data)\n" } ], "description": "Fetch daily active users for stablecoins. Returns unfiltered stablecoin activity.\n\n**Dash-Separated Symbol Syntax:**\n- Simple: `eth`, `sol`, `usdc`\n- Chain-specific: `usdc-eth` (USDC metrics on Ethereum)\n- Category-specific: `mev-usdc` (USDC metrics tagged to MEV)\n- Category-chain: `payments-eth` (Payment-related activity on Ethereum)\n\nYou can query any categories, chains, or symbols individually or combine them with a dash to get the intersection.\n", "parameters": [ { "in": "query", "name": "symbols", "schema": { "type": "string" }, "required": true, "description": "Chain symbols, comma-separated. Supports dash-separated syntax (e.g., \"eth,usdc-eth,mev-usdc\")", "example": "eth,sol,arbitrum" }, { "in": "query", "name": "startDate", "schema": { "type": "string", "format": "date" }, "description": "Start date in YYYY-MM-DD format", "example": "2026-01-01" }, { "in": "query", "name": "endDate", "schema": { "type": "string", "format": "date" }, "description": "End date in YYYY-MM-DD format", "example": "2026-02-01" }, { "$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": "Stablecoin DAU data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StablecoinDataResponse" }, "example": { "data": { "symbols": { "arbitrum": { "STABLECOIN_DAU": [ { "date": "2026-01-01", "val": 105741 }, { "date": "2026-01-02", "val": 122997 }, { "date": "2026-01-03", "val": 100658 } ] }, "eth": { "STABLECOIN_DAU": [ { "date": "2026-01-01", "val": 377355 }, { "date": "2026-01-02", "val": 392347 }, { "date": "2026-01-03", "val": 415781 } ] }, "sol": { "STABLECOIN_DAU": [ { "date": "2026-01-01", "val": 201603 }, { "date": "2026-01-02", "val": 309693 }, { "date": "2026-01-03", "val": 266595 } ] } } } } } } } } } }, "/data/api/STABLECOIN_DAILY_TXNS/": { "get": { "summary": "Fetch Stablecoin Daily Transactions (Unfiltered)", "tags": [ "Stablecoins" ], "operationId": "fetchStablecoinDailyTxns", "x-codeSamples": [ { "lang": "python", "source": "import os\nfrom datetime import date\nfrom artemis import Artemis\n\nclient = Artemis()\nresponse = client.stablecoin.fetch_daily_txns(\n api_key=os.environ[\"ARTEMIS_API_KEY\"],\n symbols=\"eth,sol,arbitrum\",\n start_date=date(2026, 1, 1),\n end_date=date(2026, 2, 1),\n)\nprint(response.data)\n" } ], "description": "Fetch daily transaction count for stablecoins. Returns unfiltered stablecoin activity.\n\n**Dash-Separated Symbol Syntax:**\n- Simple: `eth`, `sol`, `usdc`\n- Chain-specific: `usdc-eth` (USDC on Ethereum)\n- Category-specific: `mev-usdc` (USDC tagged to MEV)\n- Category-chain: `payments-eth` (Payments on Ethereum)\n", "parameters": [ { "in": "query", "name": "symbols", "schema": { "type": "string" }, "required": true, "description": "Chain symbols, comma-separated. Supports dash-separated syntax", "example": "eth,sol,usdc-eth" }, { "in": "query", "name": "startDate", "schema": { "type": "string", "format": "date" }, "description": "Start date in YYYY-MM-DD format", "example": "2026-01-01" }, { "in": "query", "name": "endDate", "schema": { "type": "string", "format": "date" }, "description": "End date in YYYY-MM-DD format", "example": "2026-02-01" }, { "$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": "Stablecoin Daily Transactions data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StablecoinDataResponse" }, "example": { "data": { "symbols": { "arbitrum": { "STABLECOIN_DAILY_TXNS": [ { "date": "2026-01-01", "val": 991648 }, { "date": "2026-01-02", "val": 1503135 }, { "date": "2026-01-03", "val": 1329611 } ] }, "eth": { "STABLECOIN_DAILY_TXNS": [ { "date": "2026-01-01", "val": 2208821 }, { "date": "2026-01-02", "val": 2126012 }, { "date": "2026-01-03", "val": 2316736 } ] }, "sol": { "STABLECOIN_DAILY_TXNS": [ { "date": "2026-01-01", "val": 5824658 }, { "date": "2026-01-02", "val": 10407971 }, { "date": "2026-01-03", "val": 11098128 } ] } } } } } } } } } }, "/data/api/ARTEMIS_STABLECOIN_DAILY_TXNS/": { "get": { "summary": "Fetch Artemis-Filtered Stablecoin Daily Transactions", "tags": [ "Stablecoins" ], "operationId": "fetchArtemisStablecoinDailyTxns", "x-codeSamples": [ { "lang": "python", "source": "import os\nfrom datetime import date\nfrom artemis import Artemis\n\nclient = Artemis()\nresponse = client.stablecoin.fetch_artemis_daily_txns(\n api_key=os.environ[\"ARTEMIS_API_KEY\"],\n symbols=\"eth,sol,arbitrum\",\n start_date=date(2026, 1, 1),\n end_date=date(2026, 2, 1),\n)\nprint(response.data)\n" } ], "description": "Fetch daily transaction count for stablecoins with Artemis filtering applied.\n\n**Artemis Filter:** Adjusted stablecoin activity is defined as deduped stablecoin activity less intra-exchange transfers and MEV. \nDe-dupping selects the largest transfer for a transaction. Intra-exchange activity is transfers between tagged addresses \nfor the same exchange (e.g., Coinbase moving money from deposit wallet to cold wallet). \nGoal: estimate \"real\" stablecoin activity.\n\n**Dash-Separated Symbol Syntax:**\n- Simple: `eth`, `sol`, `usdc`\n- Chain-specific: `usdc-eth` (USDC on Ethereum)\n- Category-specific: `mev-usdc` (USDC tagged to MEV)\n- Category-chain: `payments-eth` (Payments on Ethereum)\n", "parameters": [ { "in": "query", "name": "symbols", "schema": { "type": "string" }, "required": true, "description": "Chain symbols, comma-separated. Supports dash-separated syntax", "example": "eth,sol,usdc-eth" }, { "in": "query", "name": "startDate", "schema": { "type": "string", "format": "date" }, "description": "Start date in YYYY-MM-DD format", "example": "2026-01-01" }, { "in": "query", "name": "endDate", "schema": { "type": "string", "format": "date" }, "description": "End date in YYYY-MM-DD format", "example": "2026-02-01" }, { "$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": "Artemis-filtered stablecoin transaction data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StablecoinDataResponse" }, "example": { "data": { "symbols": { "arbitrum": { "ARTEMIS_STABLECOIN_DAILY_TXNS": [ { "date": "2026-01-01", "val": 482701 }, { "date": "2026-01-02", "val": 719969 }, { "date": "2026-01-03", "val": 505531 } ] }, "eth": { "ARTEMIS_STABLECOIN_DAILY_TXNS": [ { "date": "2026-01-01", "val": 667427 }, { "date": "2026-01-02", "val": 727604 }, { "date": "2026-01-03", "val": 699451 } ] }, "sol": { "ARTEMIS_STABLECOIN_DAILY_TXNS": [ { "date": "2026-01-01", "val": 3034415 }, { "date": "2026-01-02", "val": 4679112 }, { "date": "2026-01-03", "val": 4696384 } ] } } } } } } } } } }, "/data/api/P2P_STABLECOIN_DAILY_TXNS/": { "get": { "summary": "Fetch P2P Stablecoin Daily Transactions", "tags": [ "Stablecoins" ], "operationId": "fetchP2pStablecoinDailyTxns", "x-codeSamples": [ { "lang": "python", "source": "import os\nfrom datetime import date\nfrom artemis import Artemis\n\nclient = Artemis()\nresponse = client.stablecoin.fetch_p2p_daily_txns(\n api_key=os.environ[\"ARTEMIS_API_KEY\"],\n symbols=\"eth,sol,arbitrum\",\n start_date=date(2026, 1, 1),\n end_date=date(2026, 2, 1),\n)\nprint(response.data)\n" } ], "description": "Fetch daily transaction count for peer-to-peer stablecoin transfers.\n\n**P2P Filter:** Stablecoin activity between wallets/Externally Owned Accounts (EOAs) only.\n\n**Dash-Separated Symbol Syntax:**\n- Simple: `eth`, `sol`, `usdc`\n- Chain-specific: `usdc-eth` (USDC on Ethereum)\n- Category-specific: `mev-usdc` (USDC tagged to MEV)\n- Category-chain: `payments-eth` (Payments on Ethereum)\n", "parameters": [ { "in": "query", "name": "symbols", "schema": { "type": "string" }, "required": true, "description": "Chain symbols, comma-separated. Supports dash-separated syntax", "example": "sol,usdc-sol" }, { "in": "query", "name": "startDate", "schema": { "type": "string", "format": "date" }, "description": "Start date in YYYY-MM-DD format", "example": "2026-01-01" }, { "in": "query", "name": "endDate", "schema": { "type": "string", "format": "date" }, "description": "End date in YYYY-MM-DD format", "example": "2026-02-01" }, { "$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": "P2P stablecoin transaction data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StablecoinDataResponse" }, "example": { "data": { "symbols": { "arbitrum": { "P2P_STABLECOIN_DAILY_TXNS": [ { "date": "2026-01-01", "val": 154937 }, { "date": "2026-01-02", "val": 179701 }, { "date": "2026-01-03", "val": 152381 } ] }, "eth": { "P2P_STABLECOIN_DAILY_TXNS": [ { "date": "2026-01-01", "val": 1505032 }, { "date": "2026-01-02", "val": 1310848 }, { "date": "2026-01-03", "val": 1567937 } ] }, "sol": { "P2P_STABLECOIN_DAILY_TXNS": [ { "date": "2026-01-01", "val": 1282274 }, { "date": "2026-01-02", "val": 1321264 }, { "date": "2026-01-03", "val": 1251122 } ] } } } } } } } } } }, "/data/api/STABLECOIN_SUPPLY/": { "get": { "summary": "Fetch Stablecoin Supply", "tags": [ "Stablecoins" ], "operationId": "fetchStablecoinSupply", "x-codeSamples": [ { "lang": "python", "source": "import os\nfrom datetime import date\nfrom artemis import Artemis\n\nclient = Artemis()\nresponse = client.stablecoin.fetch_supply(\n api_key=os.environ[\"ARTEMIS_API_KEY\"],\n symbols=\"eth,sol,arbitrum\",\n start_date=date(2026, 1, 1),\n end_date=date(2026, 2, 1),\n)\nprint(response.data)\n" } ], "description": "Fetch daily supply data for stablecoins.\n\n**Dash-Separated Symbol Syntax:**\n- Simple: `eth`, `sol`, `usdc`\n- Chain-specific: `usdc-eth` (USDC on Ethereum)\n- Category-specific: `mev-usdc` (USDC tagged to MEV)\n- Category-chain: `payments-eth` (Payments on Ethereum)\n", "parameters": [ { "in": "query", "name": "symbols", "schema": { "type": "string" }, "required": true, "description": "Chain symbols, comma-separated. Supports dash-separated syntax", "example": "eth,sol,usdc-eth" }, { "in": "query", "name": "startDate", "schema": { "type": "string", "format": "date" }, "description": "Start date in YYYY-MM-DD format", "example": "2026-01-01" }, { "in": "query", "name": "endDate", "schema": { "type": "string", "format": "date" }, "description": "End date in YYYY-MM-DD format", "example": "2026-02-01" }, { "$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": "Stablecoin Supply data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StablecoinDataResponse" }, "example": { "data": { "symbols": { "arbitrum": { "STABLECOIN_SUPPLY": [ { "date": "2026-01-01", "val": 7776143922.53 }, { "date": "2026-01-02", "val": 7825324285.16 }, { "date": "2026-01-03", "val": 7813978654.57 } ] }, "eth": { "STABLECOIN_SUPPLY": [ { "date": "2026-01-01", "val": 171180625562.9 }, { "date": "2026-01-02", "val": 170963172888.72 }, { "date": "2026-01-03", "val": 171265536639.94 } ] }, "sol": { "STABLECOIN_SUPPLY": [ { "date": "2026-01-01", "val": 14853744941.37 }, { "date": "2026-01-02", "val": 15362543889.28 }, { "date": "2026-01-03", "val": 15408250144.11 } ] } } } } } } } } } }, "/data/api/STABLECOIN_TRANSFER_VOLUME/": { "get": { "summary": "Fetch Stablecoin Transfer Volume (Unfiltered)", "tags": [ "Stablecoins" ], "operationId": "fetchStablecoinTransferVolume", "x-codeSamples": [ { "lang": "python", "source": "import os\nfrom datetime import date\nfrom artemis import Artemis\n\nclient = Artemis()\nresponse = client.stablecoin.fetch_transfer_volume(\n api_key=os.environ[\"ARTEMIS_API_KEY\"],\n symbols=\"eth,sol,arbitrum\",\n start_date=date(2026, 1, 1),\n end_date=date(2026, 2, 1),\n)\nprint(response.data)\n" } ], "description": "Fetch daily transfer volume for stablecoins. Returns unfiltered stablecoin activity.\n\n**Dash-Separated Symbol Syntax:**\n- Simple: `eth`, `sol`, `usdc`\n- Chain-specific: `usdc-eth` (USDC on Ethereum)\n- Category-specific: `mev-usdc` (USDC tagged to MEV)\n- Category-chain: `payments-eth` (Payments on Ethereum)\n", "parameters": [ { "in": "query", "name": "symbols", "schema": { "type": "string" }, "required": true, "description": "Chain symbols, comma-separated. Supports dash-separated syntax", "example": "eth,sol,usdc-eth" }, { "in": "query", "name": "startDate", "schema": { "type": "string", "format": "date" }, "description": "Start date in YYYY-MM-DD format", "example": "2026-01-01" }, { "in": "query", "name": "endDate", "schema": { "type": "string", "format": "date" }, "description": "End date in YYYY-MM-DD format", "example": "2026-02-01" }, { "$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": "Stablecoin Transfer Volume data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StablecoinDataResponse" }, "example": { "data": { "symbols": { "arbitrum": { "STABLECOIN_TRANSFER_VOLUME": [ { "date": "2026-01-01", "val": 1884913630.37 }, { "date": "2026-01-02", "val": 3176206432.15 }, { "date": "2026-01-03", "val": 2217723343.89 } ] }, "eth": { "STABLECOIN_TRANSFER_VOLUME": [ { "date": "2026-01-01", "val": 72997704217.41 }, { "date": "2026-01-02", "val": 96601732668.85 }, { "date": "2026-01-03", "val": 40432990931.26 } ] }, "sol": { "STABLECOIN_TRANSFER_VOLUME": [ { "date": "2026-01-01", "val": 5571128760.05 }, { "date": "2026-01-02", "val": 13216948838.22 }, { "date": "2026-01-03", "val": 7558751970.34 } ] } } } } } } } } } }, "/data/api/ARTEMIS_STABLECOIN_TRANSFER_VOLUME/": { "get": { "summary": "Fetch Artemis-Filtered Stablecoin Transfer Volume", "tags": [ "Stablecoins" ], "operationId": "fetchArtemisStablecoinTransferVolume", "x-codeSamples": [ { "lang": "python", "source": "import os\nfrom datetime import date\nfrom artemis import Artemis\n\nclient = Artemis()\nresponse = client.stablecoin.fetch_artemis_transfer_volume(\n api_key=os.environ[\"ARTEMIS_API_KEY\"],\n symbols=\"eth,sol,arbitrum\",\n start_date=date(2026, 1, 1),\n end_date=date(2026, 2, 1),\n)\nprint(response.data)\n" } ], "description": "Fetch daily transfer volume for stablecoins with Artemis filtering applied.\n\n**Artemis Filter:** Adjusted stablecoin activity is defined as deduped stablecoin activity less intra-exchange transfers and MEV. \nDe-dupping selects the largest transfer for a transaction. Intra-exchange activity is transfers between tagged addresses \nfor the same exchange. Goal: estimate \"real\" stablecoin activity.\n\n**Dash-Separated Symbol Syntax:**\n- Simple: `eth`, `sol`, `usdc`\n- Chain-specific: `usdc-eth` (USDC on Ethereum)\n- Category-specific: `mev-usdc` (USDC tagged to MEV)\n- Category-chain: `payments-eth` (Payments on Ethereum)\n", "parameters": [ { "in": "query", "name": "symbols", "schema": { "type": "string" }, "required": true, "description": "Chain symbols, comma-separated. Supports dash-separated syntax", "example": "eth,sol,usdc-eth" }, { "in": "query", "name": "startDate", "schema": { "type": "string", "format": "date" }, "description": "Start date in YYYY-MM-DD format", "example": "2026-01-01" }, { "in": "query", "name": "endDate", "schema": { "type": "string", "format": "date" }, "description": "End date in YYYY-MM-DD format", "example": "2026-02-01" }, { "$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": "Artemis-filtered stablecoin volume data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StablecoinDataResponse" }, "example": { "data": { "symbols": { "arbitrum": { "ARTEMIS_STABLECOIN_TRANSFER_VOLUME": [ { "date": "2026-01-01", "val": 1227554969.89 }, { "date": "2026-01-02", "val": 2005422085.07 }, { "date": "2026-01-03", "val": 1168375137.94 } ] }, "eth": { "ARTEMIS_STABLECOIN_TRANSFER_VOLUME": [ { "date": "2026-01-01", "val": 25442720802.63 }, { "date": "2026-01-02", "val": 37467197093.6 }, { "date": "2026-01-03", "val": 15874283322.49 } ] }, "sol": { "ARTEMIS_STABLECOIN_TRANSFER_VOLUME": [ { "date": "2026-01-01", "val": 4467240516.11 }, { "date": "2026-01-02", "val": 11117230044.22 }, { "date": "2026-01-03", "val": 5860800255.29 } ] } } } } } } } } } }, "/data/api/P2P_STABLECOIN_TRANSFER_VOLUME/": { "get": { "summary": "Fetch P2P Stablecoin Transfer Volume", "tags": [ "Stablecoins" ], "operationId": "fetchP2pStablecoinTransferVolume", "x-codeSamples": [ { "lang": "python", "source": "import os\nfrom datetime import date\nfrom artemis import Artemis\n\nclient = Artemis()\nresponse = client.stablecoin.fetch_p2p_transfer_volume(\n api_key=os.environ[\"ARTEMIS_API_KEY\"],\n symbols=\"eth,sol,arbitrum\",\n start_date=date(2026, 1, 1),\n end_date=date(2026, 2, 1),\n)\nprint(response.data)\n" } ], "description": "Fetch daily transfer volume for peer-to-peer stablecoin transfers.\n\n**P2P Filter:** Stablecoin activity between wallets/Externally Owned Accounts (EOAs) only.\n\n**Dash-Separated Symbol Syntax:**\n- Simple: `eth`, `sol`, `usdc`\n- Chain-specific: `usdc-eth` (USDC on Ethereum)\n- Category-specific: `mev-usdc` (USDC tagged to MEV)\n- Category-chain: `payments-eth` (Payments on Ethereum)\n", "parameters": [ { "in": "query", "name": "symbols", "schema": { "type": "string" }, "required": true, "description": "Chain symbols, comma-separated. Supports dash-separated syntax", "example": "sol,usdc-sol" }, { "in": "query", "name": "startDate", "schema": { "type": "string", "format": "date" }, "description": "Start date in YYYY-MM-DD format", "example": "2026-01-01" }, { "in": "query", "name": "endDate", "schema": { "type": "string", "format": "date" }, "description": "End date in YYYY-MM-DD format", "example": "2026-02-01" }, { "$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": "P2P stablecoin volume data", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StablecoinDataResponse" }, "example": { "data": { "symbols": { "arbitrum": { "P2P_STABLECOIN_TRANSFER_VOLUME": [ { "date": "2026-01-01", "val": 483568380.11 }, { "date": "2026-01-02", "val": 719398398.86 }, { "date": "2026-01-03", "val": 287342331.2 } ] }, "eth": { "P2P_STABLECOIN_TRANSFER_VOLUME": [ { "date": "2026-01-01", "val": 7019974191.53 }, { "date": "2026-01-02", "val": 13206677214.21 }, { "date": "2026-01-03", "val": 4180765796.77 } ] }, "sol": { "P2P_STABLECOIN_TRANSFER_VOLUME": [ { "date": "2026-01-01", "val": 2397723278.29 }, { "date": "2026-01-02", "val": 7805667335.06 }, { "date": "2026-01-03", "val": 2709927507.31 } ] } } } } } } } } } }, "/flows/top/": { "get": { "summary": "Get Flows by Chain (Netflow, Inflow, or Outflow)", "tags": [ "Flows" ], "operationId": "getFlows", "description": "Returns chain-level inflows, outflows, or netflows for a set of source chains over a date range. Use `flowType` to select which view: `inflow` (capital entering each chain), `outflow` (capital leaving), or `netflow` (the difference). Chain identifiers should match the full chain names from [List Supported Assets](/docs/api-reference/core-artemis-assets/list-supported-assets).\n", "x-codeSamples": [ { "lang": "python", "source": "import os\nfrom datetime import date\nfrom artemis import Artemis\n\nclient = Artemis()\nresponse = client.flow.get_top(\n api_key=os.environ[\"ARTEMIS_API_KEY\"],\n breakdown=\"chains\",\n end_date=date(2026, 2, 1),\n flow_type=\"netflow\",\n source_chains=\"ethereum,arbitrum,base\",\n start_date=date(2026, 1, 1),\n)\nprint(response.netflow)\n" } ], "parameters": [ { "in": "query", "name": "startDate", "schema": { "type": "string", "format": "date" }, "required": true, "description": "Start date in YYYY-MM-DD format", "example": "2026-01-01" }, { "in": "query", "name": "endDate", "schema": { "type": "string", "format": "date" }, "required": true, "description": "End date in YYYY-MM-DD format", "example": "2026-02-01" }, { "$ref": "#/components/parameters/Granularity" }, { "in": "query", "name": "sourceChains", "schema": { "type": "string" }, "required": true, "description": "Comma-separated list of blockchain identifiers. Use full chain names for best compatibility.", "example": "aptos,arbitrum,avalanche,base,berachain,bitcoin,blast,bsc,celo,ethereum,hyperliquid,injective,ink,linea,mantle,near,optimism,polygon,sei,solana,sonic,starknet,sui,unichain,worldchain,zksync" }, { "in": "query", "name": "breakdown", "schema": { "type": "string", "enum": [ "chains" ] }, "required": true, "description": "Breakdown type for the flow data", "example": "chains" }, { "in": "query", "name": "flowType", "schema": { "type": "string", "enum": [ "netflow", "inflow", "outflow" ] }, "required": true, "description": "Type of flow to retrieve", "example": "netflow" }, { "in": "query", "name": "limit", "schema": { "type": "integer", "default": 20 }, "description": "Optional parameter. May cause issues with certain sourceChains combinations.", "example": 20 }, { "in": "query", "name": "APIKey", "schema": { "type": "string" }, "required": true, "description": "Your Artemis API key" } ], "responses": { "200": { "description": "Flows data based on flowType parameter", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FlowsResponse" }, "example": { "inflow": { "ethereum": 88869217.4, "arbitrum": 79059259.03, "base": 35071676.44 }, "netflow": { "ethereum": -20650296.17, "arbitrum": -5265571.05, "base": 25915867.22 }, "outflow": { "ethereum": 109519513.58, "arbitrum": 84324830.08, "base": 9155809.21 } } } } } } } }, "/data/api/PRICE/": { "get": { "summary": "Fetch Equity Price", "tags": [ "Equities" ], "operationId": "fetchEquityPrice", "description": "Daily closing price for one or more equity symbols.\n", "x-codeSamples": [ { "lang": "python", "source": "import os\nfrom datetime import date\nfrom artemis import Artemis\n\nclient = Artemis()\nresponse = client.equity.fetch_price(\n api_key=os.environ[\"ARTEMIS_API_KEY\"],\n symbols=\"eq-nvda,eq-meta\",\n start_date=date(2026, 1, 1),\n end_date=date(2026, 2, 1),\n)\n\n# response.data.symbols is keyed by symbol -> {metric: [{date, val}, ...]}\nfor symbol, metrics in response.data.symbols.items():\n latest = metrics[\"PRICE\"][-1]\n print(f\"{symbol}: ${latest.val:.2f} on {latest.date}\")\n" } ], "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": "2026-01-01" }, { "in": "query", "name": "endDate", "schema": { "type": "string", "format": "date" }, "description": "End date in YYYY-MM-DD format", "example": "2026-02-01" }, { "$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 price time-series", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DataResponse" }, "example": { "data": { "symbols": { "eq-nvda": { "PRICE": [ { "date": "2026-01-01", "val": 186.5 }, { "date": "2026-01-02", "val": 188.85 } ] } } } } } } } } } }, "/data/api/TOTAL_REVENUE,NET_INCOME,EBITDA,OPERATING_INCOME,FREE_CASH_FLOW,BASIC_EPS,DILUTED_EPS/": { "get": { "summary": "Fetch Equity Financials", "tags": [ "Equities" ], "operationId": "fetchEquityFinancials", "description": "Seven core P&L line items per fiscal quarter, in one call:\n\n| Metric | Description |\n|---|---|\n| `TOTAL_REVENUE` | Total revenue |\n| `NET_INCOME` | Net income |\n| `EBITDA` | EBITDA |\n| `OPERATING_INCOME` | Operating income |\n| `FREE_CASH_FLOW` | Free cash flow |\n| `BASIC_EPS` | Basic earnings per share |\n| `DILUTED_EPS` | Diluted earnings per share |\n\nData points are reported on each company's fiscal calendar — NVDA's quarters end late-month (e.g. 2024-04-28, 2024-07-28), META's align with calendar quarters. The backend requires `granularity=QUARTER`; sub-quarter granularities are rejected since these are filing-period metrics.\n", "x-codeSamples": [ { "lang": "python", "source": "import os\nfrom datetime import date\nfrom artemis import Artemis\n\nclient = Artemis()\nresponse = client.equity.fetch_financials(\n api_key=os.environ[\"ARTEMIS_API_KEY\"],\n symbols=\"eq-nvda\",\n granularity=\"QUARTER\",\n start_date=date(2024, 1, 1),\n end_date=date(2025, 12, 31),\n)\n\n# Print the latest reported quarter for each P&L line item:\nmetrics = response.data.symbols[\"eq-nvda\"]\nfor name in [\"TOTAL_REVENUE\", \"NET_INCOME\", \"EBITDA\", \"FREE_CASH_FLOW\", \"DILUTED_EPS\"]:\n series = metrics.get(name) or []\n if series:\n latest = series[-1]\n print(f\"{name:20} {latest.date} {latest.val:,.2f}\")\n" } ], "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": "2025-12-31" }, { "in": "query", "name": "granularity", "schema": { "type": "string", "enum": [ "QUARTER" ], "default": "QUARTER" }, "description": "Granularity for equity financial metrics. Only `QUARTER` is supported." }, { "$ref": "#/components/parameters/Limit" }, { "in": "query", "name": "APIKey", "schema": { "type": "string" }, "required": true, "description": "Your Artemis API key" } ], "responses": { "200": { "description": "Equity financials time-series, keyed by metric name within each symbol.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DataResponse" }, "example": { "data": { "symbols": { "eq-nvda": { "TOTAL_REVENUE": [ { "date": "2024-04-28", "val": 26044000000 }, { "date": "2024-07-28", "val": 30040000000 } ], "NET_INCOME": [ { "date": "2024-04-28", "val": 14881000000 }, { "date": "2024-07-28", "val": 16599000000 } ], "EBITDA": [ { "date": "2024-04-28", "val": 17319000000 }, { "date": "2024-07-28", "val": 19310000000 } ], "BASIC_EPS": [ { "date": "2024-04-28", "val": 0.6 }, { "date": "2024-07-28", "val": 0.68 } ], "DILUTED_EPS": [ { "date": "2024-04-28", "val": 0.6 }, { "date": "2024-07-28", "val": 0.67 } ] } } } } } } } } } }, "/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": { "summary": "Fetch Equity Valuation Metrics", "tags": [ "Equities" ], "operationId": "fetchEquityValuationMetrics", "description": "Seven valuation ratios (daily), in one call:\n\n| Metric | Description |\n|---|---|\n| `ENTERPRISE_VALUE_DIVIDE_TOTAL_REVENUE` | EV / Revenue |\n| `ENTERPRISE_VALUE_DIVIDE_NET_INCOME` | EV / Earnings |\n| `ENTERPRISE_VALUE_DIVIDE_EBITDA` | EV / EBITDA |\n| `ENTERPRISE_VALUE_DIVIDE_FREE_CASH_FLOW` | EV / FCF |\n| `MARKET_CAP_DIVIDE_FREE_CASH_FLOW` | Price / FCF |\n| `EARNINGS_YIELD` | Earnings yield (1 / P/E) |\n| `FCF_YIELD` | Free cash flow yield |\n\nRatios 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.\n", "x-codeSamples": [ { "lang": "python", "source": "import os\nfrom datetime import date\nfrom artemis import Artemis\n\nclient = Artemis()\nresponse = client.equity.fetch_valuation_metrics(\n api_key=os.environ[\"ARTEMIS_API_KEY\"],\n symbols=\"eq-nvda\",\n start_date=date(2024, 1, 1),\n end_date=date(2024, 12, 31),\n)\n\n# Latest reading for each valuation ratio:\nmetrics = response.data.symbols[\"eq-nvda\"]\nheadline = {\n \"ENTERPRISE_VALUE_DIVIDE_TOTAL_REVENUE\": \"EV / Revenue\",\n \"ENTERPRISE_VALUE_DIVIDE_NET_INCOME\": \"EV / Earnings\",\n \"ENTERPRISE_VALUE_DIVIDE_EBITDA\": \"EV / EBITDA\",\n \"EARNINGS_YIELD\": \"Earnings Yield (%)\",\n \"FCF_YIELD\": \"FCF Yield (%)\",\n}\nfor key, label in headline.items():\n series = metrics.get(key) or []\n if series:\n print(f\"{label:25} {series[-1].val:.2f}\")\n" } ], "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 } ] } } } } } } } } } }, "/insights/ath/": { "get": { "summary": "List All-Time-High Insight Cards", "tags": [ "Insights" ], "operationId": "listAthInsights", "description": "Recent all-time-high events across crypto protocols, stablecoins (daily / weekly / monthly horizons), and equities (quarterly fundamentals). Each card carries the asset (`ENTITY_ID`), the metric (`METRIC_NAME`), the new ATH (`NEW_VALUE`), the previous ATH for comparison (`PREVIOUS_ATH_VALUE` and `PREVIOUS_ATH_DATE`), the percent improvement (`PERCENT_ABOVE_PREVIOUS`), and a `SPARKLINE` for inline charting.\n\nCards are sorted by `PERCENT_ABOVE_PREVIOUS` descending — biggest blow-out highs first.\n\nRelated: [`list_all_time_lows`](#tag/Insights/operation/listAtlInsights), [`list_growth_streaks`](#tag/Insights/operation/listStreakInsights).\n", "x-codeSamples": [ { "lang": "python", "source": "from artemis import Artemis\n\nclient = Artemis()\nresponse = client.insights.list_all_time_highs()\n\n# The 5 biggest blow-out ATHs (sorted by percent above previous):\nfor card in response.rows[:5]:\n print(\n f\"{card.entity_id} {card.metric_name} \"\n f\"hit {card.new_value:,.0f} on {card.new_date} \"\n f\"(+{card.percent_above_previous:.1f}% vs prior ATH)\"\n )\n" } ], "responses": { "200": { "description": "A feed of all-time-high insight cards.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InsightExtremeCardsResponse" }, "example": { "rows": [ { "DOMAIN": "protocol", "ENTITY_ID": "ethereum", "METRIC_NAME": "SETTLEMENT_VOLUME", "HORIZON": "monthly", "UNIT": "CURRENCY", "METRIC_TYPE": "flow", "NEW_VALUE": 1024500000000, "NEW_DATE": "2026-04-01", "PREVIOUS_ATH_VALUE": 897249366011.26, "PREVIOUS_ATH_DATE": "2025-10-01", "PERCENT_ABOVE_PREVIOUS": 14.18, "PERIOD_END_DATE": null, "FISCAL_YEAR": null, "FISCAL_PERIOD": null, "REPORT_DATE": null, "SPARKLINE": [ { "date": "2026-02-01", "value": 712450891234.5 }, { "date": "2026-03-01", "value": 854120567432.1 }, { "date": "2026-04-01", "value": 1024500000000 } ] } ] } } } } } } }, "/insights/atl/": { "get": { "summary": "List All-Time-Low Insight Cards", "tags": [ "Insights" ], "operationId": "listAtlInsights", "description": "Recent all-time-low events across the same coverage as ATH cards. Each card carries the new low (`NEW_VALUE`), the previous ATL for comparison (`PREVIOUS_ATL_VALUE` and `PREVIOUS_ATL_DATE`), and the percent below the prior low (`PERCENT_BELOW_PREVIOUS`). For equity metrics with a fiscal calendar, `FISCAL_YEAR` / `FISCAL_PERIOD` / `PERIOD_END_DATE` are populated.\n\nCards are sorted by `PERCENT_BELOW_PREVIOUS` descending — biggest crashes first.\n\nRelated: [`list_all_time_highs`](#tag/Insights/operation/listAthInsights), [`list_decline_streaks`](#tag/Insights/operation/listDeclineStreakInsights).\n", "x-codeSamples": [ { "lang": "python", "source": "from artemis import Artemis\n\nclient = Artemis()\nresponse = client.insights.list_all_time_lows()\n\n# The 5 sharpest new lows:\nfor card in response.rows[:5]:\n print(\n f\"{card.entity_id} {card.metric_name} \"\n f\"hit {card.new_value:,.0f} on {card.new_date} \"\n f\"(-{card.percent_below_previous:.1f}% vs prior ATL)\"\n )\n" } ], "responses": { "200": { "description": "A feed of all-time-low insight cards.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InsightExtremeCardsResponse" }, "example": { "rows": [ { "DOMAIN": "equity", "ENTITY_ID": "RKT", "METRIC_NAME": "gross_profit", "HORIZON": "quarterly", "UNIT": "CURRENCY", "METRIC_TYPE": "snapshot", "NEW_VALUE": -54357000, "NEW_DATE": "2024-07-01", "PREVIOUS_ATL_VALUE": 18283000, "PREVIOUS_ATL_DATE": "2023-01-01", "PERCENT_BELOW_PREVIOUS": 397.31, "PERIOD_END_DATE": "2024-09-30", "FISCAL_YEAR": 2024, "FISCAL_PERIOD": "Q3", "REPORT_DATE": "2024-09-30", "SPARKLINE": [ { "date": "2024-01-01", "value": 41200000 }, { "date": "2024-04-01", "value": -12450000 }, { "date": "2024-07-01", "value": -54357000 } ] } ] } } } } } } }, "/insights/streaks/": { "get": { "summary": "List Growth-Streak Insight Cards", "tags": [ "Insights" ], "operationId": "listStreakInsights", "description": "Entities where a metric has increased for `DURATION` consecutive periods. `FLAG` encodes the cadence (`streak_weekly`, `streak_monthly`, or `streak_quarterly`), `START_VALUE` and `END_VALUE` bracket the streak, and `DATE_RANGE` gives a human-readable window. `SPARKLINE` includes one prior-period baseline bar so charts have context on either side of the trend.\n\nCards are sorted by `PERIOD_END_DATE` descending — most recent streaks first.\n\nRelated: [`list_acceleration_signals`](#tag/Insights/operation/listAccelerationInsights) for second-derivative trends, [`list_all_time_highs`](#tag/Insights/operation/listAthInsights) for streaks that culminated in a record.\n", "x-codeSamples": [ { "lang": "python", "source": "from artemis import Artemis\n\nclient = Artemis()\nresponse = client.insights.list_growth_streaks()\n\n# The 5 most recent growth streaks:\nfor card in response.rows[:5]:\n cadence = card.flag.split(\"_\")[-1] # \"weekly\" / \"monthly\" / \"quarterly\"\n multiplier = card.end_value / card.start_value if card.start_value else 0\n print(\n f\"{card.entity_id} {card.metric_name}: \"\n f\"{card.duration} consecutive {cadence} periods \"\n f\"({multiplier:.2f}x over {card.date_range})\"\n )\n" } ], "responses": { "200": { "description": "A feed of growth-streak insight cards.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InsightTrendCardsResponse" }, "example": { "rows": [ { "DOMAIN": "protocol", "ENTITY_ID": "solana", "METRIC_NAME": "STABLECOIN_TRANSFER_VOLUME", "FLAG": "streak_weekly", "UNIT": "CURRENCY", "METRIC_TYPE": "flow", "DURATION": 6, "DATE_RANGE": "2026-04-01 to 2026-05-12", "START_VALUE": 4120000000, "END_VALUE": 8950000000, "PERIOD_START_DATE": "2026-04-01", "PERIOD_END_DATE": "2026-05-12", "FISCAL_YEAR_END": null, "FISCAL_PERIOD_END": null, "LATEST_REPORT_DATE": null, "SPARKLINE": [ { "date": "2026-03-25", "value": 3850000000 }, { "date": "2026-04-01", "value": 4120000000 }, { "date": "2026-04-08", "value": 5230000000 } ] } ] } } } } } } }, "/insights/decline-streaks/": { "get": { "summary": "List Decline-Streak Insight Cards", "tags": [ "Insights" ], "operationId": "listDeclineStreakInsights", "description": "Entities where a metric has decreased for `DURATION` consecutive periods. Same card shape as [growth streaks](#tag/Insights/operation/listStreakInsights); `END_VALUE < START_VALUE` is the distinguishing signal. `SPARKLINE` includes a longer lead-in window (12+ periods) so the chart shows the full peak-to-decline arc.\n\nCards are sorted by `PERIOD_END_DATE` descending — most recent declines first.\n\nRelated: [`list_all_time_lows`](#tag/Insights/operation/listAtlInsights) for declines that bottomed out at a record.\n", "x-codeSamples": [ { "lang": "python", "source": "from artemis import Artemis\n\nclient = Artemis()\nresponse = client.insights.list_decline_streaks()\n\n# The 5 most recent decline streaks:\nfor card in response.rows[:5]:\n cadence = card.flag.split(\"_\")[-1]\n drop_pct = (1 - card.end_value / card.start_value) * 100 if card.start_value else 0\n print(\n f\"{card.entity_id} {card.metric_name}: \"\n f\"{card.duration} consecutive {cadence} periods of decline \"\n f\"(-{drop_pct:.1f}% over {card.date_range})\"\n )\n" } ], "responses": { "200": { "description": "A feed of decline-streak insight cards.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InsightTrendCardsResponse" }, "example": { "rows": [ { "DOMAIN": "protocol", "ENTITY_ID": "optimism", "METRIC_NAME": "DAILY_TXNS", "FLAG": "decline_streak_weekly", "UNIT": "NOMINAL", "METRIC_TYPE": "flow", "DURATION": 5, "DATE_RANGE": "2026-04-08 to 2026-05-12", "START_VALUE": 1480000, "END_VALUE": 920000, "PERIOD_START_DATE": "2026-04-08", "PERIOD_END_DATE": "2026-05-12", "FISCAL_YEAR_END": null, "FISCAL_PERIOD_END": null, "LATEST_REPORT_DATE": null, "SPARKLINE": [ { "date": "2026-04-01", "value": 1620000 }, { "date": "2026-04-08", "value": 1480000 }, { "date": "2026-04-15", "value": 1340000 } ] } ] } } } } } } }, "/insights/acceleration/": { "get": { "summary": "List Accelerating-Trend Insight Cards", "tags": [ "Insights" ], "operationId": "listAccelerationInsights", "description": "Entities where a metric's **rate of change** is itself increasing across consecutive periods — second-derivative signal, useful for spotting inflection points before they show up as new ATHs.\n\nSame card shape as the [streak endpoints](#tag/Insights/operation/listStreakInsights). `START_VALUE` is the level at the start of the acceleration window; `END_VALUE` is the level at the end. The interesting signal is **not** that `END_VALUE > START_VALUE` (true for growth streaks too) but that each period's delta exceeds the previous period's delta.\n\nCards are sorted by `PERIOD_END_DATE` descending.\n", "x-codeSamples": [ { "lang": "python", "source": "from artemis import Artemis\n\nclient = Artemis()\nresponse = client.insights.list_acceleration_signals()\n\n# The 5 most recent acceleration signals:\nfor card in response.rows[:5]:\n cadence = card.flag.split(\"_\")[-1]\n multiplier = card.end_value / card.start_value if card.start_value else 0\n print(\n f\"{card.entity_id} {card.metric_name}: \"\n f\"accelerating over {card.duration} {cadence} periods \"\n f\"({multiplier:.2f}x over {card.date_range})\"\n )\n" } ], "responses": { "200": { "description": "A feed of accelerating-trend insight cards.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InsightTrendCardsResponse" }, "example": { "rows": [ { "DOMAIN": "protocol", "ENTITY_ID": "base", "METRIC_NAME": "STABLECOIN_DAU", "FLAG": "accel_weekly", "UNIT": "NOMINAL", "METRIC_TYPE": "snapshot", "DURATION": 4, "DATE_RANGE": "2026-04-15 to 2026-05-12", "START_VALUE": 215000, "END_VALUE": 412000, "PERIOD_START_DATE": "2026-04-15", "PERIOD_END_DATE": "2026-05-12", "FISCAL_YEAR_END": null, "FISCAL_PERIOD_END": null, "LATEST_REPORT_DATE": null, "SPARKLINE": [ { "date": "2026-04-08", "value": 198000 }, { "date": "2026-04-15", "value": 215000 }, { "date": "2026-04-22", "value": 268000 } ] } ] } } } } } } } } }