# GET Symbol List

### 1. Endpoint

* Base Path: `/common/basic/symbols`
* Full Path: `https://data.infoway.io
  /common/basic/symbols`

### 2. Request Frequency

This endpoint follows the same rate limits as other APIs. The number of allowed requests per second depends on your subscription plan. Please refer to the [**Rate Limit**](/en-docs/getting-started/api-limitation/rest-api-limitation.md) documentation for details.

### 3. Request Parameters

<table><thead><tr><th width="84.6666259765625">Parameter</th><th width="84.5555419921875">Type</th><th width="85.22222900390625">Required</th><th width="219.5556640625">Description</th><th>Example</th></tr></thead><tbody><tr><td><code>type</code></td><td><code>String</code></td><td>Yes</td><td>Market type. See the <em>Type Reference</em> section below.</td><td><code>STOCK_US</code></td></tr><tr><td><code>symbols</code></td><td><code>String</code></td><td>No</td><td>Comma-separated list of specific symbols to query.</td><td><code>.DJI.US,.IXIC.US</code></td></tr></tbody></table>

#### 3.1 Type Reference

| Type Code  |                  |
| ---------- | ---------------- |
| `STOCK_US` | U.S. Stocks      |
| `STOCK_CN` | China A-Shares   |
| `STOCK_HK` | Hong Kong Stocks |
| `FUTURES`  | Futures          |
| `FOREX`    | Foreign Exchange |
| `ENERGY`   | Energy           |
| `METAL`    | Metals           |
| `CRYPTO`   | Cryptocurrency   |
| `STOCK_IN` | India Stocks     |
| `STOCK_JP` | Japan Stocks     |

### 4. Example Request

```
GET https://data.infoway.io/common/basic/symbols?type=STOCK_US&symbols=.DJI.US,.IXIC.US
```

### 5. Example Response

```json
{
  "ret": 200,
  "msg": "success",
  "traceId": "ed8a84d9-4575-4077-bc1c-31b17d0c8977",
  "data": [
    {
      "symbol": ".DJI.US",
      "name_cn": "道琼斯指数",
      "name_hk": "道瓊斯指數",
      "name_en": "Dow Jones Industrial Average",
      "index": true
    },
    {
      "symbol": ".IXIC.US",
      "name_cn": "纳斯达克综合指数",
      "name_hk": "納斯達克綜合指數",
      "name_en": "NASDAQ Composite Index",
      "index": true
    }
  ]
}
```

#### 5.1 Response Fields

<table><thead><tr><th width="99.66668701171875">Field</th><th width="99.888916015625">Type</th><th width="99.66668701171875">Required</th><th width="179.77783203125">Description</th><th>Example</th></tr></thead><tbody><tr><td><code>symbol</code></td><td><code>String</code></td><td>Yes</td><td>Symbol code of the instrument.</td><td><code>AAPL.US</code></td></tr><tr><td><code>name_cn</code></td><td><code>String</code></td><td>No</td><td>Name in Simplified Chinese.</td><td><code>苹果</code></td></tr><tr><td><code>name_hk</code></td><td><code>String</code></td><td>No</td><td>Name in Traditional Chinese.</td><td><code>蘋果</code></td></tr><tr><td><code>name_en</code></td><td><code>String</code></td><td>No</td><td>Name in English.</td><td><code>Apple Inc.</code></td></tr><tr><td><code>index</code></td><td><code>String</code></td><td>No</td><td>Index flag.</td><td><code>true</code></td></tr></tbody></table>

### 6. Notes

* This endpoint is primarily used to verify product coverage and symbol mappings before requesting market data.
* The response may contain localized names (`name_cn`, `name_hk`, `name_en`) depending on availability.
* To ensure up-to-date symbol data, we recommend caching results with a reasonable refresh interval.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.infoway.io/en-docs/rest-api/get-basic-info/get-symbol-list.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.