Thai company figures
GET /v1/th/companies/{id}GET /v1/th/companies/{id}/financials?field=net_incomeCompany-published financial statements read by Belfort Research from each company’s own investor-relations website. Not from SET or the SEC. Every figure links to the company’s file.
This is a small first release. It is separate from the SEC data on the rest of this site, and it follows its own rules.
curl -H "X-API-Key: $BELFORT_API_KEY" \ "https://api.belfortagent.xyz/v1/th/companies/SPI/financials?field=net_income&period=quarterly"Which company
Section titled “Which company”{id} is a SET symbol in any case, such as GULF, or a thirteen-digit company registration number. A US ticker or a CIK is not a Thai company id, and an unknown id is a 404 that costs nothing.
Company
Section titled “Company”GET /v1/th/companies/{id} returns the name, the website, the page the statements are read from, the investor-relations platform that page runs on, the figures served for the company (fields), and the earliest and latest period end on file (periods).
Figures
Section titled “Figures”GET /v1/th/companies/{id}/financials returns one figure per call, newest period first.
| Parameter | Values | Default |
|---|---|---|
field |
basic_eps, diluted_eps, net_income or cash_and_equivalents. Required. |
|
period |
quarterly (Q1 to Q3), annual (the full year) or all. |
all |
limit |
Points per page, one to one hundred. | forty |
cursor |
The previous page’s meta.next_cursor, with the same filters. |
| Field | Meaning | Unit |
|---|---|---|
basic_eps |
Basic earnings per share, as printed. | baht per share |
diluted_eps |
Diluted earnings per share. Served only where the statement prints a diluted line; most Thai companies print basic EPS only. | baht per share |
net_income |
Profit attributable to the owners of the parent, not the whole group. | baht |
cash_and_equivalents |
Cash and cash equivalents on the period end. | baht |
Each point has fiscal_year, period (Q1, Q2, Q3 or FY), period_end, duration, value, audit_status and source.
durationis3Mfor a discrete quarter,12Mfor a full year andinstantfor a balance on the period end. A year-to-date figure is never served as a quarter. When a quarter can’t be told apart from a year-to-date figure, it is left out.valueis exact decimal text in baht, already multiplied by the scale the company declared in its file. It is text so that no digit is rounded.audit_statusisreviewed,auditedorunknown, as the company’s own file says.- For companies whose year does not end in December,
fiscal_yearfollows the company’s own labelling, andperiod_endis always the real date.
Where each figure comes from
Section titled “Where each figure comes from”source names the company’s own file, the page that lists it, the company that published it, the day it was posted when the page shows it, when we retrieved it, a hash of the file as retrieved, and where in the file the figure sits (the sheet, the row and the line’s label). Open source.file_url to check any figure against what the company published.
Known limits
Section titled “Known limits”- A small set of companies. 24 Thai listed companies in this first release. A company whose site asks crawlers not to read its files is not here, and we do not work around that.
- Four figures, group level, and the newest quarters. Only consolidated (group) figures are served; a figure that cannot be proven to be the group’s is left out. How much history there is differs by company.
- Spreadsheet figures are served at the precision the cell shows. If that precision cannot be established the figure is left out.
- Loaded by hand. There is no schedule yet.
GET /v1/statusshows how old the Thai load is, asth_financials. - A figure we can’t read with confidence is left out, not guessed. A missing quarter means we could not read it safely, not that the company did not report it.
- No restatement history. A later file for the same period replaces the earlier one.
Taking a company out
Section titled “Taking a company out”The files are read by a named crawler. How it behaves, and how a company asks for removal, is on the crawler page.
A call that returns at least one record costs the same as the matching SEC figure call. An error, an unknown company or an empty result is free. See Pricing.