Skip to content
Centralising Automated Teller Machine (ATM) Data in Hong Kong in a well-defined yet standardised format and display in a web portal for public use
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
archive moved data & scrapers to archive May 4, 2019
scrapers Create May 13, 2019
scripts commit files individually May 20, 2019
swagger added May 3, 2019
transformer unlink md5Path if checksum is same May 20, 2019
web Merge branch 'master' of May 20, 2019
.gitignore Update .gitignore May 11, 2019
.travis.yml Revised Roadmap May 19, 2019

Hong Kong Automated Teller Machine (ATM) Locator

Project Synopsis

There are three ATM networks in Hong Kong, which are HSBC, Hang Seng Bank and JETCO respectively. ATM data will be retrieved via API Portal from HSBC, Hang Seng Bank and APIX. However, the interoperability is frustrating as the API is implemented at different standard levels. Hence, this project aims to centralise Hong Kong ATM data in a well-defined yet standardised format and display in a web portal for public use.

Hong Kong Monetary Authority (HKMA) has published Open API Framework for the Hong Kong Banking Sector, mentioning that no standardised open API functions will be provided at the first release.

Paragraph #20

Throughout the discussion and consultation period, the HKMA recognises the industry’s desire to see a common set of Open APIs for better interoperability. However, a number of international banks operating in Hong Kong have already implemented their group standard for implementing Open APIs at global or regional levels, and have demonstrated elsewhere that requiring banks to adhere to a prescribed set of standardised Open API functions is challenging.

Paragraph #21

Some opinions from the technology sector also indicate that it would be more desirable for banks to quickly offer Open APIs than to wait for standardised Open APIs that would take time to emerge. Furthermore, it is believed that once an ecosystem has been developed and becomes mature, convergence to standardised Open APIs will likely occur in response to the needs of the market.

Project Roadmap

Phase I

  • Retrieving ATM data from HSBC and Hang Seng Banks from API Portals
  • Retrieving ATM data from APIX
    • Bank of China (Hong Kong) Limited
    • Bank of Communications (Hong Kong) Limited
    • Bank of Communications Co., Ltd.
    • China CITIC Bank International Limited
    • China Construction Bank (Asia) Corporation Limited
    • China Merchants Bank Hong Kong Branch
    • Chiyu Banking Corporation Limited
    • Chong Hing Bank Limited
    • Citibank (Hong Kong) Limited
    • CMB Wing Lung Bank Limited
    • Dah Sing Bank, Limited
    • DBS Bank (Hong Kong) Limited
    • Fubon Bank (Hong Kong) Limited
    • Industrial and Commercial Bank of China (Asia) Limited
    • Nanyang Commercial Bank Limited
    • OCBC Wing Hang Bank Limited
    • Public Bank (Hong Kong) Limited
    • Shanghai Commercial Bank Limited
    • Standard Chartered Bank (Hong Kong) Limited
    • The Bank of East Asia, Limited

Phase II

  • Data Transformation & Enrichment
  • Web Portal Development


We are looking for technical & non-technical contributors:

Technical Contributors:

  • Responsible for implementing features and fixing reported bugs
  • Preferably with experience with knowledge in Open API and Web Development

Non-technical Contributors:

  • Responsible for updating documentation
  • Good command of written in English and Chinese

UI/UX Contributors:

  • Responsible for refining UI/UX
  • Knowledge of UI/UX principles and techniques

If you are interested, please join the telegram group for further discussion.


HK ATM Locator:




Licensed Banks Incorporated in Hong Kong

Clearing Code Bank Name Chinese Name
003 Standard Chartered Hong Kong 渣打銀行(香港)有限公司
004 Hongkong and Shanghai Banking Corporation 香港上海滙豐銀行有限公司
009 China Construction Bank (Asia) 中國建設銀行(亞洲)股份有限公司
012 Bank of China (Hong Kong) 中國銀行(香港)有限公司
015 The Bank of East Asia, Limited 東亞銀行有限公司
016 DBS Bank (Hong Kong) 星展銀行(香港)有限公司
018 China CITIC Bank International 中信銀行國際有限公司
020 Wing Lung Bank 永隆銀行有限公司
024 Hang Seng Bank 恒生銀行有限公司
025 Shanghai Commercial Bank 上海商業銀行有限公司
027 Bank of Communications (Hong Kong) 交通銀行(香港)有限公司
028 Public Bank (Hong Kong) 大眾銀行(香港)有限公司
035 OCBC Wing Hang Bank 華僑永亨銀行有限公司
038 Tai Yau Bank 大有銀行有限公司
039 Chiyu Banking Corporation 集友銀行有限公司
040 Dah Sing Bank 大新銀行有限公司
041 Chong Hing Bank 創興銀行有限公司
043 Nanyang Commercial Bank 南洋商業銀行有限公司
061 Tai Sang Bank Limited 大生銀行有限公司
072 Industrial and Commercial Bank of China (Asia) 中國工商銀行(亞洲)有限公司
128 Fubon Bank (Hong Kong) 富邦銀行(香港)有限公司
250 Citibank (Hong Kong) 花旗銀行(香港)有限公司
You can’t perform that action at this time.