# Wap Eastmoney — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access real-time stock quotes, historical K-line charts at 1-minute intervals, and tick data for Chinese securities markets and beyond. Search specific securities, retrieve sector performance, view order books, and pull comprehensive stock lists to power your financial analysis and trading applications.

**Category:** Finance & Markets | **Website:** [wap.eastmoney.com/](https://wap.eastmoney.com/) | **Docs:** [parse.bot/marketplace/888dd0ac-5b46-493f-8438-2c6d532280ab/wap-eastmoney-com-api](https://parse.bot/marketplace/888dd0ac-5b46-493f-8438-2c6d532280ab/wap-eastmoney-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-wap-eastmoney-com-api-888dd0ac/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_kline_data

Fetch historical K-line (candlestick) data for a security. Returns OHLCV with change and turnover metrics at configurable intervals from 1-minute to monthly. The full date range is available by default; narrow with begin/end in YYYYMMDD format. Each kline includes datetime, open, close, high, low, volume, amount, amplitude, change_pct, change_amt, and turnover_rate.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `adjustment` | integer | No | Price adjustment type: 0=none, 1=forward-adjusted, 2=backward-adjusted |
| `begin` | string | No | Start date in YYYYMMDD format |
| `end` | string | No | End date in YYYYMMDD format |
| `interval` | integer | No | K-line interval: 1=1min, 5=5min, 15=15min, 30=30min, 60=60min, 101=daily, 102=weekly, 103=monthly |
| `limit` | integer | No | Maximum number of K-lines to return |
| `secid` | string | Yes | Security ID in format 'market.code' (e.g., '1.600519'). Obtain from search_security results[*].QuoteID. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wap-eastmoney-com-api-888dd0ac/get_kline_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adjustment":"<integer>","begin":"<string>","end":"<string>","interval":"<integer>","limit":"<integer>","secid":"<string>"}'
```

### get_order_book

Fetch Level-2 order book (bid/ask depth) for a security. Returns up to 5 bid and 5 ask price levels with volume at each level. Bid/ask arrays may be empty outside trading hours (09:30-15:00 CST).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `secid` | string | Yes | Security ID in format 'market.code' (e.g., '1.600519'). Obtain from search_security results[*].QuoteID. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wap-eastmoney-com-api-888dd0ac/get_order_book \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"secid":"<string>"}'
```

### get_realtime_quote

Fetch a real-time quote snapshot for one security. Returns current price, OHLC, volume, amount, market cap, PE ratio, and change metrics. Field codes (f43, f44, ...) can be customized via the fields parameter; defaults cover the most common market-data fields.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fields` | string | No | Comma-separated field codes to return (e.g., 'f43,f44,f45,f57,f58'). Default includes price, volume, PE, market cap fields: f43,f44,f45,f46,f47,f48,f60,f57,f58,f9,f20,f162,f167,f168,f169,f170,f171,f172,f116,f117 |
| `secid` | string | Yes | Security ID in format 'market.code' (e.g., '1.600519' for Shanghai, '0.000001' for Shenzhen). Obtain from search_security results[*].QuoteID. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wap-eastmoney-com-api-888dd0ac/get_realtime_quote \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fields":"<string>","secid":"<string>"}'
```

### get_sector_list

Fetch a paginated list of industry or concept sectors with performance metrics. Each sector includes a BK-prefixed code, name, change percentage, volume, and leading stock information. Use sector_type to switch between industry classification and thematic concept groupings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based) |
| `page_size` | integer | No | Results per page |
| `sector_type` | string | No | Sector classification type: 'industry' for industry sectors, 'concept' for thematic concept sectors |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wap-eastmoney-com-api-888dd0ac/get_sector_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","sector_type":"<string>"}'
```

### get_stock_list

Fetch a paginated list of stocks with real-time performance data. Supports filtering by market type and sorting by various field codes. Default filter includes Shenzhen and Shanghai A-shares. Each stock includes code, name, price, change metrics, volume, amount, PE, market cap, and more.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fs` | string | No | Filter string for market/type segments (e.g., 'm:1+t:2' for Shanghai A-shares only, 'm:0+t:6,m:0+t:80,m:1+t:2,m:1+t:23' for all A-shares) |
| `page` | integer | No | Page number (1-based) |
| `page_size` | integer | No | Results per page |
| `sort_field` | string | No | Field code to sort by (e.g., 'f3' for change%, 'f6' for amount, 'f2' for price) |
| `sort_order` | integer | No | Sort order: 1=descending, 0=ascending |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wap-eastmoney-com-api-888dd0ac/get_stock_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fs":"<string>","page":"<integer>","page_size":"<integer>","sort_field":"<string>","sort_order":"<integer>"}'
```

### get_tick_data

Fetch recent tick-by-tick trade data for a security. Returns the most recent trades from the latest trading session, each with timestamp, price, volume (in lots), and inferred trade direction (Buy/Sell/Neutral). Data is only available for the current or most recent trading day.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of ticks to return |
| `secid` | string | Yes | Security ID in format 'market.code' (e.g., '1.600519'). Obtain from search_security results[*].QuoteID. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wap-eastmoney-com-api-888dd0ac/get_tick_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","secid":"<string>"}'
```

### search_security

Full-text search over securities (stocks, indices, funds) by name, code, or pinyin abbreviation. Returns matching securities with their QuoteID (secid) needed for quote, kline, tick, and order book lookups. A single code like '600519' typically yields one exact match; broader terms yield multiple.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | No | Maximum number of results to return |
| `query` | string | Yes | Search keyword: stock name, numeric code, or pinyin abbreviation (e.g. 'GZMT' for 贵州茅台) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wap-eastmoney-com-api-888dd0ac/search_security \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":"<integer>","query":"<string>"}'
```