> ## Documentation Index
> Fetch the complete documentation index at: https://docs.messari.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get All-Time Highs

> Retrieve a specific asset's ATH

<Note>
  **x402 Support:** Supported.
  See the [x402 guide](/api-reference/x402-payments#supported-endpoints).
</Note>


## OpenAPI

````yaml GET /metrics/v2/assets/ath
openapi: 3.0.0
info:
  description: OpenAPI specification for the entire Messari API
  title: Messari API - Metrics V2
  version: 1.0.0
servers:
  - description: Messari API
    url: https://api.messari.io
security: []
paths:
  /metrics/v2/assets/ath:
    get:
      tags:
        - metrics/assets
      summary: Get asset ATH
      description: Retrieve a specific asset's ATH
      operationId: getAssetsATH
      parameters:
        - description: >-
            Comma separated list of asset identifiers - accepts slugs (e.g.
            'bitcoin') or UUIDs
          in: query
          name: assetIDs
          schema:
            type: string
            example: bitcoin,ethereum
        - description: Filter By Category
          in: query
          name: category
          schema:
            type: string
        - description: Filter By Sector
          in: query
          name: sector
          schema:
            type: string
        - description: Search by name, symbol, slug, or contract address
          in: query
          name: search
          schema:
            type: string
        - description: Limit
          in: query
          name: limit
          schema:
            format: int64
            type: integer
          example: 10
        - description: Page number (1-indexed)
          in: query
          name: page
          schema:
            format: int64
            type: integer
            example: 1
            default: 1
        - description: 'Column to sort by (default: price-change-24h)'
          in: query
          name: sort
          schema:
            type: string
            enum:
              - name
              - slug
              - price-change-24h
              - price-change-7d
              - price-change-30d
              - price-change-1y
              - price-change-year-to-date
              - all-time-high
              - all-time-high-percent-down
              - breakeven-multiple
              - cycle-low-percent-up
            default: price-change-24h
        - description: 'Sort direction: asc or desc (default: desc)'
          in: query
          name: order
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    items:
                      $ref: '#/components/schemas/AssetComparisonItem'
                    type: array
                  error:
                    type: string
                  metadata:
                    $ref: '#/components/schemas/SnapshotListingMetadata'
                required:
                  - data
                type: object
              example:
                error: null
                data:
                  - id: 1e31218a-e44e-4285-820c-8282ee222035
                    name: Bitcoin
                    slug: bitcoin
                    symbol: BTC
                    category: Cryptocurrency
                    sector: Cryptocurrency
                    tags:
                      - Proof-of-Work
                    allTimeHigh:
                      allTimeHigh: 126238.2220708942
                      allTimeHighDate: '2025-10-06T18:00:00Z'
                      allTimeHighTimeSinceSeconds: 2174030
                      allTimeHighPercentDown: 13.198250307605644
                      breakevenMultiple: 1.1525723835282684
                      cycleLow: 103553.13308598916
                      cycleLowDate: '2025-10-17T10:00:00Z'
                      cycleLowTimeSinceSeconds: 1252430
                      cycleLowPercentUp: 5.924644699199363
                  - id: 21c795f5-1bfd-40c3-858e-e9d7e820c6d0
                    name: Ethereum
                    slug: ethereum
                    symbol: ETH
                    category: Networks
                    sector: Smart Contract Platform
                    tags:
                      - EVM
                      - Proof-of-Stake
                      - Stakeable
                    allTimeHigh:
                      allTimeHigh: 4953.378632189802
                      allTimeHighDate: '2025-08-24T19:00:00Z'
                      allTimeHighTimeSinceSeconds: 5885630
                      allTimeHighPercentDown: 22.112005894203612
                      breakevenMultiple: 1.2848747365008981
                      cycleLow: 3502.98917829104
                      cycleLowDate: '2025-10-10T21:00:00Z'
                      cycleLowTimeSinceSeconds: 1817630
                      cycleLowPercentUp: 10.307656673363399
                  - id: 51f8ea5e-f426-4f40-939a-db7e05495374
                    name: Tether
                    slug: tether
                    symbol: USDT
                    category: Cryptocurrency
                    sector: Stablecoins
                    tags:
                      - Centralized Issuer
                      - U.S. Dollar Stablecoin
                    allTimeHigh:
                      allTimeHigh: 1.3309067947337994
                      allTimeHighDate: '2017-05-25T20:00:00Z'
                      allTimeHighTimeSinceSeconds: 266205230
                      allTimeHighPercentDown: 24.891971856520296
                      breakevenMultiple: 1.3314961889327623
                      cycleLow: 0.8540991092969288
                      cycleLowDate: '2017-05-27T10:00:00Z'
                      cycleLowTimeSinceSeconds: 266068430
                      cycleLowPercentUp: 17.17210570441069
                  - id: 97775be0-2608-4720-b7af-f85b24c7eb2d
                    name: XRP
                    slug: xrp
                    symbol: XRP
                    category: Financial Services
                    sector: Payments
                    tags:
                      - SEC Alleged Securities
                    allTimeHigh:
                      allTimeHigh: 3.652620958880261
                      allTimeHighDate: '2025-07-18T00:00:00Z'
                      allTimeHighTimeSinceSeconds: 9150830
                      allTimeHighPercentDown: 31.075837577364958
                      breakevenMultiple: 1.4516081595651729
                      cycleLow: 2.2181811955697226
                      cycleLowDate: '2025-10-17T08:00:00Z'
                      cycleLowTimeSinceSeconds: 1259630
                      cycleLowPercentUp: 13.56327253009621
                  - id: 7dc551ba-cfed-4437-a027-386044415e3e
                    name: BNB
                    slug: binance-coin
                    symbol: BNB
                    category: Networks
                    sector: Smart Contract Platform
                    tags:
                      - CeFi
                      - Centralized Exchange
                      - Cosmos SDK
                      - EVM
                      - SEC Alleged Securities
                    allTimeHigh:
                      allTimeHigh: 1370.111397640335
                      allTimeHighDate: '2025-10-13T08:00:00Z'
                      allTimeHighTimeSinceSeconds: 1605230
                      allTimeHighPercentDown: 20.68480296016974
                      breakevenMultiple: 1.2615764243542895
                      cycleLow: 1040.2844648545406
                      cycleLowDate: '2025-10-17T09:00:00Z'
                      cycleLowTimeSinceSeconds: 1256030
                      cycleLowPercentUp: 4.606468991426641
          description: Default response
        '400':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Unauthorized
        '500':
          content:
            application/json:
              schema:
                properties:
                  data: {}
                  error:
                    type: string
                required:
                  - data
                type: object
          description: Internal Server Error
      security:
        - apiKey: []
components:
  schemas:
    AssetComparisonItem:
      properties:
        allTimeHigh:
          $ref: '#/components/schemas/AssetATH'
        category:
          type: string
        id:
          type: string
        name:
          type: string
        returnOnInvestment:
          $ref: '#/components/schemas/AssetROI'
        sector:
          type: string
        slug:
          type: string
        symbol:
          type: string
        tags:
          items:
            type: string
          type: array
      required:
        - category
        - id
        - name
        - sector
        - slug
        - symbol
        - tags
      type: object
    SnapshotListingMetadata:
      properties:
        page:
          format: int64
          type: integer
          description: Current page number
        pageSize:
          format: int64
          type: integer
          description: Number of results per page
        totalPages:
          format: int64
          type: integer
          description: Total number of pages
        totalRows:
          format: int64
          type: integer
          description: Total number of rows
      required:
        - page
        - pageSize
        - totalPages
        - totalRows
      type: object
      description: Pagination metadata
    AssetATH:
      type: object
      description: Schema for AssetATH
      properties: {}
      additionalProperties: true
    AssetROI:
      type: object
      description: Schema for AssetROI
      properties: {}
      additionalProperties: true
  securitySchemes:
    apiKey:
      in: header
      name: X-Messari-API-Key
      type: apiKey

````

Built with [Mintlify](https://mintlify.com).