# Jin10 — 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 real-time financial flash news, economic calendar events, macroeconomic indicators, and article content from jin10.com. Supports search, pagination, and category filtering across all major data types.

**Category:** Finance & Markets | **Website:** [jin10.com/](https://jin10.com/) | **Docs:** [parse.bot/marketplace/9a2350e6-30be-4b96-a597-6b30a3010e80/jin10-com-api](https://parse.bot/marketplace/9a2350e6-30be-4b96-a597-6b30a3010e80/jin10-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-jin10-com-api-9a2350e6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_article_detail

Fetch the full content of a specific news article by its numeric ID. Returns article title, HTML content body, author information, publication datetime, introduction summary, view count, and metadata. Article IDs are obtainable from get_hot_articles or search_news results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `article_id` | string | Yes | Numeric article ID (e.g. '219247'). Obtainable from get_hot_articles or search_news results. |

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

### get_economic_calendar

Fetch economic calendar data for a given date. Returns scheduled and released economic indicators including country, indicator name, previous/consensus/actual values, importance rating (star), and publication times. Defaults to today's date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category filter for calendar data. Default 'cj' returns the financial calendar. |
| `date` | string | No | Date in YYYY-MM-DD format. Defaults to today's date if omitted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jin10-com-api-9a2350e6/get_economic_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","date":"<string>"}'
```

### get_economic_indicators

Fetch macroeconomic indicator categories and their latest data. Returns a hierarchical list of indicator categories (e.g. by country) with nested items containing latest values, chart data, and publication schedules. Default category_id 52001 returns the national macro overview.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | integer | No | Category ID for indicators. Default 52001 returns the national macro category tree. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jin10-com-api-9a2350e6/get_economic_indicators \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<integer>"}'
```

### get_flash_news

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `classify` | string | No | Category filter ID for flash news. Known values include '6' for oil-related news. |
| `max_id` | string | No | Maximum flash news ID for pagination. Returns items published before this ID. Obtain from a previous response's last item ID. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jin10-com-api-9a2350e6/get_flash_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"classify":"<string>","max_id":"<string>"}'
```

### get_hot_articles

Fetch the current list of trending/hot articles from jin10.com. Returns an array of article summaries including titles, thumbnails, publication datetimes, categories, and detail URLs. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jin10-com-api-9a2350e6/get_hot_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_news

Search across jin10.com for news, flash news, market instruments, and mini-programs matching a keyword. Returns categorized results in headers (flash, market, mp sections) each with their own list and total count. Supports pagination via offset.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offset` | integer | No | Pagination offset for results. |
| `query` | string | Yes | Search keyword (Chinese or English). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jin10-com-api-9a2350e6/search_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offset":"<integer>","query":"<string>"}'
```