# Kita — 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 Korean trade statistics, economic indicators, and market news from KITA to monitor trade volumes by product and country, track economic trends, and stay updated on the latest trade notices and announcements. Get comprehensive trade summaries and check data update status to ensure you're working with the most current information.

**Category:** Finance & Markets | **Website:** [kita.net/](https://kita.net/) | **Docs:** [parse.bot/marketplace/ba2f26ab-8cfb-42a7-a9ef-20e5b3181901/kita-net-api](https://parse.bot/marketplace/ba2f26ab-8cfb-42a7-a9ef-20e5b3181901/kita-net-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-kita-net-api-ba2f26ab/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_kita_news_list

Get current trade policy and business news from KITA. Returns paginated list of news articles with title, ID, and date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page_index` | integer | No | Page index for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kita-net-api-ba2f26ab/get_kita_news_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_index":"<integer>"}'
```

### get_kita_notice_list

Get official announcements and notices list from KITA. Returns paginated list of notices with category, title, ID, and date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page_index` | integer | No | Page index for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kita-net-api-ba2f26ab/get_kita_notice_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_index":"<integer>"}'
```

### get_stat_update_status

Get the update status of various trade statistics datasets. Returns a list of dataset entries showing their latest data period, update date, and frequency type.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kita-net-api-ba2f26ab/get_stat_update_status \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_total_trade_summary

Get Korea's total import/export trade summary by year. Returns annual data including export/import amounts (in thousands USD), growth rates, and trade balance. Results are sorted by year descending, paginated at 20 per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page_num` | integer | No | Page number for pagination (20 results per page). |
| `year` | string | No | Year (YYYY format) up to which data is returned. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kita-net-api-ba2f26ab/get_total_trade_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_num":"<integer>","year":"<string>"}'
```

### get_trade_by_country

Get trade statistics by trading partner country. Returns aggregated export/import data comparing previous year and current year for each country. Results sorted by current-year export amount descending, paginated at 20 per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month` | string | No | Month (MM format, 01-12). |
| `page_num` | integer | No | Page number for pagination (20 results per page). |
| `year` | string | No | Year (YYYY format). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kita-net-api-ba2f26ab/get_trade_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"month":"<string>","page_num":"<integer>","year":"<string>"}'
```

### get_trade_by_product

Get trade statistics broken down by product (HSK code). Returns detailed cumulative and current-month data for product categories. Results are sorted by current-month export amount descending, paginated at 20 per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `hsk_digit` | string | No | HSK classification level: '2', '4', or '6'. |
| `month` | string | No | Month (MM format, 01-12). |
| `page_num` | integer | No | Page number for pagination (20 results per page). |
| `year` | string | No | Year (YYYY format). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kita-net-api-ba2f26ab/get_trade_by_product \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hsk_digit":"<string>","month":"<string>","page_num":"<integer>","year":"<string>"}'
```