{
  "serviceId": "kr-export-pulse-v1",
  "displayName": "KR Export Pulse",
  "description": "South Korea's export statistics from Korea Customs Service: 10-day provisional totals for semiconductors, cars and 8 other major items, changes versus the prior month and year with item contributions, monthly trade by HS code and country, and a revision log. GET /v1/pulse, /v1/tenday, /v1/hs?hs=, or POST /v1/query in Korean or English. Pay per request in USDC; no API key.",
  "category": "finance",
  "resourceUrl": "https://agent.pocket.network/v1/kr-export-pulse-v1",
  "priceUsd": "0.005000",
  "priceVersion": 1,
  "rails": [
    {
      "id": "base",
      "network": "eip155:8453",
      "chainId": 8453,
      "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "tokenDecimals": 6,
      "payToAddress": "0xF732ea490c5766071785a2310523f7fA2CEbB829"
    }
  ],
  "paymentNetworks": [
    "eip155:8453",
    "eip155:4217"
  ],
  "paymentProtocols": [
    "x402",
    "mpp"
  ],
  "protocols": [
    "rest"
  ],
  "inputSchema": {
    "type": "object",
    "description": "The body of POST /v1/query. The GET routes take the same fields as query parameters: /v1/pulse takes months (default 3); /v1/tenday takes from and to (YYYYMM); /v1/hs takes hs (required) with optional from, to and country (ISO-2); /v1/revisions takes an optional period; /v1/items takes none.",
    "properties": {
      "question": {
        "type": "string",
        "description": "A question in Korean or English, e.g. how semiconductor exports changed versus last month."
      },
      "hs": {
        "type": "string",
        "description": "HS code or prefix, e.g. 8542 (integrated circuits)."
      },
      "from": {
        "type": "string",
        "description": "YYYYMM start month."
      },
      "to": {
        "type": "string",
        "description": "YYYYMM end month."
      },
      "country": {
        "type": "string",
        "description": "ISO-2 partner country, e.g. US."
      },
      "months": {
        "type": "integer",
        "description": "How many months of history to compare (default 3)."
      }
    }
  },
  "outputSchema": {
    "type": "object",
    "description": "A JSON object tagged with its own `schema` (kr-export-pulse/v1, kr-export-tenday/v1, kr-export-hs/v1, kr-export-revisions/v1, kr-export-items/v1, kr-export-answer/v1). Values are USD thousand for the 10-day series and USD and kg for HS trade; provisional values are labelled."
  },
  "methods": {
    "GET /v1/health": "read",
    "GET /v1/hs": "read",
    "GET /v1/items": "read",
    "GET /v1/pulse": "read",
    "GET /v1/revisions": "read",
    "GET /v1/tenday": "read",
    "GET /v1/version": "read",
    "POST /v1/query": "read"
  },
  "example": {
    "method": "POST",
    "path": "/v1/query",
    "request": {
      "question": "반도체 수출 지난달 대비 얼마나 변했어?"
    },
    "response": {
      "portal": {
        "provenance": "third-party-supplier",
        "serviceId": "kr-export-pulse-v1",
        "schemaCheck": "unchecked"
      },
      "data": {
        "schema": "kr-export-answer/v1",
        "service": "kr-export-pulse-v1",
        "intent": "PULSE",
        "question": "반도체 수출 지난달 대비 얼마나 변했어?",
        "status": "OK",
        "data": {
          "schema": "kr-export-pulse/v1",
          "service": "kr-export-pulse-v1",
          "fetched_at_utc": "2026-09-29T01:37:45+00:00",
          "unit": "USD thousand",
          "latest": {
            "period": "202609",
            "days": "01~20",
            "stage": "d1_20",
            "provisional": true,
            "cumulative": {
              "total": 71409349,
              "semiconductors": 34128119,
              "steel_products": 2712227,
              "passenger_cars": 3734779,
              "petroleum_products": 4012147,
              "wireless_comm_devices": 1245445,
              "ships": 2446453,
              "auto_parts": 1133439,
              "computer_peripherals": 2330034,
              "precision_instruments": 640533,
              "home_appliances": 377984
            }
          },
          "comparisons": {
            "vs_prior_month_same_stage": {
              "reference_period": "202608",
              "reference_days": "01~20",
              "total_change": 16190089,
              "total_change_pct": 29.32,
              "contributions": [
                "…",
                "…",
                "…"
              ]
            },
            "vs_prior_year_same_stage": {
              "reference_period": "202509",
              "reference_days": "01~20",
              "total_change": 31359349,
              "total_change_pct": 78.3,
              "contributions": [
                "…",
                "…",
                "…"
              ]
            }
          },
          "rules": [
            "same stage compared (1-10 vs 1-10, month vs month)",
            "current month is provisional; prior-year value may itself have been revised",
            "contribution = item change / total change (sign-aware); items are a subset so shares do not sum to 100"
          ],
          "revisions_observed_this_fetch": [],
          "source": "https://apis.data.go.kr/1220000/prlstMmUtPrviExpAcrs/"
        }
      }
    },
    "capturedAt": "2026-09-29T01:37:46.019Z"
  },
  "firstParty": true,
  "networks": [
    "eip155:8453",
    "eip155:4217"
  ],
  "serving": true,
  "page": "https://agent.pocket.network/services/kr-export-pulse-v1",
  "descriptor": "https://agent.pocket.network/services/kr-export-pulse-v1/descriptor.json"
}