---
title: "Get the discovery tree pre-selected to a specific trading symbol."
url: "https://developer.argaam.com/apis/search-discovery-layer-api-sandbox-v1/versions/7b9c43fb-96d0-4164-9da6-4249bbd8ed0b/operations/getChartsUniverseBySymbol"
---

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

# Get the discovery tree pre-selected to a specific trading symbol.

`GET` `/api/v1.1/charts/universe/by-symbol`

Operation ID: `getChartsUniverseBySymbol`

Convenience variant of `GET /charts/universe` that pre-populates the discovery tree with the company matching the supplied ticker symbol. Useful for deep-linking directly to a stock chart from an external page. **Tip:** Use `GET /companies/by-symbol/{symbol}` to resolve the company ID if you only have the ticker and need additional metadata.

## Query parameters

- `countryId` (integer, int32, optional) - Country ID. Default: `1` (Saudi Arabia). Defaults to `1`.
- `stockSymbol` (string, optional) - Trading symbol / ticker to pre-select (e.g. `2222`). Defaults to `0`.

## Responses

- `200` - Discovery tree with pre-selected company 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/by-symbol:
    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
        - name: stockSymbol
          in: query
          description: Trading symbol / ticker to pre-select (e.g. `2222`). Defaults to `0`.
          schema:
            type: string
            default: "0"
          example: "2222"
      responses:
        "200":
          description: Discovery tree with pre-selected company returned.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiV1ResponseOfChartUniverseBySymbolResponse"
              example:
                success: true
                apiVersion: "1.1"
                timestamp: 2024-06-01T12:00:00Z
                requestId: req_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4
                data:
                  countryId: 1
                  symbol: "2222"
                  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 discovery tree pre-selected to a specific trading symbol.
      description: "Convenience variant of `GET /charts/universe` that pre-populates
        the\r

        discovery tree with the company matching the supplied ticker symbol.\r

        Useful for deep-linking directly to a stock chart from an external
        page.\r

        \            \r

        **Tip:** Use `GET /companies/by-symbol/{symbol}` to resolve the company
        ID\r

        if you only have the ticker and need additional metadata."
      operationId: getChartsUniverseBySymbol
security:
  - ApiKeyAuth: []
components:
  schemas:
    ApiV1ResponseOfChartUniverseBySymbolResponse:
      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/ChartUniverseBySymbolResponse"
        meta:
          $ref: "#/components/schemas/ApiV1Meta2"
        rateLimit:
          $ref: "#/components/schemas/ApiV1RateLimit2"
      additionalProperties: false
      description: Standardized successful API response wrapper for v1.0.0 endpoints.
    ChartUniverseBySymbolResponse:
      type: object
      properties:
        countryId:
          type: integer
          format: int32
        symbol:
          type: string
          nullable: true
        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
```