Api Endpoint

1gateway

Use when you need official Bank of Korea statistics (base rate, money supply, key indicators) as a time series. Input: stat (ECOS table code, e.g. 722Y001), cycle (A/S/Q/M/SM/D), start, end (period format of cycle), optional item (e.g. 0101000). Output: JSON series with English labels, units, observations [{period,value}] (max 1,000 rows) and source attribution. Only BOK-authored tables are served. Example: ?stat=722Y001&cycle=M&start=202401&end=202412&item=0101000

Open interactive test console

Offering

Provider
1gateway.dev
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Financial Analysis
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://1gateway.dev/v1/macro/ecos
MIME type
application/json
First seen
2026-10-16T01:50:32.458Z
Last seen
Tags
korea, bank-of-korea, macroeconomics, interest-rates, time-series

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.0045 USDC
Atomic price: 4500 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.0045 USDC
Atomic price: 4500 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "4500",
    "payTo": "0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "4500",
    "payTo": "AwV6UZobYPyTdsuNa2NknZZrnmmUoH5ckEv3wNgL26WT"
  }
]

Observed health

Status
Healthy
Latest latency
60 ms
Average latency
427 ms
HTTP status
402
Last checked
Reachability
100% over 13 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "stat": {
          "type": "string",
          "description": "ECOS statistic table code, e.g. 722Y001 (base rate). Non-BOK tables → 403 (not charged).",
          "pattern": "^[0-9A-Z]{7}$",
          "examples": [
            "722Y001"
          ]
        },
        "cycle": {
          "type": "string",
          "description": "A annual, S semi-annual, Q quarterly, M monthly, SM semi-monthly, D daily",
          "enum": [
            "A",
            "S",
            "Q",
            "M",
            "SM",
            "D"
          ],
          "examples": [
            "M"
          ]
        },
        "start": {
          "type": "string",
          "description": "Start period in ECOS format (A: YYYY, Q: YYYYQn, M: YYYYMM, D: YYYYMMDD)",
          "pattern": "^[0-9A-Z]{4,8}$",
          "examples": [
            "202401"
          ]
        },
        "end": {
          "type": "string",
          "description": "End period, same format as start",
          "pattern": "^[0-9A-Z]{4,8}$",
          "examples": [
            "202412"
          ]
        },
        "item": {
          "type": "string",
          "description": "Item code 1 (e.g. 0101000). Optional item2..item4 also accepted.",
          "pattern": "^[0-9A-Za-z?]+$",
          "examples": [
            "0101000"
          ]
        }
      },
      "required": [
        "stat",
        "cycle",
        "start",
        "end"
      ],
      "additionalProperties": true
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "additionalProperties": true,
          "properties": {
            "cycle": {
              "description": "A annual, S semi-annual, Q quarterly, M monthly, SM semi-monthly, D daily",
              "enum": [
                "A",
                "S",
                "Q",
                "M",
                "SM",
                "D"
              ],
              "examples": [
                "M"
              ],
              "type": "string"
            },
            "end": {
              "description": "End period, same format as start",
              "examples": [
                "202412"
              ],
              "pattern": "^[0-9A-Z]{4,8}$",
              "type": "string"
            },
            "item": {
              "description": "Item code 1 (e.g. 0101000). Optional item2..item4 also accepted.",
              "examples": [
                "0101000"
              ],
              "pattern": "^[0-9A-Za-z?]+$",
              "type": "string"
            },
            "start": {
              "description": "Start period in ECOS format (A: YYYY, Q: YYYYQn, M: YYYYMM, D: YYYYMMDD)",
              "examples": [
                "202401"
              ],
              "pattern": "^[0-9A-Z]{4,8}$",
              "type": "string"
            },
            "stat": {
              "description": "ECOS statistic table code, e.g. 722Y001 (base rate). Non-BOK tables → 403 (not charged).",
              "examples": [
                "722Y001"
              ],
              "pattern": "^[0-9A-Z]{7}$",
              "type": "string"
            }
          },
          "required": [
            "stat",
            "cycle",
            "start",
            "end"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "attribution": {
              "type": "string"
            },
            "cache": {
              "type": "string"
            },
            "cycle": {
              "type": "string"
            },
            "cycleEn": {
              "type": "string"
            },
            "license": {
              "type": "string"
            },
            "rowLimit": {
              "type": "integer"
            },
            "series": {
              "items": {
                "properties": {
                  "items": {
                    "items": {
                      "properties": {
                        "code": {
                          "type": "string"
                        },
                        "nameEn": {
                          "type": "string"
                        },
                        "nameKo": {
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "observations": {
                    "items": {
                      "properties": {
                        "period": {
                          "type": "string"
                        },
                        "periodRaw": {
                          "type": "string"
                        },
                        "value": {
                          "type": "number"
                        }
                      },
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "unitEn": {
                    "type": "string"
                  },
                  "unitKo": {
                    "type": "string"
                  },
                  "weight": {
                    "type": "null"
                  }
                },
                "type": "object"
              },
              "type": "array"
            },
            "statCode": {
              "type": "string"
            },
            "statNameEn": {
              "type": "string"
            },
            "statNameKo": {
              "type": "string"
            },
            "totalRows": {
              "type": "integer"
            },
            "truncated": {
              "type": "boolean"
            }
          },
          "required": [
            "statCode",
            "statNameKo",
            "statNameEn",
            "cycle",
            "cycleEn",
            "series",
            "totalRows",
            "rowLimit",
            "truncated",
            "attribution",
            "license",
            "cache"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}