Skip to content

Thai company figures

View as Markdown
GET /v1/th/companies/{id}
GET /v1/th/companies/{id}/financials?field=net_income

Company-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"

{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.

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).

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.

  • duration is 3M for a discrete quarter, 12M for a full year and instant for 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.
  • value is 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_status is reviewed, audited or unknown, as the company’s own file says.
  • For companies whose year does not end in December, fiscal_year follows the company’s own labelling, and period_end is always the real date.

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.

  • 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/status shows how old the Thai load is, as th_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.

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.