---
title: "List all markets (domestic and/or international)."
url: "https://developer.argaam.com/apis/market-data-layer-api-sandbox-v1/versions/76611d79-bb1b-44da-aed6-aca8b510fd74/operations/getMarkets"
---

> Full API specification: https://developer.argaam.com/apis/market-data-layer-api-sandbox-v1/versions/76611d79-bb1b-44da-aed6-aca8b510fd74.md

# List all markets (domestic and/or international).

`GET` `/api/v1.1/markets`

Operation ID: `getMarkets`

Returns the Argaam market catalogue, optionally filtered by region. **Region values** | Value | Description | |---|---| | `all` (default) | Both domestic GCC markets and international indices | | `domestic` | GCC exchange list only (Tadawul, DFM, ADX, MSM, etc.) | | `international` | International indices only (NYSE, LSE, Nikkei, etc.) | **Domestic markets** include the numeric `MarketID` used across all other Markets and Companies endpoints (e.g. `marketId=1` = Saudi Tadawul). **Tip:** Use `marketId=3` to request consolidated cross-GCC data in other endpoints — it represents the combined GCC view.

## Query parameters

- `region` (string, optional) - Region filter: `all` (default), `domestic`, or `international`. Defaults to `all`.

## Responses

- `200` - Success

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Market Data Layer API
  version: v1.1
servers:
  - url: https://api-sandbox.argaam.com
    description: Argaam API Gateway (Sandbox)
paths:
  /api/v1.1/markets:
    get:
      tags:
        - Markets
      parameters:
        - name: region
          in: query
          description: "Region filter: `all` (default), `domestic`, or `international`.
            Defaults to `all`."
          schema:
            type: string
            default: all
          example: all
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiV1Response"
      summary: List all markets (domestic and/or international).
      description: "Returns the Argaam market catalogue, optionally filtered by
        region.\r

        \            \r

        **Region values**\r

        | Value | Description |\r

        |---|---|\r

        | `all` (default) | Both domestic GCC markets and international indices
        |\r

        | `domestic` | GCC exchange list only (Tadawul, DFM, ADX, MSM, etc.) |\r

        | `international` | International indices only (NYSE, LSE, Nikkei, etc.)
        |\r

        \            \r

        **Domestic markets** include the numeric `MarketID` used across all
        other\r

        Markets and Companies endpoints (e.g. `marketId=1` = Saudi Tadawul).\r

        \            \r

        **Tip:** Use `marketId=3` to request consolidated cross-GCC data in
        other\r

        endpoints — it represents the combined GCC view."
      operationId: getMarkets
security:
  - ApiKeyAuth: []
components:
  schemas:
    ApiV1Response:
      type: object
      properties:
        success:
          type: boolean
        apiVersion:
          type: string
          nullable: true
        timestamp:
          type: string
          format: date-time
        requestId:
          type: string
          nullable: true
        data:
          nullable: true
        meta:
          $ref: "#/components/schemas/ApiV1Meta"
        rateLimit:
          $ref: "#/components/schemas/ApiV1RateLimit"
      additionalProperties: false
    ApiV1Meta:
      type: object
      properties:
        page:
          type: integer
          format: int32
        pageSize:
          type: integer
          format: int32
        totalRecords:
          type: integer
          format: int32
        totalPages:
          type: integer
          format: int32
          readOnly: true
        hasNextPage:
          type: boolean
          readOnly: true
        hasPreviousPage:
          type: boolean
          readOnly: true
      additionalProperties: false
    ApiV1RateLimit:
      type: object
      properties:
        limit:
          type: integer
          format: int32
        remaining:
          type: integer
          format: int32
        reset:
          type: string
          format: date-time
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
```