How we read Korea's crypto licence register, and why the file fights back
In Korea a crypto business may serve customers only on a report that the Korea Financial Intelligence Unit (KoFIU) has accepted, renewed every three years. KoFIU publishes the list of those businesses, but not as an API: it is an Excel file attached to a notice on its board, and the link to that file changes on every page load. We read it every day for X-RAY , and today we are publishing the…
In Korea, crypto businesses must adhere to the guidelines set by the Korea Financial Intelligence Unit (KoFIU). KoFIU issues an Excel file containing the list of these businesses, which is not available as an API. The file is attached to a notice on KoFIU's board and the link to the file changes with each page load. To access this data, X-RAY, an open-source tool, reads the file daily.
Three factors contribute to the complexity of reading the file. Firstly, the download functionality is only accessible within the session that listed the notice. Secondly, the file's ID is generated per request and linked to a cookie, requiring the reader to maintain the same session to successfully download the data. Thirdly, the header of the file is not static, varying between one row and two rows, sometimes including group cells such as a renewal heading with its corresponding date.
The reader is designed to map columns based on their entire labels, and if an unknown label is encountered, it will result in an error rather than attempting to guess the column's purpose. Additionally, the file includes sensitive personal data alongside company information, such as the representative's name and office address. To protect privacy, the reader avoids reading these columns and masks phone numbers and e-mail addresses whenever they are logged.
It provides information on each provider, including the service and legal name, business registration number (with its check digit verified), the specific services the business is allowed to perform (such as buying, selling, exchange, transfer, custody, and brokerage), and the dates when the business was accepted, renewed, and any cancellations.
Businesses that remove themselves from the file are reported as having withdrawn their services, rather than being labeled as revoked. The reason for their withdrawal is not specified in the file. The data is publicly available under Korea's Public Data Act, and KoFIU is credited when displaying the information. If scraping the file is not preferred, X-RAY offers the entire register, with each provider linked to its respective company, accessible over MCP to AI agents at x-ray.me/registers/korea-vasps.
Written by urgent.news from Dev.to's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.