# Real-time Quote

Real-time order-book snapshot, one row per security, continuously refreshed during trading hours. Fields include last price, open/high/low, previous close, volume, turnover, and snapshot time, and a basket of tickers can be queried in one call. Use it for intraday monitoring, live dashboards, and on-the-fly percentage-change calculations. Outside trading hours it returns the prior session's closing snapshot, and the snapshot timestamp may drift slightly past the close.

`GET /v2/market/realtime`

## Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | No | Single code or a comma-separated basket (max 200), e.g. 600519.SH,000001.SZ; omit to page the whole market |

## Response Fields

| Field | Type | Description |
| --- | --- | --- |
| `symbol` | string | Stock/index ticker |
| `name` | string | Security name |
| `price` | number | Latest traded price |
| `open` | number | Open price |
| `high` | number | Intraday high |
| `low` | number | Intraday low |
| `pre_close` | number | Previous close |
| `volume` | number | Cumulative volume (shares) |
| `amount` | number | Cumulative turnover (CNY) |
| `trade_time` | string | Quote timestamp from source |
| `pct_chg` | number | Percent change vs previous close (%) |

## API Example

cURL

```
curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v2/market/realtime?symbol=600519.SH,000001.SZ"
```

Python SDK

```
from asharehub import AShareHub

client = AShareHub(api_key="YOUR_KEY")
df = client.realtime(symbol="600519.SH,000001.SZ")
print(df.head())
```

## Sample Data

returns a pandas.DataFrame

| symbol | name | price | open | high | low | pre_close | volume | amount | trade_time | … +1 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 000001.SZ | 平安银行 | 10.23 | 10.42 | 10.47 | 10.19 | 10.42 | 123648200 | 1270902948 | 2026-06-26T15:00:00 | … |
| 600519.SH | XD贵州茅 | 1168.63 | 1199 | 1199 | 1168.1 | 1184.08 | 5006600 | 5922014054 | 2026-06-26T15:00:00 | … |
