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

> Search and filter stocks using natural language queries, then refine your results with technical, fundamental, and popularity-based conditions tailored to your investment strategy. Access real-time trending queries, hot stock screening conditions, and community discussions to discover what other investors are watching.

**Category:** Finance & Markets | **Website:** [xuangu.eastmoney.com/](https://xuangu.eastmoney.com/) | **Docs:** [parse.bot/marketplace/5ffc2e43-9b35-4bbe-a85a-9cabfc8c5bb4/xuangu-eastmoney-com-api](https://parse.bot/marketplace/5ffc2e43-9b35-4bbe-a85a-9cabfc8c5bb4/xuangu-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-xuangu-eastmoney-com-api-5ffc2e43/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_community_posts

Get stock community discussion posts from EastMoney's Guba forum related to the stock screening topic (znxg). Returns posts with title, content, author, and publish time. Paginated by page/page_size.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for results pagination. |
| `page_size` | integer | No | Number of posts per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-xuangu-eastmoney-com-api-5ffc2e43/get_community_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>"}'
```

### get_filter_conditions

Get the full hierarchical tree of filter conditions available for stock or fund screening. Returns all categories (范围, 基本面, 行情技术面, 消息面, 人气&涨停) with their children and parameter options.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | No | Domain type for filtering. Accepted values: 'stock', 'fund'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-xuangu-eastmoney-com-api-5ffc2e43/get_filter_conditions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"<string>"}'
```

### get_filter_conditions_fundamentals

Get filter conditions related to fundamentals: valuation (PE, PB), per-share metrics (EPS, BPS), profitability (ROE, net profit), revenue growth, and dividend indicators.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-xuangu-eastmoney-com-api-5ffc2e43/get_filter_conditions_fundamentals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_filter_conditions_news

Get filter conditions related to news and events: major announcements (限售解禁, 定向增发, 资产重组), institutional attention (调研, 评级, 持股比例), and dragon-tiger list (龙虎榜) data.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-xuangu-eastmoney-com-api-5ffc2e43/get_filter_conditions_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_filter_conditions_popularity

Get filter conditions related to popularity ranking (股吧人气排名, 粉丝占比) and limit-up (涨停) status including 首板, 连板, and consecutive limit-up days.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-xuangu-eastmoney-com-api-5ffc2e43/get_filter_conditions_popularity \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_filter_conditions_range

Get filter conditions related to listing scope and range: market type (沪市/深市/创业板/科创板/北交所), listing time, concepts, and index membership.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-xuangu-eastmoney-com-api-5ffc2e43/get_filter_conditions_range \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_filter_conditions_technical

Get filter conditions related to technical analysis and K-line patterns: MACD (golden/death cross, divergence), KDJ, moving averages, classic candlestick patterns (放量突破, 低位资金净流入), and intraday K-line patterns.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-xuangu-eastmoney-com-api-5ffc2e43/get_filter_conditions_technical \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_hot_conditions

Get curated hot screening conditions that are currently trending on EastMoney's stock screener. Each condition includes a title, full query question, stock count, change percentage, and tags. Supports pagination via last_ids.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `last_ids` | string | No | JSON array of last seen IDs for pagination (e.g. '[141,77,80]'). Omit for first page. |
| `page_size` | integer | No | Number of hot conditions to return per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-xuangu-eastmoney-com-api-5ffc2e43/get_hot_conditions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"last_ids":"<string>","page_size":"<integer>"}'
```

### get_real_time_hot_queries

Get real-time hot search query recommendations from the platform. Recommendations are popular screening queries users can try. Also returns stock heat ranking data (empty object when market is closed).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-xuangu-eastmoney-com-api-5ffc2e43/get_real_time_hot_queries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_stock_detail

Get details for a specific stock by searching its code through the AI stock screener. Returns the stock's market data including latest price, PE ratio, market cap, PB ratio, and trading volume. Uses the same screening engine as screen_stocks but optimized for single-stock lookup.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `code` | string | Yes | Stock code to look up (e.g. '600519' for Kweichow Moutai, '000001' for Ping An Bank). Leading zeros are significant. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-xuangu-eastmoney-com-api-5ffc2e43/get_stock_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"<string>"}'
```

### screen_stocks

Search for stocks using natural language or filter conditions on EastMoney's AI stock screener. Accepts Chinese or symbolic queries like 'PE<20' or '市值>1000亿'. Returns matching stocks with market data columns, parsed filter conditions, and total count. Paginated by page_no/page_size.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page_no` | integer | No | Page number for results pagination. |
| `page_size` | integer | No | Number of results per page. |
| `query` | string | Yes | Search keyword or natural language query (e.g. 'PE<20', '市值>1000亿', '白酒') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-xuangu-eastmoney-com-api-5ffc2e43/screen_stocks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_no":"<integer>","page_size":"<integer>","query":"<string>"}'
```