> ## 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.

# List Decline-Streak Insight Cards

> 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.

Cards are sorted by `PERIOD_END_DATE` descending — most recent declines first.

Related: [`list_all_time_lows`](#tag/Insights/operation/listAtlInsights) for declines that bottomed out at a record.




## OpenAPI

````yaml /openapi.documented.json get /insights/decline-streaks/
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:
  /insights/decline-streaks/:
    get:
      tags:
        - Insights
      summary: List Decline-Streak Insight Cards
      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.


        Cards are sorted by `PERIOD_END_DATE` descending — most recent declines
        first.


        Related: [`list_all_time_lows`](#tag/Insights/operation/listAtlInsights)
        for declines that bottomed out at a record.
      operationId: listDeclineStreakInsights
      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
      x-codeSamples:
        - lang: python
          source: |
            from artemis import Artemis

            client = Artemis()
            response = client.insights.list_decline_streaks()

            # The 5 most recent decline streaks:
            for card in response.rows[:5]:
                cadence = card.flag.split("_")[-1]
                drop_pct = (1 - card.end_value / card.start_value) * 100 if card.start_value else 0
                print(
                    f"{card.entity_id} {card.metric_name}: "
                    f"{card.duration} consecutive {cadence} periods of decline "
                    f"(-{drop_pct:.1f}% over {card.date_range})"
                )
components:
  schemas:
    InsightTrendCardsResponse:
      type: object
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/InsightTrendCard'
      required:
        - rows
    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
    InsightSparklinePoint:
      type: object
      properties:
        date:
          type: string
          format: date
        value:
          type:
            - number
            - 'null'
      required:
        - date
        - value

````