# 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**](https://docs.infoway.io/en-docs/getting-started/api-limitation/rest-api-limitation) 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"
    },
    {
      "symbol": ".IXIC.US",
      "name_cn": "纳斯达克综合指数",
      "name_hk": "納斯達克綜合指數",
      "name_en": "NASDAQ Composite Index"
    }
  ]
}
```

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