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 reader as open source: github.com/xrayme1337/kofiu-vasp-register.
Why the file fights back
Three things make the file hard to read:
- The download works only inside the session that listed the notice. The file id is minted per request and tied to a cookie, so the reader lists the board, keeps the cookies and downloads in the same session.
- The header is not fixed. Some months it is one row, some months two, with group cells such as a renewal heading above its date. The reader maps a column only by its whole label and fails loudly on a label it does not know, instead of guessing.
- The file carries personal data next to company data: the representative's name and the office address. The reader never reads those columns, and masks phone numbers and e-mail addresses in anything it logs.
What it returns
What it returns per provider: the service and legal name, the business registration number (with its check digit verified), the businesses it may run (buying and selling, exchange, transfer, custody, brokerage), and the dates of acceptance, renewal and any cancellation.
A provider that leaves the file is reported as having left it, never as revoked: the file does not say why.
The data is public under Korea's Public Data Act; credit KoFIU (kofiu.go.kr) where you show it. If you would rather not run a scraper, X-RAY serves the whole register, with each provider tied to its company, to AI agents over MCP: x-ray.me/registers/korea-vasps.
Comments
No comments yet. Start the discussion.