> ## 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 All-Time-Low Insight Cards

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

Cards are sorted by `PERCENT_BELOW_PREVIOUS` descending — biggest crashes first.

Related: [`list_all_time_highs`](#tag/Insights/operation/listAthInsights), [`list_decline_streaks`](#tag/Insights/operation/listDeclineStreakInsights).




## OpenAPI

````yaml /openapi.documented.json get /insights/atl/
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/atl/:
    get:
      tags:
        - Insights
      summary: List All-Time-Low Insight Cards
      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.


        Cards are sorted by `PERCENT_BELOW_PREVIOUS` descending — biggest
        crashes first.


        Related:
        [`list_all_time_highs`](#tag/Insights/operation/listAthInsights),
        [`list_decline_streaks`](#tag/Insights/operation/listDeclineStreakInsights).
      operationId: listAtlInsights
      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
      x-codeSamples:
        - lang: python
          source: |
            from artemis import Artemis

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

            # The 5 sharpest new lows:
            for card in response.rows[:5]:
                print(
                    f"{card.entity_id} {card.metric_name} "
                    f"hit {card.new_value:,.0f} on {card.new_date} "
                    f"(-{card.percent_below_previous:.1f}% vs prior ATL)"
                )
components:
  schemas:
    InsightExtremeCardsResponse:
      type: object
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/InsightExtremeCard'
      required:
        - rows
    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
    InsightSparklinePoint:
      type: object
      properties:
        date:
          type: string
          format: date
        value:
          type:
            - number
            - 'null'
      required:
        - date
        - value

````