ashares_market_overview
Pack: china-stocks · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/ashares_market_overview for the schema, then POST the same URL with its arguments for the data.
A-share daily turnover, total/float market cap, turnover rate by exchange and combined, per trading day.
Tool description as the model sees it
A-share market-wide DAILY OVERVIEW by date, per exchange and combined: number of listed stocks, trading amount, total market cap, float (tradable) market cap and turnover rate (\u6362\u624b\u7387), for the Shanghai (SSE) and Shenzhen (SZSE) exchanges, all in 100 million CNY (\u4ebf\u5143). Answers “A-share daily turnover rate for 60 trading days”, “\u5168\u5e02\u573a\u6362\u624b\u7387”, “\u6caa\u6df1\u6d41\u901a\u5e02\u503c”, “A-share total and float market cap on 2026-11-12”, “margin balance as a share of float market cap” (divide ashares_margin_financing by float_market_cap_100m_cny), “\u4e24\u5e02\u6210\u4ea4\u989d”. Pass date, or start_date + end_date (or days, default 1 = latest trading day) for a history of one row per trading day, newest first. The SSE turnover rate is the exchange’s published float-based figure; the SZSE rate and the combined rate are COMPUTED as trading amount / float market cap and labelled so. Covers stocks only (not funds or bonds). If either exchange cannot be read for a day, that day carries the error and no combined figure rather than presenting half the market as the market. Non-trading days are skipped. Source: Shanghai Stock Exchange and Shenzhen Stock Exchange, daily market overview.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
date | string | no | One trading day, YYYY-MM-DD or YYYYMMDD. A non-trading day returns found:false with the nearest prior trading day. |
start_date | string | no | Range start (YYYY-MM-DD). Use with end_date (default: latest). |
end_date | string | no | Range end (YYYY-MM-DD). |
days | number | no | Most recent N trading days, 1-90 (default 1). Each day is two exchange calls, so large N is slow; missing days are listed, never silently dropped. |
Example call
Arguments
{
"date": "2026-11-12"
}curl
curl -X POST https://gateway.pipeworx.io/china-stocks/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ashares_market_overview","arguments":{"date":"2026-11-12"}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('ashares_market_overview', {
"date": "2026-11-12"
});More examples
{
"days": 20
}Response shape
| Field | Type | Description |
|---|---|---|
found | boolean | |
data_as_of | string | Latest trading day |
trading_days_returned | number | |
trading_days_requested | number | |
partial | boolean | |
partial_note | string | x |
resume_end_date | string | Pass as end_date to continue |
shortfall_note | string | x |
days_with_unreadable_exchange | array | Days where an exchange could not be read |
days | array | One row per trading day, newest first |
date | string | null | x |
start_date | string | null | x |
end_date | string | null | x |
nearest_prior_trading_day | string | null | x |
failed | array | x |
message | string | x (found:false) |
field_notes | object | |
source | string | Publisher and dataset |
Full JSON Schema
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"data_as_of": {
"type": "string",
"description": "Latest trading day"
},
"trading_days_returned": {
"type": "number"
},
"trading_days_requested": {
"type": "number"
},
"partial": {
"type": "boolean"
},
"partial_note": {
"type": "string",
"description": "x"
},
"resume_end_date": {
"type": "string",
"description": "Pass as end_date to continue"
},
"shortfall_note": {
"type": "string",
"description": "x"
},
"days_with_unreadable_exchange": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "x"
},
"sse_error": {
"type": "string",
"description": "x"
},
"szse_error": {
"type": "string",
"description": "x"
}
},
"additionalProperties": true
},
"description": "Days where an exchange could not be read"
},
"days": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "x"
},
"sse": {
"anyOf": [
{
"type": "object",
"properties": {
"listed_count": {
"type": [
"number",
"null"
],
"description": "x"
},
"trading_amount_100m_cny": {
"type": [
"number",
"null"
],
"description": "x"
},
"total_market_cap_100m_cny": {
"type": [
"number",
"null"
],
"description": "x"
},
"float_market_cap_100m_cny": {
"type": [
"number",
"null"
],
"description": "x"
},
"turnover_rate_pct": {
"type": [
"number",
"null"
],
"description": "x"
},
"turnover_rate_basis": {
"type": "string",
"description": "published or computed"
}
},
"additionalProperties": true
},
{
"type": "null"
}
]
},
"szse": {
"anyOf": [
{
"type": "object",
"properties": {
"listed_count": {
"type": [
"number",
"null"
],
"description": "x"
},
"trading_amount_100m_cny": {
"type": [
"number",
"null"
],
"description": "x"
},
"total_market_cap_100m_cny": {
"type": [
"number",
"null"
],
"description": "x"
},
"float_market_cap_100m_cny": {
"type": [
"number",
"null"
],
"description": "x"
},
"turnover_rate_pct": {
"type": [
"number",
"null"
],
"description": "x"
},
"turnover_rate_basis": {
"type": "string",
"description": "published or computed"
}
},
"additionalProperties": true
},
{
"type": "null"
}
]
},
"combined": {
"anyOf": [
{
"type": "object",
"properties": {
"listed_count": {
"type": [
"number",
"null"
],
"description": "x"
},
"trading_amount_100m_cny": {
"type": [
"number",
"null"
],
"description": "x"
},
"total_market_cap_100m_cny": {
"type": [
"number",
"null"
],
"description": "x"
},
"float_market_cap_100m_cny": {
"type": [
"number",
"null"
],
"description": "x"
},
"turnover_rate_pct": {
"type": [
"number",
"null"
],
"description": "x"
},
"turnover_rate_basis": {
"type": "string",
"description": "published or computed"
}
},
"additionalProperties": true
},
{
"type": "null"
}
],
"description": "null when an exchange was unreadable"
},
"note": {
"type": "string",
"description": "x"
}
},
"additionalProperties": true
},
"description": "One row per trading day, newest first"
},
"date": {
"type": [
"string",
"null"
],
"description": "x"
},
"start_date": {
"type": [
"string",
"null"
],
"description": "x"
},
"end_date": {
"type": [
"string",
"null"
],
"description": "x"
},
"nearest_prior_trading_day": {
"type": [
"string",
"null"
],
"description": "x"
},
"failed": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"description": "x"
},
"message": {
"type": "string",
"description": "x (found:false)"
},
"field_notes": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"source": {
"type": "string",
"description": "Publisher and dataset"
}
},
"additionalProperties": true
}Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}Connect to just the china-stocks pack
{
"mcpServers": {
"china-stocks": {
"url": "https://gateway.pipeworx.io/china-stocks/mcp"
}
}
}See Getting Started for client-specific install steps.