# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/kita/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/kita/get-kita-news-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/kita/get-kita-notice-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/kita/get-stat-update-status \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/kita/get-total-trade-summary \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/kita/get-trade-by-country \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/kita/get-trade-by-product \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"hsk_digit":"<string>","month":"<string>","page_num":"<integer>","year":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.