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

# List Exchanges

> Retrieve a list of exchanges

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


## OpenAPI

````yaml GET /metrics/v1/exchanges
openapi: 3.0.0
info:
  description: OpenAPI specification for the entire Messari API
  title: Messari API - Metrics V1
  version: 1.0.0
servers:
  - description: Messari API
    url: https://api.messari.io
security: []
paths:
  /metrics/v1/exchanges:
    get:
      tags:
        - metrics/exchanges
      summary: Get exchanges
      description: Retrieve a list of exchanges
      operationId: getExchanges
      parameters:
        - description: Number of items per page
          in: query
          name: limit
          schema:
            format: int64
            type: integer
            example: 10
            default: 10
        - description: Number of items per page. Kept for backward compatibility
          in: query
          name: pageSize
          schema:
            format: int64
            type: integer
        - description: Page number
          in: query
          name: page
          schema:
            format: int64
            type: integer
            example: 1
            default: 1
        - description: Filter by exchange type
          in: query
          name: type
          schema:
            type: string
            enum:
              - centralized
              - decentralized
        - in: query
          name: typeRankCutoff
          schema:
            format: double
            type: number
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    items:
                      $ref: '#/components/schemas/Exchange'
                    type: array
                  error:
                    type: string
                  metadata:
                    $ref: '#/components/schemas/SnapshotListingMetadata'
                required:
                  - data
                type: object
              example:
                error: null
                data:
                  - id: d8b0ea44-1963-451e-ac37-aead4ba3b4c7
                    name: Binance
                    slug: binance
                    type: centralized
                    yearEstablished: 2017
                    region: Americas
                    country: Cayman Islands
                    typeRank30D: 1
                    globalRank30D: 1
                    relatedExchangeIDs:
                      - 86f92f67-7968-4c8d-8cb6-a5b1c80ef185
                      - eabe49f0-c1a3-4166-b773-780fe809ac93
                      - b196e8a3-34cc-40bd-a6cb-bb8283958021
                      - 86f92f67-7968-4c8d-8cb6-a5b1c80ef185
                      - 174e0471-1033-4e12-97d5-9f234ed21142
                    metrics:
                      volume24Hour: 22972526466.775723
                      trades24Hour: 63566819
                      assetsCount: 613
                      marketsCount: 3036
                  - id: 86f92f67-7968-4c8d-8cb6-a5b1c80ef185
                    name: Toobit
                    slug: toobit
                    type: centralized
                    yearEstablished: 2022
                    region: Americas
                    country: Cayman Islands
                    typeRank30D: 9
                    globalRank30D: 9
                    relatedExchangeIDs:
                      - d8b0ea44-1963-451e-ac37-aead4ba3b4c7
                      - eabe49f0-c1a3-4166-b773-780fe809ac93
                      - b196e8a3-34cc-40bd-a6cb-bb8283958021
                      - d8b0ea44-1963-451e-ac37-aead4ba3b4c7
                      - 174e0471-1033-4e12-97d5-9f234ed21142
                    metrics:
                      volume24Hour: 5058775487.076545
                      trades24Hour: 3397496
                      assetsCount: 444
                      marketsCount: 450
                  - id: eaad939f-52c1-4a08-9857-c520a01072cc
                    name: MEXC Global
                    slug: mexc
                    type: centralized
                    yearEstablished: 2018
                    region: Africa
                    country: Seychelles
                    typeRank30D: 4
                    globalRank30D: 4
                    relatedExchangeIDs:
                      - bd9ed9e8-b95f-43e8-b156-654e62fc556f
                      - 2b482c0b-592c-47a3-bc24-33c8788feea7
                      - 4173177d-94f8-4ab5-9f67-5dc67663f88d
                      - 6b7daad8-c6f0-48fd-a3db-e1276f03918d
                      - 75a38c76-4ae7-4f06-9e5b-6e11eb70bdab
                    metrics:
                      volume24Hour: 4976318033.134372
                      trades24Hour: 21724715
                      assetsCount: 3321
                      marketsCount: 3687
                  - id: 174e0471-1033-4e12-97d5-9f234ed21142
                    name: LBank
                    slug: lbank
                    type: centralized
                    yearEstablished: 2015
                    region: Americas
                    country: Virgin Islands (British)
                    typeRank30D: 8
                    globalRank30D: 8
                    relatedExchangeIDs:
                      - 0db82dc0-fa38-4831-b50a-3ac803de1754
                      - 7ac870f5-a3ff-486d-a5a1-5d58140da970
                      - dcb635f3-8289-4459-b883-b0a57948df18
                      - 0dc16437-463b-48ec-9fd1-50b9fdcedb8c
                      - e9adc72e-29fa-44b0-b937-3b7e334b414e
                    metrics:
                      volume24Hour: 4786911401.829281
                      trades24Hour: 13152217
                      assetsCount: 1713
                      marketsCount: 1821
                  - id: 6e9a85b8-5adf-484b-88d9-9992e9975b68
                    name: CoinW
                    slug: coinw
                    type: centralized
                    yearEstablished: 2017
                    region: Asia
                    country: United Arab Emirates
                    typeRank30D: 2
                    globalRank30D: 2
                    relatedExchangeIDs:
                      - 1f8cff02-1906-4654-b8cc-8aa4d21ba0fe
                      - 2128b895-e571-46fa-9c3c-40c3feb6a45b
                      - 42f98807-bdd8-426e-a5d8-0556af0c17e0
                      - ddc53ba2-ad8a-4bae-a1ff-47e9e6e1ca73
                      - a77cae0e-d6f8-4865-8455-d6f737f428a9
                    metrics:
                      volume24Hour: 4678343885.744075
                      trades24Hour: 2824472
                      assetsCount: 523
                      marketsCount: 555
                metadata:
                  pageSize: 10
                  page: 1
                  totalRows: 294
                  totalPages: 30
          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:
    Exchange:
      properties:
        country:
          type: string
        globalRank30D:
          format: int64
          type: integer
        id:
          type: string
        metrics:
          $ref: '#/components/schemas/ExchangeMetrics'
        name:
          type: string
        region:
          type: string
        relatedExchangeIDs:
          items:
            type: string
          type: array
        slug:
          type: string
        type:
          type: string
        typeRank30D:
          format: int64
          type: integer
        yearEstablished:
          format: int64
          type: integer
      required:
        - country
        - globalRank30D
        - id
        - metrics
        - name
        - region
        - relatedExchangeIDs
        - slug
        - type
        - typeRank30D
        - yearEstablished
      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
    ExchangeMetrics:
      type: object
      description: Schema for ExchangeMetrics
      properties: {}
      additionalProperties: true
  securitySchemes:
    apiKey:
      in: header
      name: X-Messari-API-Key
      type: apiKey

````

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