XSHE Ticker-Driven News API - Usage Guide

API Documentation

https://www.pressmonitor.com/en/docs/news-xshe-api-mcp

Overview

The Ticker-Driven Shenzhen Stock Exchange (XSHE) News API provides real-time, multilingual news access for all XSHE-listed companies. Access critical market-moving news across 100+ languages by simply providing a stock ticker symbol. This API is designed for traders, investors, wealth management platforms, and trading terminals.

API Version: 1.0.1

Base URL

https://api.pressmonitor.com/news-xshe/v1

Authentication

All endpoints require Bearer Token authentication with the format:

Authorization: Bearer secret_key:subscription_id

Example:

curl -H "Authorization: Bearer YOUR_SECRET_KEY:YOUR_SUBSCRIPTION_ID" \ "https://api.pressmonitor.com/news-xshe/v1/news-headlines?ticker=2594"

Available Endpoints

1. /names - Resolve Company Names to Tickers

Method: GET Operation ID: resolveNames

Convert partial or full company names into XSHE ticker symbols.

Parameters:

Example:

curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://api.pressmonitor.com/news-xshe/v1/names?name=BYD&count=5"

Response:

[ { "ticker": "2594", "name": "BYD Company Limited" }, { "ticker": "2936", "name": "Ping An Bank Co., Ltd." } ]

2. /news-headlines - News Headlines

Method: GET Operation ID: newsHeadlines Credits: 1 per story

Returns basic news headlines with titles and URLs.

Parameters:

Example:

curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://api.pressmonitor.com/news-xshe/v1/news-headlines?ticker=2594&lang_code=en&count=10&sort=latest"

Response Fields:

3. /news-briefs - News Briefs

Method: GET Operation ID: newsBriefs Credits: 2 per story

Returns headlines with short AI-generated summaries.

Parameters: Same as /news-headlines

Example:

curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://api.pressmonitor.com/news-xshe/v1/news-briefs?ticker=2936&country_code=CN&sort=relevance"

Response Fields: All headline fields plus:

4. /news-fulltext - Full Articles

Method: GET Operation ID: newsFulltext Credits: 5 per story

Returns complete articles with full body text.

Parameters: Same as /news-headlines

Example:

curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://api.pressmonitor.com/news-xshe/v1/news-fulltext?ticker=2415&lang_code=en&count=5"

Response Fields: All brief fields plus:

5. /news-fulltext-metadata - Full Articles + Metadata

Method: GET Operation ID: newsFulltextMetadata Credits: 7 per story

Returns full articles with enriched metadata for knowledge graphs and compliance.

Parameters: Same as /news-headlines

Example:

curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://api.pressmonitor.com/news-xshe/v1/news-fulltext-metadata?ticker=300750&count=3"

Response Fields: All fulltext fields plus:

6. Translated Endpoints

Add -translated suffix to any news endpoint for machine translation. Requires additional target_lang_code parameter.

Available Translated Endpoints:

Example:

curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://api.pressmonitor.com/news-xshe/v1/news-headlines-translated?ticker=2594&target_lang_code=zh&count=5"

Translation Response Format: Each item includes a tr object with translated fields:

{ "id": "...", "title": "Original Title", "tr": { "title": "翻译标题", "description": "翻译描述", "source_lang_code": "en", "target_lang_code": "zh" } }

Pagination

When using sort=latest, responses include a next object with pagination info:

{ "items": [...], "credits": {...}, "next": { "search_after": "opaque_cursor_string", "count": 20, "sort": "latest" } }

Use search_after value in your next request:

curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://api.pressmonitor.com/news-xshe/v1/news-headlines?ticker=2594&search_after=CURSOR&sort=latest"

Response Headers

All responses include:

Credits Tracking

All responses include a credits object:

{ "credits": { "rate": 1, "quantity": 15, "total": 9850, "request_id": "req_abc123" } }

Error Responses

All errors follow RFC 7807 Problem Details format:

{ "type": "about:blank", "title": "Bad Request", "status": 400, "detail": "Missing required parameter: ticker", "instance": "/news-headlines" }

HTTP Status Codes:

Best Practices

  1. Use appropriate endpoints - Headlines for quick scans, fulltext for analysis
  2. Leverage pagination - Use search_after for large result sets with sort=latest
  3. Filter by language/country - Reduce noise and credits usage
  4. Monitor credits - Track credits.total in responses
  5. Handle rate limits - Respect X-RateLimit-* headers
  6. Cache results - Avoid redundant requests for the same data
  7. Use sort=relevance for topic research, sort=latest for real-time monitoring

Example Workflow: Track BYD Company News

# 1. Get latest headlines curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://api.pressmonitor.com/news-xshe/v1/news-headlines?ticker=2594&lang_code=en&count=20&sort=latest" # 2. Get detailed briefs for important stories curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://api.pressmonitor.com/news-xshe/v1/news-briefs?ticker=2594&lang_code=en&count=5&sort=relevance" # 3. Fetch full articles for deep analysis curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://api.pressmonitor.com/news-xshe/v1/news-fulltext?ticker=2594&lang_code=en&count=3" # 4. Get enriched metadata for compliance curl -H "Authorization: Bearer YOUR_TOKEN" \ "https://api.pressmonitor.com/news-xshe/v1/news-fulltext-metadata?ticker=2594&count=1"

Support

Docs: https://www.pressmonitor.com/en/docs/news-xshe-api-mcp

Email: support@pressmonitor.com