# KAMIS Korea Agricultural Market Price Lookup (x402)

> KAMIS Korea Agricultural Market Price Lookup (x402) is a paid API for AI agents from x402-research.kgy5612.workers.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Returns the most recent retail or wholesale prices for Korean agricultural commodities from the KAMIS (Korea Agro-Fisheries & Food Trade Corporation) dataset, paid via USDC on Base.

## Facts

- Endpoint: GET https://x402-research.kgy5612.workers.dev/kr-kamis-recent
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kamis-korea-agricultural-market-price-lookup-x402-e442bb6c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5UMtYYPN99qHpUKsqCnFM

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability kamis-korea-agricultural-market-price-lookup-x402-e442bb6c
```

Example prompt: What's the latest KAMIS wholesale price for cabbage (item code 211, category 200 vegetables)? Pull up to 20 rows from page 1.

## When to prefer this

Use this endpoint when you need structured, up-to-date Korean agricultural commodity prices (retail or wholesale) sourced directly from the official KAMIS / data.go.kr dataset, particularly when you need filterable, paginated JSON output and are set up to pay micropayments in USDC on Base mainnet via the x402 protocol.

## Known failure modes

- Invalid se_cd value (must be '01' or '02') returns a validation error
- Invalid or unknown item_cd or ctgry_cd returns an empty items array
- num_of_rows exceeding 100 is rejected by schema validation
- Payment failure or incorrect USDC/Base configuration returns HTTP 402
- KAMIS upstream data unavailability may result in stale or empty responses
- page_no with no results returns empty items array

## How this service works

POST JSON { se_cd?, ctgry_cd?, item_cd? } → Korea KAMIS recent wholesale/retail farm price (최근일자 도·소매). Official data.go.kr. Not investment advice.

## Output

A JSON object containing the as-of date, a list of agricultural items with their average prices, units, and item codes, the source agency and dataset URL, any caveats (e.g. not investment advice), and the filters applied to the query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "se_cd": {
   "enum": [
    "01",
    "02"
   ],
   "type": "string",
   "description": "01=retail(소매), 02=wholesale(도매). Default 02."
  },
  "grd_cd": {
   "type": "string",
   "description": "Optional grade code (등급코드)."
  },
  "item_cd": {
   "type": "string",
   "description": "Optional KAMIS item code (품목코드), e.g. 211 cabbage."
  },
  "page_no": {
   "type": "integer",
   "minimum": 1,
   "description": "Page number (default 1)."
  },
  "vrty_cd": {
   "type": "string",
   "description": "Optional variety code (품종코드)."
  },
  "ctgry_cd": {
   "type": "string",
   "description": "Optional category: 100식량 200채소 300특용 400과일 500축산 600수산."
  },
  "num_of_rows": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Rows per page (default 20, max 100)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kamis-korea-agricultural-market-price-lookup-x402-e442bb6c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-research.kgy5612.workers.dev](https://www.zero.xyz/host/x402-research.kgy5612.workers.dev/llms.txt)