---
title: "Get the country → markets → sectors → companies discovery tree."
url: "https://developer.argaam.com/apis/search-discovery-layer-api-sandbox-v1/versions/7b9c43fb-96d0-4164-9da6-4249bbd8ed0b/operations/getChartsUniverse"
---

> Full API specification: https://developer.argaam.com/apis/search-discovery-layer-api-sandbox-v1/versions/7b9c43fb-96d0-4164-9da6-4249bbd8ed0b.md

# Get the country → markets → sectors → companies discovery tree.

`GET` `/api/v1.1/charts/universe`

Operation ID: `getChartsUniverse`

Returns the full hierarchical discovery tree used to populate cascading dropdowns in the charting tool. Each node contains an `id`, `name`, and `children` array. **Tip:** For a symbol-specific pre-selection use `GET /charts/universe/by-symbol?stockSymbol={symbol}`. ### cURL Example ```bash curl -X GET "https://api.argaam.com/api/v1.1/charts/universe?countryId=1" \ -H "Accept: application/json" ```

## Query parameters

- `countryId` (integer, int32, optional) - Country ID. Default: `1` (Saudi Arabia). Defaults to `1`.

## Responses

- `200` - Discovery tree returned.

## OpenAPI definition

````yaml
openapi: 3.0.1
info:
  title: Search & Discovery Layer API
  version: v1.1
servers:
  - url: https://api-sandbox.argaam.com
    description: Argaam API Gateway (Sandbox)
paths:
  /api/v1.1/charts/universe:
    get:
      tags:
        - Charts
      parameters:
        - name: countryId
          in: query
          description: "Country ID. Default: `1` (Saudi Arabia). Defaults to `1`."
          schema:
            type: integer
            format: int32
            default: 1
          example: 1
      responses:
        "200":
          description: Discovery tree returned.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiV1ResponseOfChartUniverseResponse"
              example:
                success: true
                apiVersion: "1.1"
                timestamp: 2024-06-01T12:00:00Z
                requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
                data:
                  countryId: 1
                  tree:
                    - id: 1
                      nameEn: Saudi Stock Exchange (Tadawul)
                      nameAr: السوق المالية السعودية
                      children:
                        - id: 4
                          nameEn: Energy
                          nameAr: الطاقة
                          children:
                            - id: 1
                              nameEn: Saudi Aramco
                              nameAr: أرامكو السعودية
                              children: null
                meta: null
                rateLimit: null
      summary: Get the country → markets → sectors → companies discovery tree.
      description: "Returns the full hierarchical discovery tree used to populate\r

        cascading dropdowns in the charting tool. Each node contains\r

        an `id`, `name`, and `children` array.\r

        \            \r

        **Tip:** For a symbol-specific pre-selection use\r

        `GET /charts/universe/by-symbol?stockSymbol={symbol}`.\r

        \            \r

        ### cURL Example\r

        ```bash\r

        curl -X GET
        \"https://api.argaam.com/api/v1.1/charts/universe?countryId=1\" \\\r

        \     -H \"Accept: application/json\"\r

        ```"
      operationId: getChartsUniverse
security:
  - ApiKeyAuth: []
components:
  schemas:
    ApiV1ResponseOfChartUniverseResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Always true for successful responses.
        apiVersion:
          type: string
          description: Semantic API version (e.g., "1.0.0").
          nullable: true
        timestamp:
          type: string
          description: UTC timestamp when the response was generated.
          format: date-time
        requestId:
          type: string
          description: Unique request identifier for tracing.
          nullable: true
        data:
          $ref: "#/components/schemas/ChartUniverseResponse"
        meta:
          $ref: "#/components/schemas/ApiV1Meta2"
        rateLimit:
          $ref: "#/components/schemas/ApiV1RateLimit2"
      additionalProperties: false
      description: Standardized successful API response wrapper for v1.0.0 endpoints.
    ChartUniverseResponse:
      type: object
      properties:
        countryId:
          type: integer
          format: int32
        tree:
          type: array
          items:
            $ref: "#/components/schemas/ChartUniverseNode"
          nullable: true
      additionalProperties: false
    ApiV1Meta2:
      type: object
      properties:
        page:
          type: integer
          description: Current page number (1-based).
          format: int32
        pageSize:
          type: integer
          description: Number of items per page.
          format: int32
        totalRecords:
          type: integer
          description: Total number of records available across all pages.
          format: int32
        totalPages:
          type: integer
          description: Total number of pages.
          format: int32
          readOnly: true
        hasNextPage:
          type: boolean
          description: Whether there is a next page available.
          readOnly: true
        hasPreviousPage:
          type: boolean
          description: Whether there is a previous page available.
          readOnly: true
      additionalProperties: false
      description: Pagination and metadata information for collection responses.
    ApiV1RateLimit2:
      type: object
      properties:
        limit:
          type: integer
          description: Total request quota for the current window.
          format: int32
        remaining:
          type: integer
          description: Remaining requests in the current window.
          format: int32
        reset:
          type: string
          description: UTC timestamp when the rate limit window resets.
          format: date-time
      additionalProperties: false
      description: Rate limit information returned with each response.
    ChartUniverseNode:
      type: object
      properties:
        id:
          type: integer
          format: int32
        nameEn:
          type: string
          nullable: true
        nameAr:
          type: string
          nullable: true
        children:
          type: array
          items:
            $ref: "#/components/schemas/ChartUniverseNode"
          nullable: true
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
````