HK HKMA financial series

hk_hkma_query

TW-specificMIT

Scope: Hong Kong public datasets and government data.

Query HKMA (Hong Kong Monetary Authority) Open API · financial series.



Known endpoint IDs:
- `daily-interbank-liquidity` · daily HIBOR + HKMA base rate + aggregate
  balance + TWI + CU triggers
- `foreign-currency-reserves` · monthly (MSB 8.4)
- `hibor-daily` · full historical HIBOR (overnight / 1w / 1m / 3m / 6m / 12m)
- `authorized-institutions` · register of banks / DTCs / LROs
- `press-releases` · HKMA press archive

HKMA hard-caps `pagesize` at 100 · returns empty body on higher values.

Args:
    endpoint_id: registry key (see list above)
    category: filter for the endpoint list only
    pagesize: 1..100 (default 20)
    offset: pagination offset
    lang: "en" | "tc" | "sc"
    date_from / date_to: YYYY-MM-DD daily · YYYY-MM monthly

Returns HKMA envelope `{"header": {...}, "result": {"records": [...]}}`
(or `{"endpoints": [...]}` when endpoint_id omitted).

Input schema

{
  "properties": {
    "endpoint_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Endpoint Id"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "pagesize": {
      "default": 20,
      "title": "Pagesize",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    },
    "lang": {
      "default": "en",
      "title": "Lang",
      "type": "string"
    },
    "date_from": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Date From"
    },
    "date_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Date To"
    }
  },
  "title": "hk_hkma_queryArguments",
  "type": "object"
}

How to call

Once your Twinkle Hub MCP client is configured, your agent will see hk_hkma_query. Just ask it to call — example:

# Ask Claude / any MCP client:
請用 hk_hkma_query 處理 "…"。

# It will call:
hk_hkma_query(input="…")

Haven't set up a client yet?

Claude Desktop in 3 minutes — download the .mcpb and double-click, or see docs for other clients.

See user docs