Jin10 APIjin10.com ↗
Access real-time flash news, economic calendar events, macroeconomic indicators, and full article content from jin10.com via a structured JSON API.
What is the Jin10 API?
The Jin10 API provides 6 endpoints covering real-time market flash news, economic calendar events, macroeconomic indicator categories, trending articles, full article content, and cross-site search. The get_flash_news endpoint alone returns up to 10 fields per item — including id, time, type, data, important, tags, channel, remark, and extras — making it practical for building live financial news feeds or alert systems.
curl -X GET 'https://api.parse.bot/scraper/c33474b6-e2ef-4d29-bdcb-fcb0cd887c51/get_flash_news?max_id=20260611154221243800&classify=6' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace jin10-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Jin10 Financial Data API - SDK walkthrough: bounded, re-runnable."""
from parse_apis.jin10_financial_data_api import (
Jin10, Category, ArticleNotFound
)
client = Jin10()
# Fetch today's economic calendar entries, capped at 5 items.
for entry in client.calendarentries.list(category=Category.CJ, limit=5):
print(entry.indicator_name, entry.country, entry.star, entry.pub_time)
# Get the current hot articles and drill into the first one for full content.
article_summary = client.articlesummaries.hot(limit=1).first()
if article_summary:
full_article = article_summary.details()
print(full_article.title, full_article.hits, full_article.display_datetime)
# Fetch latest flash news, capped at 3 items.
for flash in client.flashnewses.list(limit=3):
print(flash.id, flash.time, flash.important)
# Typed error handling: attempt to fetch a non-existent article.
try:
client.articles.get(article_id="999999999")
except ArticleNotFound as exc:
print(f"Article not found: {exc.article_id}")
print("exercised: calendarentries.list / articlesummaries.hot / details / flashnewses.list / articles.get")
Fetch real-time market flash news from jin10.com. Returns a chronologically-ordered list of flash news items including content, timestamps, importance flags, and associated market quotes. Supports backward pagination via max_id (fetch items older than a given ID) and category filtering. Each page returns up to ~20 items.
| Param | Type | Description |
|---|---|---|
| max_id | string | Maximum flash news ID for pagination. Returns items published before this ID. Obtain from a previous response's last item ID. |
| classify | string | Category filter ID for flash news. Known values include '6' for oil-related news. |
{
"type": "object",
"fields": {
"items": "array of flash news items with id, time, type, data (content object), important, tags, channel, remark, extras"
},
"sample": {
"data": {
"items": [
{
"id": "20260611154221243800",
"data": {
"pic": "",
"title": "",
"source": "",
"content": "sample flash content",
"source_link": ""
},
"tags": [],
"time": "2026-06-11 15:42:21",
"type": 0,
"extras": {
"ad": false
},
"remark": [],
"voices": null,
"channel": [
3,
4,
5
],
"important": 0,
"voice_status": "ready"
}
]
},
"status": "success"
}
}About the Jin10 API
Flash News and Search
get_flash_news returns a paginated stream of market flash news items from jin10.com. Each item carries a time field, a data object with content, title, and source, an important flag to distinguish high-priority items, and tags for topic classification. Pagination is handled via max_id — pass the lowest id from a prior response to fetch older items. The optional classify parameter filters results to a specific news category. search_news accepts a query string (Chinese or English) and an offset for pagination, returning categorized results across flash news, market instruments, mini-programs, and topics, each as a sub-section inside the headers object.
Economic Calendar and Indicators
get_economic_calendar returns scheduled economic data releases for a given date (YYYY-MM-DD), defaulting to today if the date parameter is omitted. Each entry includes indicator_name, country, star (significance rating), unit, and the three standard release values: previous, consensus, and act (actual). A category parameter narrows results to a specific release type. get_economic_indicators returns macroeconomic indicator categories; passing category_id 52001 (the default) retrieves the national macro category tree, where each category contains nested items with title, type_id, and a data object holding the latest values and chart references.
Articles
get_hot_articles returns the current trending article list with fields including id, title, web_thumbs, mobile_thumbs, introduction, display_datetime, source, and categories. To retrieve the full text of any article, pass its numeric id to get_article_detail, which returns the content field as HTML alongside author metadata (nick, id, avatar), display_datetime, hits, and introduction. Article IDs can be sourced from get_hot_articles or search_news results.
The Jin10 API is a managed, monitored endpoint for jin10.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when jin10.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official jin10.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a real-time financial news ticker using
get_flash_newswithmax_idpagination and theimportantflag for priority filtering. - Populate an economic calendar widget with scheduled releases, consensus forecasts, and actual values from
get_economic_calendar. - Alert trading systems when high-significance indicators (
starfield) are published with actual values diverging from consensus. - Aggregate trending Chinese financial news article summaries using
get_hot_articlesand resolve full HTML content viaget_article_detail. - Build a macroeconomic dashboard using
get_economic_indicatorsto browse country-level indicator trees and latest data values. - Implement a financial search feature that retrieves flash news, market instruments, and topics from a single
search_newsquery.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does jin10.com have an official developer API?+
What does `get_economic_calendar` return, and how do I filter it by date?+
indicator_name, country, star (significance), unit, previous, consensus, and act (actual) values. Pass a date string in YYYY-MM-DD format; if omitted, it defaults to today's date. The optional category parameter further narrows results to a specific release type.Does the API expose historical flash news archives or just recent items?+
get_flash_news endpoint is oriented toward recent and real-time items, with pagination going backward via max_id. Deep historical archives are not a documented feature of the current endpoint set. You can fork this API on Parse and revise it to add a dedicated historical flash news endpoint if your use case requires longer lookback windows.Are individual economic indicator time-series available, or only the latest snapshot?+
get_economic_indicators returns the latest data values and chart references nested inside each indicator's data object — full time-series arrays are not exposed as a distinct endpoint. The API covers indicator categories, item metadata, and current values. You can fork it on Parse and revise to add an endpoint that returns historical series for a specific type_id.What pagination approach does `get_flash_news` use, and where do I get the cursor?+
max_id parameter. Pass the id value of the last (oldest) item from your previous response to retrieve flash news items published before that point. The id is a string field present on every item in the data array.