Search
K
Fundamentals Layer API (Production)

Fundamentals Layer API

v1.1OAS 3.0

Company fundamentals for Saudi and GCC listed companies: reported financial statements and history, financial ratios, key highlights, analyst estimates and opinions, and market-level financial results.

API Base URL
  • Server 1:https://api.argaam.com

    Argaam API Gateway (Production)

Security
ApiKeyAuth (apiKey)

An API key is a token that you provide when making API calls. Include the token in a header parameter called apikey.

Example: apikey: 123

ApiKeyAuthQuery (apiKey)

An API key is a token that you provide when making API calls. Include the token in a query parameter called apikey.

Example: ?apikey=123

Additional Information
Contact Argaam IT (developer@argaam.com)

Get the latest financial statements for a company

Returns the most recent reported income statement, balance sheet and cash-flow line items for the company. Use fiscalPeriod and year to pin a specific reporting period.

get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/financials

Query Parameters

marketIdinteger(int32)

Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values. Defaults to 3.

Default:3

Example:3

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default:year

Example:year

Path Parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example:2222

Response

200 application/json

Success

ApiV1Response

* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/financials
 
200 application/json

Get historical financial statements for a company

Returns the reported financial statement history for the company across fiscal periods. Use fromYear/toYear or numberOfYear to bound the range.

get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/financials/history

Query Parameters

yearinteger(int32)

Calendar year to filter by, e.g. 2025.

Example:2023

marketIdinteger(int32)

Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values. Defaults to 3.

Default:3

Example:3

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default:year

Example:year

fiscalPeriodstring

Fiscal period within the year: 1-4 for quarters, 5 for the full year.

Default:

Example:year

Path Parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example:2222

Response

200 application/json

Success

ApiV1Response

* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/financials/history
 
200 application/json