# Jinse — 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 Jinse Finance's latest cryptocurrency and blockchain news, including flash news alerts, detailed articles, and trending stories across multiple categories. Search through news content, explore hot topics, and stay updated with real-time financial news from the Jinse Finance platform.

**Category:** Web3 & Onchain | **Website:** [jinse.cn/](https://jinse.cn/) | **Docs:** [parse.bot/marketplace/07755345-a3a0-4d6e-ac5d-6271e644d23b/jinse-cn-api](https://parse.bot/marketplace/07755345-a3a0-4d6e-ac5d-6271e644d23b/jinse-cn-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-jinse-cn-api-07755345/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_categories

Retrieve the list of available news categories. Each category has a display name and a key that can be used with the get_news_list endpoint's category parameter to filter articles by topic.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jinse-cn-api-07755345/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_flash_news_list

Retrieve the 7×24 flash/breaking news feed. Returns flash news items flattened from date groups with pagination support via the last item's id. Each item includes content text, importance grade (1-4), up/down vote counts, creation timestamp, and optional link.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | integer | No | Flash news category filter. 0 returns all categories. |
| `last_id` | integer | No | Cursor for pagination. Use the id of the last flash news item from a previous response to fetch the next page. |
| `limit` | integer | No | Number of flash news items to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jinse-cn-api-07755345/get_flash_news_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<integer>","last_id":"<integer>","limit":"<integer>"}'
```

### get_hot_news

Retrieve the top 10 hot articles from the past 24 hours, ranked by read count. Each article includes id, title, read_number, cover image URL, published_at timestamp, author info, and jump_url for the full article.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jinse-cn-api-07755345/get_hot_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_news_detail

Retrieve the full content of a specific news article by its ID. Returns the article title, HTML content extracted from the article body, and the full page HTML. The article_id can be obtained from get_news_list items' extra.topic_id, get_hot_news items' id, or search_news results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `article_id` | string | Yes | Numeric article ID obtained from get_news_list (extra.topic_id), get_hot_news, or search_news results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jinse-cn-api-07755345/get_news_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"article_id":"<string>"}'
```

### get_news_list

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category key for filtering news. |
| `information_id` | integer | No | Cursor for pagination. Use bottom_id from a previous response to fetch the next page. |
| `limit` | integer | No | Number of items to return per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jinse-cn-api-07755345/get_news_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","information_id":"<integer>","limit":"<integer>"}'
```

### search_news

Search news articles, projects, authors, and flash news by keyword. Returns rich search results including project information with description and featured posts, related topic articles, recent flash news mentions, featured content sections, and author matches. Results are comprehensive but not paginated.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | Yes | Search keyword (e.g. 'Bitcoin', '以太坊'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jinse-cn-api-07755345/search_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>"}'
```