> For the complete documentation index, see [llms.txt](https://docs.infoway.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infoway.io/en-docs/rest-api/get-basic-info/get-market-overview.md).

# GET Market Overview Data

### Description

This group of endpoints provides market-level overview data, including market temperature (valuation/sentiment), advance/decline distribution, global indexes, leading industries, and ranking configuration.

### Rate Limit

Shares the same rate limit with other endpoints. Refer to [API Rate Limits](https://docs.infoway.io/getting-started/api-limitation).

### Error Codes

Refer to [HTTP Error Codes](https://docs.infoway.io/getting-started/error-codes/http).

### Request Headers

| Parameter | Type   | Required | Description  |
| --------- | ------ | -------- | ------------ |
| `apiKey`  | String | Yes      | Your API Key |

### Supported Markets

`HK` (Hong Kong), `US` (United States), `CN` (China A-shares)

***

#### Market Temperature

Get market valuation and sentiment temperature (0-100), useful for gauging market heat.

**Endpoint**

* Base path: `/common/v2/basic/market/temperature`
* Full path: `https://data.infoway.io/common/v2/basic/market/temperature`

**Query Parameters**

| Parameter | Type   | Required | Description                                       | Example |
| --------- | ------ | -------- | ------------------------------------------------- | ------- |
| `market`  | String | No       | Market codes, comma-separated. Default `HK,US,CN` | `HK,US` |

**Response Example**

```json
{
  "markets": ["HK", "US"],
  "data": {
    "list": [
      {
        "market": "HK",
        "temp": "69",
        "temp_intro": "Temperature is moderate and rising",
        "valuation": "80",
        "sentiment": "58"
      },
      {
        "market": "US",
        "temp": "36",
        "valuation": "54",
        "sentiment": "18"
      }
    ]
  }
}
```

| Field        | Type   | Description                                  |
| ------------ | ------ | -------------------------------------------- |
| `market`     | String | Market code                                  |
| `temp`       | String | Overall temperature (0-100, higher = hotter) |
| `temp_intro` | String | Temperature description                      |
| `valuation`  | String | Valuation temperature                        |
| `sentiment`  | String | Sentiment temperature                        |

***

#### Market Breadth

Get advance/decline distribution statistics.

**Endpoint**

* Base path: `/common/v2/basic/market/breadth/{market}`
* Full path: `https://data.infoway.io/common/v2/basic/market/breadth/{market}`

**Path Parameters**

| Parameter | Type   | Required | Description | Example |
| --------- | ------ | -------- | ----------- | ------- |
| `market`  | String | Yes      | Market code | `HK`    |

**Response Example**

```json
{
  "market": "HK",
  "data": {
    "flatline": 928,
    "rise_less_than_three": 816,
    "rise_three_to_five": 200,
    "rise_five_to_seven": 110,
    "rise_more_than_seven": 128,
    "fall_less_than_three": 686,
    "fall_three_to_five": 154,
    "fall_five_to_seven": 69,
    "fall_more_than_seven": 88
  }
}
```

| Field                  | Type    | Description               |
| ---------------------- | ------- | ------------------------- |
| `flatline`             | Integer | Unchanged stocks          |
| `rise_less_than_three` | Integer | Stocks with <3% gain      |
| `rise_three_to_five`   | Integer | Stocks with 3%-5% gain    |
| `rise_five_to_seven`   | Integer | Stocks with 5%-7% gain    |
| `rise_more_than_seven` | Integer | Stocks with >7% gain      |
| `fall_less_than_three` | Integer | Stocks with <3% decline   |
| `fall_three_to_five`   | Integer | Stocks with 3%-5% decline |
| `fall_five_to_seven`   | Integer | Stocks with 5%-7% decline |
| `fall_more_than_seven` | Integer | Stocks with >7% decline   |

***

#### Global Indexes

Get a list of major global market indexes.

**Endpoint**

* Base path: `/common/v2/basic/market/indexes`
* Full path: `https://data.infoway.io/common/v2/basic/market/indexes`

**Response Example**

```json
{
  "data": {
    "indexes": [
      {"counter_id": "IX/US/.DJI", "name": "Dow Jones", "market": "US"},
      {"counter_id": "IX/US/.IXIC", "name": "NASDAQ", "market": "US"},
      {"counter_id": "IX/US/.SPX", "name": "S&P 500", "market": "US"},
      {"counter_id": "IX/HK/HSI", "name": "Hang Seng Index", "market": "HK"},
      {"counter_id": "IX/HK/HSTECH", "name": "Hang Seng TECH", "market": "HK"},
      {"counter_id": "IX/SH/000001", "name": "SSE Composite", "market": "CN"},
      {"counter_id": "IX/SZ/399001", "name": "SZSE Component", "market": "CN"}
    ]
  }
}
```

| Field        | Type   | Description |
| ------------ | ------ | ----------- |
| `counter_id` | String | Index ID    |
| `name`       | String | Index name  |
| `market`     | String | Market      |

***

#### Leading Industries

Get today's top-performing industries and their leading stocks.

**Endpoint**

* Base path: `/common/v2/basic/market/leaders/{market}`
* Full path: `https://data.infoway.io/common/v2/basic/market/leaders/{market}`

**Path Parameters**

| Parameter | Type   | Required | Description | Example |
| --------- | ------ | -------- | ----------- | ------- |
| `market`  | String | Yes      | Market code | `HK`    |

**Query Parameters**

| Parameter | Type    | Required | Description                            | Example |
| --------- | ------- | -------- | -------------------------------------- | ------- |
| `limit`   | Integer | No       | Number of industries, 1-50, default 10 | `10`    |

**Response Example**

```json
{
  "market": "HK",
  "data": {
    "lists": [
      {
        "counter_id": "BK/HK/IN20351",
        "name": "Insurance Brokers",
        "chg": "0.1535",
        "leading_name": "ZhongMiao Holdings",
        "leading_last_done": "40.400",
        "leading_chg": "0.1717",
        "rise_num": 2,
        "fall_num": 0
      }
    ]
  }
}
```

| Field               | Type    | Description           |
| ------------------- | ------- | --------------------- |
| `counter_id`        | String  | Industry sector ID    |
| `name`              | String  | Industry name         |
| `chg`               | String  | Industry price change |
| `leading_name`      | String  | Leading stock name    |
| `leading_last_done` | String  | Leading stock price   |
| `leading_chg`       | String  | Leading stock change  |
| `rise_num`          | Integer | Advancing stocks      |
| `fall_num`          | Integer | Declining stocks      |

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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-market-overview.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.