Jinse APIjinse.cn ↗
Access Jinse Finance (jinse.cn) crypto news, flash alerts, article content, trending stories, and keyword search via a structured JSON API.
What is the Jinse API?
The Jinse Finance API provides 6 endpoints covering cryptocurrency and blockchain news from jinse.cn, including paginated article lists, a 7×24 flash news feed, full article content, and keyword search. The get_flash_news_list endpoint returns date-grouped breaking news with cursor-based pagination, while get_hot_news surfaces the top 10 articles ranked by read count over the past 24 hours.
curl -X GET 'https://api.parse.bot/scraper/aa091d79-fca5-4937-a2a4-34bc38dc03c3/get_news_list?limit=10&category=industry&information_id=0' \ -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 jinse-cn-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.
from parse_apis.jinse_finance_api import JinseFinance, NewsCategory, ArticleNotFound
client = JinseFinance()
# List available categories
for cat in client.categories.list():
print(cat.key, cat.name)
# List news articles in the Meme category
for article in client.articles.list(category=NewsCategory.MEME, limit=5):
print(article.id, article.title, article.extra.author, article.extra.read_number)
# Get full detail of an article
detail = client.articledetails.get(article_id="3734205")
print(detail.article_id, detail.title)
# List hot articles
for hot in client.hotarticles.list():
print(hot.id, hot.title, hot.read_number, hot.author.nickname)
# List flash news
for flash in client.flashnewses.list(limit=5):
print(flash.id, flash.content_prefix, flash.grade, flash.date)
# Search for news
result = client.searchresults.search(keyword="Bitcoin")
print(result.project.name, result.project.identifier)
for topic in result.topic:
print(topic.id, topic.title, topic.author)
Retrieve a paginated list of news articles by category key. Returns articles sorted by recency with pagination cursors (top_id and bottom_id) for fetching subsequent pages. Each article includes title, summary, author info, read count, and publication timestamp. Paginate by passing the bottom_id from a previous response as information_id.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of items to return per page. |
| category | string | Category key for filtering news. |
| information_id | integer | Cursor for pagination. Use bottom_id from a previous response to fetch the next page. |
{
"type": "object",
"fields": {
"count": "integer, number of items returned",
"items": "array of news article objects with id, title, short_title, type, and extra (containing summary, author, read_number, published_at, thumbnail_pic)",
"total": "integer, total available items",
"top_id": "integer, cursor for the top of the list",
"bottom_id": "integer, cursor for the next page (pass as information_id)"
},
"sample": {
"data": {
"count": 20,
"items": [
{
"id": 4804089,
"type": 1,
"extra": {
"author": "金色财经",
"summary": "代币化带来全天候交易",
"topic_id": 3733636,
"author_id": 10063,
"read_number": 100331,
"published_at": 1780032465,
"thumbnail_pic": "https://img.jinse2.com/jinse_1780032451415706936_small.png"
},
"title": "纽交所母公司创始人最新发声",
"short_title": "ICE创始人"
}
],
"total": 20,
"top_id": 4804089,
"bottom_id": 4783674
},
"status": "success"
}
}About the Jinse API
News Articles and Categories
The get_news_list endpoint returns paginated articles filtered by category. Categories are fetched separately via get_categories, which returns each category's key (used as the category input) and its Chinese name. Pagination uses top_id and bottom_id cursor fields returned in each response — pass bottom_id as the information_id parameter to advance through older articles. Supported category keys include values like industry, 独家, 比特币L2, and Meme.
Flash News and Article Detail
get_flash_news_list delivers the 7×24 breaking news feed. Each response groups items by date, with a lives array of flash items per date object. Pass the id of the last item in a response as last_id to load the next page. To retrieve full article content from any article ID surfaced by get_news_list, get_hot_news, or search_news, call get_news_detail with that article_id. The response includes the article title, the extracted body as content (HTML), and the complete page html.
Search and Trending
search_news accepts a keyword (e.g. Bitcoin or 以太坊) and returns a structured data object with fields covering project info, topic results, new_flashes, features, matched authors, and related keywords. get_hot_news requires no inputs and returns an array of up to 10 articles, each carrying id, title, read_number, covers, published_at, and author metadata.
The Jinse API is a managed, monitored endpoint for jinse.cn — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when jinse.cn 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 jinse.cn 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?+
- Aggregate real-time Chinese-language crypto flash news into an English-language dashboard using
get_flash_news_list - Track the 24-hour top stories on Jinse by polling
get_hot_newsand sorting byread_number - Build a keyword alert system for terms like '以太坊' or 'Bitcoin' using
search_newsand monitoringnew_flashesin the response - Populate a category-filtered news feed app using
get_categorieskeys withget_news_listand cursor-based pagination - Extract full article HTML and body content for NLP or translation pipelines via
get_news_detail - Surface related authors and projects for a given search term using the
authorsandprojectfields fromsearch_news
| 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 Jinse Finance have an official developer API?+
How does pagination work in `get_news_list` and `get_flash_news_list`?+
get_news_list returns top_id and bottom_id cursor values in each response. Pass bottom_id as the information_id parameter on your next request to fetch the next page of older articles. get_flash_news_list uses a simpler cursor: pass the id of the last flash item in a response as last_id to continue paginating.Does `search_news` support filtering results by date range or category?+
search_news accepts only a keyword string and returns a fixed set of result types: project info, topics, recent flash news, featured content, authors, and related keywords. Date filtering and category scoping are not exposed. You can fork this API on Parse and revise it to add a filtered search endpoint if you need those parameters.