# Korea KAMIS Regional Farm Price Lookup

> Korea KAMIS Regional Farm Price Lookup 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-13).

Returns regional wholesale and retail farm produce prices (min/avg/max) by city from Korea's KAMIS official agricultural market information system.

## Facts

- Endpoint: GET https://x402-research.kgy5612.workers.dev/kr-kamis-region
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/korea-kamis-regional-farm-price-lookup-ac689df8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uidtvA9j7i5WJHQSRS7J7

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 korea-kamis-regional-farm-price-lookup-ac689df8
```

Example prompt: Can you pull the official KAMIS wholesale prices for cabbage (item code 211) in Seoul (city code 1101) for the past 10 days and show me the min, average, and max?

## When to prefer this

Use this endpoint when you need official Korean agricultural commodity prices broken down by city/region, with min/avg/max granularity. Prefer this over kr-kamis-recent when you need historical ranges or city-level comparison rather than just the latest national snapshot. Best for regional price analysis, supply chain research, or agricultural market monitoring in Korea.

## Known failure modes

- Missing required sgg_cd returns an error — must supply a valid 4-digit KAMIS city code
- Invalid or unsupported item_cd or ctgry_cd may return empty results
- Date ranges with no survey data return empty result sets
- Pagination past available records returns empty pages
- Network or upstream data.go.kr API outages cause 502/503 errors
- Payment of 0.03 USDC required per call; unpaid requests return 402

## How this service works

POST JSON { sgg_cd, se_cd?, item_cd? } → Korea KAMIS regional farm price (지역별 품목별 도·소매) with city min/avg/max. Official data.go.kr. Not investment advice.

## Output

Returns a paginated JSON list of regional farm price records for the specified city, each containing the product name, market type (retail/wholesale), survey date, and city-level min/average/max prices in Korean won, sourced from Korea's official KAMIS agricultural data system.

## 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 (등급코드)."
  },
  "sgg_cd": {
   "type": "string",
   "description": "Required. 4-digit KAMIS city code (e.g. 1101 Seoul, 2100 Busan, 2200 Daegu, 2401 Gwangju, 2501 Daejeon)."
  },
  "to_ymd": {
   "type": "string",
   "description": "Optional range end YYYYMMDD (default today KST)."
  },
  "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수산."
  },
  "exmn_ymd": {
   "type": "string",
   "description": "Optional single survey date YYYYMMDD. Overrides from_ymd/to_ymd. Omit to default last 10 KST days."
  },
  "from_ymd": {
   "type": "string",
   "description": "Optional range start YYYYMMDD (default last 10 KST days)."
  },
  "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/korea-kamis-regional-farm-price-lookup-ac689df8/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)
